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