# 日志上报

用于上报并记录用户在游戏内的操作行为,方便快速定位问题的根源、追踪程序执行的过程,以及数据的变化等,如:启动、登录、创角或充值等行为。

SDK及游戏客户端需按照《OPPO小游戏日志上报埋点模板》 (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

日志级别

  • d - 用于标记正常或成功日志
  • e - 用于标记错误或失败日志
    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);
});
Last Updated: 2024/9/11 16:18:07