# 日志上报
用于上报并记录用户在游戏内的操作行为,方便快速定位问题的根源、追踪程序执行的过程,以及数据的变化等,如:启动、登录、创角或充值等行为。
SDK及游戏客户端需按照《VIVO小游戏日志上报埋点模板》 (opens new window)完成相应基础日志埋点,其他扩展日志根据游戏业务需要或运营需求自行定义,本文档不做要求,谢谢!
注意事项
- 事件ID格式为:6 位纯数字;
- 事件TOKEN格式为:英文双冒号 + SDK或GAME + 服务端或客户端 + 动作或事件标识;如::SDK_CLIENT_LAUNCH,表示SDK客户端上报的启动日志;
- 事件ID + 事件TOKEN组合应确保全局唯一;
- 以
::SDK_CLIENT
为前缀的事件为SDK客户端负责上报,如有疑问请联系对接人员:丁伟; - 以
::SDK_SERVER
为前缀的事件为SDK服务端负责上报,如有疑问请联对接人员:邓泳辉、陈肖军; - 以
::GAME_CLIENT
为前缀的事件为游戏客户端负责上报,如有疑问请联系游戏客户端研发相关同学。
# 接口说明
用于上报并记录用户在游戏内的操作行为,如:启动、登录、创角或充值等行为。
sdkInstance.analytics.log(params, callback?);
# 参数说明
参数说明如下表所示:
选项 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
params | object | 是 | -- | -- |
params.eventId | string | 是 | -- | 事件ID,定义规则请查看事件ID说明 |
params.subEventId | string | 否 | -- | 子事件ID |
params.logLevel | string | 否 | d | 日志级别
|
params.logContent | string | 是 | -- | 日志内容,可填写相应网络请求响应信息或程序执行错误信息等 |
params.accountId | string | 否 | -- | 账号ID(账号唯一标识) |
callback | function | 否 | -- | 数据上报完成时的回调函数 |
# 示例代码
注:示例代码中的参数或选项均为演示数据,仅供参考,谢谢!
sdkInstance.analytics.log({
eventId: "430000::SDK_CLIENT_LOGIN",
subEventId: "",
logLevel: "d",
logContent: "SDK登录成功",
accountId: sdkInstance.userInfo.accountId // 有就填写,在未登录前进行日志上报时,此参数可不传
}, function(params) {
console.log(params);
});