数据统计

接口说明

用于上报并记录用户在游戏内的行为日志&事件（如：启动、登录、充值等行为），方便观察数据的变化、快速定位问题的根源，以及追踪程序执行的过程等。

sdkInstance.trackEvent(eventId, eventParams, callback?);

注意事项

在SDK中，默认将上报启动、登录、充值、广告播放及分享等行为到OSS数据分析平台（创角、充值行为一般由游戏或SDK服务端回传）。如果游戏需要上报其它更详细的数据至数据分析平台，请阅读数据统计接入文档。

参数说明

参数说明如下表所示：

选项	类型	必填	默认值	说明
eventId	string	是	--	事件ID
eventParams	object	是	--	事件参数
callback	function	否	--	事件上报完成的回调函数，一般无需使用

数据上报

流程统计上报

上报相关流程统计数据（行为日志），在SDK初始化完成后即可调用，可参考如下示例：

注：示例代码中的参数或选项均为演示数据，仅供参考，谢谢！

// 事件ID
const eventId = "100100::SDK_CLIENT_LAUNCH"; // 表示SDK客户端上报的启动事件

// 事件参数
const eventParams = {};

// 必填参数
eventParams.logLevel = "d"; // 日志类型，必填；d 用于标记普通日志，e 用于标记异常日志
eventParams.logContent = "SDK启动"; // 日志内容，必填；可以是描述文本或JSON字符串等任意字符串，如程序执行错误信息或网络请求响应信息等

// 执行上报
sdkInstance.trackEvent(eventId, eventParams);

注意事项

• eventId：事件ID，由运营人员提供，格式为 六位数字::字符串，如：100100::SDK_CLIENT_LAUNCH 表示SDK客户端上报的启动事件；
• eventParams：必须包含 logLevel、logContent 字段，其中 logLevel 固定为 d 或 e。

自定义事件上报（选接）

上报其它自定义事件（除启动、登录、充值等行为以外的自定义事件，如角色升级等）；自定义事件的名称、参数无固定格式，非必接，请结合游戏业务需要或运营需求自行上报，可参考如下示例：

注：示例代码中的参数或选项均为演示数据，仅供参考，谢谢！

// 事件ID
const eventId = "custom"; // 固定为custom，无需修改

// 事件参数
const eventParams = {};

// 必传参数
eventParams.eventName = "levelUp"; // 自定义事件名称，必填；如这里的 levelUp 代表角色升级事件

// 可选参数
eventParams.eventObj = "xxxxxx"; // 事件操作对象，如果是按钮点击事件，则对应按钮ID
eventParams.eventResult = "xxxxxx"; // 事件操作结果，如果是按钮点击事件，则返回按钮点击的结果，例如跳转至另一个页面，则填写结果页ID
eventParams.eventCode = "xxxxxx"; // 事件操作原因 code 码
eventParams.statMode = "1"; // 数据统计方式：1 代表按 eventName+eventObj+eventCode 聚合后统计人数次数，2 代表按 eventName+eventObj+eventCode 取每个用户最新记录，然后统计人数次数
eventParams.extendParamJson = JSON.stringify({ kills: 0, deaths: 0, assistant: 0 }); // 扩展参数，格式为JSON字符串
eventParams.areaId = "1001"; // 游戏大区ID，若游戏无大区概念，可不填，默认值为 1，表示初始大区编号
eventParams.roleId = "123456"; // 角色ID，若游戏无角色概念，可不填，默认值同 accountId 账号ID

// 执行上报
sdkInstance.trackEvent(eventId, eventParams);

注意事项

• eventId：事件ID，固定为 custom，无需修改；
• eventParams：必须包含 eventName 字段。

特别说明

关于上文流程统计上报，本文做如下特别说明：

SDK及游戏侧需按照《QQ小游戏日志上报埋点模板》 (opens new window)完成相应基础日志埋点，其他扩展日志请根据游戏业务需要或运营需求自行定义，本文档不做要求，谢谢！

注意事项

• 事件ID格式为：6 位纯数字 + 英文双冒号 + SDK或GAME + SERVER或CLIENT + 动作或事件标识；如100100::SDK_CLIENT_LAUNCH，表示SDK客户端上报的启动事件；
• 事件ID应确保同一游戏内全局唯一；
• 包含 ::SDK_CLIENT 字符的事件由SDK客户端负责上报，如有疑问请联系对接人员：丁伟、王占伟；
• 包含 ::SDK_SERVER 字符的事件由SDK服务端负责上报，如有疑问请联对接人员：邓泳辉、陈肖军；
• 包含 ::GAME_CLIENT 字符的事件由游戏客户端负责上报，如有疑问请联系游戏客户端研发相关人员；
• 包含 ::GAME_SERVER 字符的事件由游戏服务端负责上报，如有疑问请联系游戏服务端研发相关人员。