统计模块用于自定义事件上报。
接口描述:在游戏埋点处调用,将游戏所需记录的信息上报到统计模块。
注意一:事件标签 event_label 必须是固定值 SuperSDK_ClientReport,否则上报无效!请在接入完成后与技术同事联系,验证数据正确性。
注意二:必传字段需传入相应的值,特殊类型如 int 需传入数字类型的字符串,其它未注明必传的参数传字符串即可。
接口调用:
Dictionary<String, Object> paramData = new Dictionary<String, Object>();
paramData.Add(SuperSDKStats.KEY_EVENT_ID, "Test"); // 事件 ID,需提前定义
paramData.Add(SuperSDKStats.KEY_EVENT_LABEL, "SuperSDK_ClientReport"); // 事件标签(topic),必须使用 SuperSDK_ClientReport。(注意:固定值!不可修改!)
paramData.Add(SuperSDKStats.KEY_DESC, "enterGame"); // 事件描述,可不传
paramData.Add(SuperSDKStats.KEY_STACK, ""); // 堆栈信息,一般在发生异常时使用,传入异常堆栈信息
Dictionary<String, Object> extraMap = new Dictionary<String, Object>();
try {
extraMap.Add("eventname", "clientreport"); // 当前的事件名称,当前支持 clientreport。(注意:固定值!不可修改!)
extraMap.Add("extra_event_id", ""); // 事件 ID,等同于上面的 event_id(必传)
extraMap.Add("channel_id", ""); // CPS 分包 ID,手游需填
extraMap.Add("client_ip", ""); //客户端 IP
extraMap.Add("opid", ""); // 游族统一运营商 ID,新标准中应为 4 位数字;
extraMap.Add("opgameid", ""); // 混服组 ID,如不能直接获取,默认使用 server_id 前 4 位
extraMap.Add("server_id", ""); // 服务器 ID,一般为 10 位数字,例如,2015311523
extraMap.Add("server_type", ""); // 1:正式服,2:非正式服(包含各类测试服)
extraMap.Add("account", ""); // 带 SuperSDK 前缀的 userID
extraMap.Add("account_register_time", ""); // 平台账号在平台首次注册的时间,10 位 Unix 时间戳
extraMap.Add("account_first_ingame_time", ""); // 平台账号在该游戏首次注册时间(所有游戏服里,第一个角色的注册时间),从平台接口获取,10 位 Unix 时间戳(秒)
extraMap.Add("role_id", ""); // 游戏角色 ID
extraMap.Add("role_name", ""); // 游戏角色名
extraMap.Add("level", ""); // 游戏角色等级
extraMap.Add("vip_level", ""); // 游戏角色 Vip 等级
extraMap.Add("role_register_time", ""); // 角色注册时间,10 位 Unix 时间戳(秒),例如,1479960346
extraMap.Add("role_power", ""); // 战力,发送当前战力数,默认值 0
extraMap.Add("role_union_id", ""); // 成员团体的 ID,如公会,部落、战队势力等。没有工会的默认发 '0'。
extraMap.Add("role_paid", ""); // 如果该角色从未付过费,发送值 0;如果付过费,发送值 1
extraMap.Add("role_type", ""); // 角色类型,标识角色的分类属性,1:正常 2:测试(不计入充值等统计) 3:GM/福利号 4:机器人 5:其它
extraMap.Add("ad_user", ""); // 1:广告用户,2:非广告用户,默认为 2。填数字,例如, '1',代表广告用户
extraMap.Add("loading_step", ""); // 加载步骤
extraMap.Add("is_key_loading_step", ""); // 是否必经步骤 1,是;0,否
extraMap.Add("extra_1", ""); //扩展字段1
extraMap.Add("extra_2", ""); //扩展字段2
extraMap.Add("extra_3", ""); //扩展字段3
extraMap.Add("extra_4", ""); //扩展字段4
extraMap.Add("extra_5", ""); //扩展字段5
extraMap.Add("extra_6", ""); //扩展字段6
extraMap.Add("extra_7", ""); //扩展字段7
extraMap.Add("extra_8", ""); //扩展字段8
extraMap.Add("extra_9", ""); //扩展字段9
extraMap.Add("extra_10", ""); //扩展字段10
} catch (Exception e) {
}
paramData.Add(SuperSDKStats.KEY_EXTRA, extraMap); // 扩展信息,游戏所有数据都可以通过这里传入,使用 json 格式。
SuperSDK.getInstance().Invoke("stats", "reportCustomData", paramData);
常量字符串 | 实际字符串 | 描述 |
---|---|---|
SuperSDKStats.MODULE_NAME | stats | 模块名称 |
SuperSDKStats.KEY_EVENT_ID | event_id | 事件 ID |
SuperSDKStats.KEY_EVENT_LABEL | event_label | 事件标签 |
SuperSDKStats.KEY_DESC | desc | 描述 |
SuperSDKStats.KEY_STACK | stack | 堆栈信息,发生异常时使用 |
SuperSDKStats.KEY_EXTRA | extra | 扩展信息 |