supersdk

文档中心

文档中心

下载文档

统计模块


统计模块用于自定义事件上报。

统计上报

接口描述:在游戏埋点处调用,将游戏所需记录的信息上报到统计模块。

注意一:事件标签 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 扩展信息