supersdk

文档中心

文档中心

下载文档

统计模块


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

统计上报

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

注意一:事件标签 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 统计上报方法名