下载文档

最后更新时间: 2021-02-04 03:12:47 PM

数据中心标准生态日志

一.概述

数据中心标准生态日志是对游戏内各种玩家角色行为和状态的统一标准记录规范。

主要包含以下日志:

日志类型 日志名称 内容
玩家快照表 RoleCache 活跃玩家每日日终状态
维度快照表 DimCache 活跃玩家每日日终维度培养状态
背包快照表 PackCache 活跃玩家每日日终背包道具统计
公会快照表 UnionCache 活跃玩家每日日终公会状态
道具快照表 ItemCache 活跃玩家每日日终背包中道具拥有量统计
心跳日志 SerLive 玩家活跃是定时发送日志,便于统计在线
玩法日志 RoleBehavior 记录玩家的玩法参与
活动日志 RolePromo 记录玩家的活动参与行为,包括兑换活动
公会动作日志 UnionAction 记录玩家的在公会内的行为
公会资源日志 UnionRes 记录公会自身的资源变化
商店购买日志 RoleShop 记录玩家在游戏内商店的购买行为
资源产销日志 RoleRes 记录玩家的资源产出和消耗
道具和维度变化日志 RoleItem 记录玩家的道具变化,包括武器,英雄等的产出和消耗,各维度的升级和升阶等
VIP升级日志 RoleVip 记录玩家的VIP等级提升
任务日志 RoleTask 记录玩家的任务进行
聊天日志 RoleChat 记录玩家的聊天
黄金消耗日志 RoleGold 记录每笔的黄金消耗以及消耗类型、以及折算百分比
好友添加日志 RoleFriend 记录玩家添加好友行为
游戏自定义日志 RoleExtra 自定义
自定义事件 待议

二.快照数据

快照数据是统计每日活跃玩家在当天结束时的各项状态。

表1:玩家快照表

用于记录玩家的等级、战力、首冲时间、历史累计充值等各项信息。

字段 新描述 是否必填 新说明 备注
log_type 日志类型 必填 固定为RoleCache,即玩家快照 记录玩家截至服务器当地时间每日24点的状态,可筛选当日活跃玩家的信息做快照
server_id 服务器ID 必填 服务器ID,一般为10位数字,例如,2015311523
opgame_id 混服组ID 必填 混服组ID,如不能直接获取,默认使用server_id前4位
server_type 服务器类型 必填 1:正式服,2:非正式服(包含各类测试服)。填数字,例如,’1’,代表正式服。 注意:在各类常规报表中,测试服数据不会被统计在内 或许需要通过开服系统获取
op_id 运营商ID 如存在必填 游族统一运营商ID,新标准中应为4位数字;例如游族官方苹果商店 AppStore_CN,对应 2107 如果全服只有一个运营商,必填
cache_day 快照日期 必填 快照前一天日期,格式为2016-01-01,表明是截至2016-01-02 00:00点的玩家状态
createtime_local 当地时间 必填 快照生成时的当地时间,格式为2016-01-01 00:00:03
timestamp 10位时间戳 必填 10位Unix时间戳(秒),例如,1479960346
time_zone 时区 必填 服务器当地时区,文字格式,需严格参考,America/Los_Angeles,Asia/Chongqing等国际通用标准,大小写敏感
account 平台账号 必填 玩家登录时用的平台账号,如游族平台账号,带前缀。 带前缀!通过SuperSDK登陆可能获取到如0060015_test123的账号,格式示例:0060015_test123
account_regtime 平台账号注册时间 如存在必填 平台账号在平台首次注册的时间
account_first_ingame_time 平台账号首次进入游戏时间 必填 平台账号在该游戏首次注册时间(所有游戏服里,第一个角色的注册时间),从平台接口获取,10位Unix时间戳(秒),例如,1479960346
client_ip 客户端IP 必填 客户端IP,不需要服务端IP,不需要端口号,例如,192.168.1.7
role_id 角色ID 必填 角色ID,应为全服唯一的ID 玩家进入游戏后被分配的账号,应为全服唯一的账号
role_name 角色名 必填 玩家在当前服务器的的角色昵称
role_regtime 角色注册时间 必填 角色注册时间,10位Unix时间戳(秒),例如,1479960346
role_career 角色职业 如存在必填 角色职业
role_level 角色等级 必填 角色等级,数字表示,如’65’
role_vip 角色VIP等级 必填 角色升级后VIP等级,一般是充值获得的等级,数字表示,如 ‘10’
country 角色国家 海外游戏必填 海外平台提供的国家信息
state 角色地区 海外游戏必填 海外平台提供的地区信息
role_unionid 公会ID 如存在必填 成员团体的ID,如公会,部落、战队势力等。没有工会的默认发 ‘0’。
union_name 公会名称 如存在必填 成员团体或公会的名称,如’雄霸天下’。没有工会的默认发 ‘0’。
role_type 角色类型 必填 角色类型,标识角色的分类属性,1:正常 2:测试(不计入充值等统计) 3:GM/福利号 4:机器人 5:其它 需要和数据中心确认计入日常统计的角色类型,例如,测试号和福利号充值是否计入充值?
ad_user 广告标签 如存在必填 1:广告用户,2:非广告用户,默认为2。填数字,例如, ‘1’,代表广告用户 海外平台数据接口开发中
diamond 真钻存量 必填 钻石存量,用户充值获得的钻石(也有可能叫黄金、元宝之类的),非赠送,默认值0
blackdiamond 赠送钻石存量 必填 假钻存量,赠送的钻石或参与玩法获得的钻石,默认值0
money 金币存量 必填 金币存量,游戏内的基础货币,比如少三中的银币,默认值0
channel_id CPS分包ID 手游需填 手机端注册游戏时CPS分包ID,默认值为0 手游分包必填
device_type 设备型号 如存在必填 设备型号,例如iPhone 6s,PC
device_os 操作系统 如存在必填 设备操作系统,例如 iOS 9.2
device_id 设备ID 如存在必填 设备号 取SuperSDK的设备号
role_exp 角色经验 必填 经验,角色当前的经验值,数字,默认值0
role_power 角色战力 必填 战力,发送当前战力数,默认值0
role_create_time 创角时间 必填 角色创角/起名时间,10位Unix时间戳(秒),例如,1479960346 角色起名时间,如无创角步骤(角色注册之后),默认填角色注册时间
guide_id_max 新手引导最大ID 必填 最后停留的新手引导ID 新手引导ID需要保证是增序的,如非增序请告知数据部门
last_map_id 最后停留区域ID 如存在必填 玩家最后登出时停留的场景区域id/副本id 最后停留由游戏方确认,如上次登出的停留区域,每N分钟记录一次玩家停留区域
last_login 最后登录时间 必填 最后登录时间,10位Unix时间戳(秒),例如,1479960346
last_logout 最后登出时间 必填 最后登出时间,10位Unix时间戳(秒),例如,1479960346
total_login_days 总登陆天数 必填 总登陆天数,整数,玩家如有跨天登陆行为,需在凌晨为玩家打一条登录日志,同时这里的总登陆天数+1
daily_pay_diamond 当日充值钻石 必填 当日累计充值钻石,整数,没充值的,默认发0
max_daily_pay_diamond 最大单日充值钻石 必填 最大单日充值钻石,整数,没充值的,默认发0
max_single_pay_diamond 最大单笔充值钻石 必填 最大单笔充值钻石,整数,没充值的,默认发0
total_pay_diamond 累计充值钻石 必填 累计充值钻石(虚拟充值货币),没充值的,默认发0
total_pay_money 累计充值金额 必填 累计充值金额(实体货币),浮点,至少两位小数,没充值的,默认发0
total_pay_days 累计充值天数 必填 累计充值天数,整数,没充值的,默认发0
total_pay_times 累计充值次数 必填 累计充值次数,整数,没充值的,默认发0
first_pay_diamond 首充钻石 必填 首次充值金额换算钻石, 不含赠送,没充值的,默认发0
first_pay_time 首充时间 必填 首次充值时间,10位Unix时间戳(秒),例如,1479960346
last_pay_time 最后充值时间 必填 最后充值时间,10位Unix时间戳(秒),例如,1479960346
arena_rank 竞技场排名 如存在必填 当天最后竞技场排名
game_ver 游戏版本号 如存在必填 当前游戏版本号
ver 数据SDK版本 如存在必填 数据SDK版本,默认值在SDK代码中提供 可能根据数据采集方式调整
customized 游戏自定义字段 手游必填 游戏自定义字段,Json,{英文字段名: 值} ※手游新增以下内容,yz_device_id必填;oaid只针对国内项目,海外项目忽略: (1)yz_device_id,游族设备ID,需要接入游族supersdk,规范游族内移动设备ID数据,使不同数据源内容保持一致,现supersdk提供游族统一设备ID获取接口,给所有游族设备进行统一编号 (2)oaid,国内安卓联盟设备ID,oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识,统一由supersdk接口获取 注:字段内格式不限制,但数据中心入库时最多解析一层Json,增删字段前需要与数据中心确认 如 {“yz_device_id”: “c434023a520cbc18e4eccd259ea78805”, “oaid”: “d967b13aeedf033a”}
device 设备 如存在必填 注:与device_id重复,若已填device_id,此处填null
bundle_id 分包id 如存在必填
model 机型 如存在必填
extra_1 字段1 如存在必填
extra_2 字段2 如存在必填
extra_3 字段3 如存在必填
此处省略extra_4至extra_47
extra_48 字段48 如存在必填
extra_49 字段49 如存在必填
extra_50 字段50 如存在必填

表2:维度快照表

记录玩家各类道具、武将、宠物等维度的培养信息

字段 新描述 是否必填 新说明 备注
log_type 日志类型 必填 固定为DimCache,即维度快照 记录玩家各维度(英雄,宠物,技能,装备等填充维度的相关填充道具和子维度等级)
截至服务器当地时间每日24点的状态,可筛选当日活跃玩家的信息做快照
server_id 服务器ID 必填 服务器ID,一般为10位数字,例如,2015311523
op_id 运营商ID 如存在必填 游族统一运营商ID,新标准中应为4位数字;例如游族官方苹果商店 AppStore_CN,对应 2107 如果全服只有一个运营商,必填
cache_day 快照日期 必填 快照前一天日期,格式为2016-01-01,表明是截至2016-01-02 00:00点的玩家状态
createtime_local 当地时间 必填 快照生成时的当地时间,格式为2016-01-01 00:00:03
timestamp 10位时间戳 必填 10位Unix时间戳(秒),例如,1479960346
time_zone 时区 必填 服务器当地时区,文字格式,需严格参考,America/Los_Angeles,Asia/Chongqing等国际通用标准,大小写敏感
account 平台账号 必填 玩家登录时用的平台账号,如游族平台账号,带前缀。 带前缀!通过SuperSDK登陆可能获取到如0060015_test123的账号,格式示例:0060015_test123
role_id 角色ID 必填 角色ID,应为全服唯一的ID 玩家进入游戏后被分配的账号,应为全服唯一的账号
role_name 角色名 必填 玩家在当前服务器的的角色昵称
role_regtime 角色注册时间 必填 角色注册时间,10位Unix时间戳(秒),例如,1479960346
role_level 角色等级 必填 角色等级,数字表示,如’65’
role_vip 角色VIP等级 必填 角色升级后VIP等级,一般是充值获得的等级,数字表示,如 ‘10’
last_login 最后登录时间 必填 最后登录时间,10位Unix时间戳(秒),例如,1479960346
dim_type 维度类型 必填 维度类型,发中文或可读的英文,如装备,技能,英雄,服装,宠物,宝石,女神等
dim_id 填充维度id 必填 可能为道具id(英雄,宠物),位置id(装备位置),技能id等
dim_name 填充维度名称 必填 如胜利女神,张起灵,左肩,万箭齐发(技能)等
dim_item_id 填充道具id 如存在必填 维度对应的填充道具,如肩部装备了黄金肩甲,则此处记录黄金肩甲道具id
sub_dim_1 子维度填充1 如存在必填 如有填充道具,记录填充道具的各个维度的等级或内容。
sub_dim_2 子维度填充2 如存在必填 如没有填充道具,则记录维度类型对应的子维度培养等级。
sub_dim_3 子维度填充3 如存在必填 维度和子维度对照关系由游戏自定义。
sub_dim_4 子维度填充4 如存在必填 如英雄,有等级,星级,品质三个子维度,则可分别记录在子维度等级1,2,3中。
sub_dim_5 子维度填充5 如存在必填 需要游戏提供各类维度对应的子维度记录说明。
sub_dim_6 子维度填充6 如存在必填
sub_dim_7 子维度填充7 如存在必填
sub_dim_8 子维度填充8 如存在必填
sub_dim_9 子维度填充9 如存在必填
sub_dim_10 子维度填充10 如存在必填
game_ver 游戏版本号 如存在必填 当前游戏版本号
ver 数据SDK版本 如存在必填 数据SDK版本,默认值在SDK代码中提供 可能根据数据采集方式调整
customized 游戏自定义字段 手游必填 游戏自定义字段,Json,{英文字段名: 值} ※手游新增以下内容,yz_device_id必填;oaid只针对国内项目,海外项目忽略: (1)yz_device_id,游族设备ID,需要接入游族supersdk,规范游族内移动设备ID数据,使不同数据源内容保持一致,现supersdk提供游族统一设备ID获取接口,给所有游族设备进行统一编号 (2)oaid,国内安卓联盟设备ID,oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识,统一由supersdk接口获取 注:字段内格式不限制,但数据中心入库时最多解析一层Json,增删字段前需要与数据中心确认。如: {“yz_device_id”: “c434023a520cbc18e4eccd259ea78805”, “oaid”: “d967b13aeedf033a”}
device 设备 如存在必填
bundle_id 分包id 如存在必填
model 机型 如存在必填
extra_1 字段1 如存在必填
extra_2 字段2 如存在必填
extra_3 字段3 如存在必填
... ... ... 此处省略extra_4至extra_47
extra_48 字段48 如存在必填
extra_49 字段49 如存在必填
extra_50 字段50 如存在必填

表3:背包快照表

记录玩家各类资源、道具的拥有情况

字段 新描述 是否必填 新说明 备注
log_type 日志类型 必填 固定为PackCache,即背包快照 记录玩家截至服务器当地时间每日24点的背包内容,可筛选当日活跃玩家的信息做快照
server_id 服务器ID 必填 服务器ID,一般为10位数字,例如,2015311523
op_id 运营商ID 如存在必填 游族统一运营商ID,新标准中应为4位数字;例如游族官方苹果商店 AppStore_CN,对应 2107 如果全服只有一个运营商,必填
cache_day 快照日期 必填 快照前一天日期,格式为2016-01-01,表明是截至2016-01-02 00:00点的玩家状态
createtime_local 当地时间 必填 快照生成时的当地时间,格式为2016-01-01 00:00:03
timestamp 10位时间戳 必填 10位Unix时间戳(秒),例如,1479960346
time_zone 时区 必填 服务器当地时区,文字格式,需严格参考,America/Los_Angeles,Asia/Chongqing等国际通用标准,大小写敏感
account 平台账号 必填 玩家登录时用的平台账号,如游族平台账号,带前缀。 带前缀!通过SuperSDK登陆可能获取到如0060015_test123的账号,格式示例:0060015_test123
role_id 角色ID 必填 角色ID,应为全服唯一的ID 玩家进入游戏后被分配的账号,应为全服唯一的账号
role_name 角色名 必填 玩家在当前服务器的的角色昵称
role_regtime 角色注册时间 必填 角色注册时间,10位Unix时间戳(秒),例如,1479960346
role_level 角色等级 必填 角色等级,数字表示,如’65’
role_vip 角色VIP等级 必填 角色升级后VIP等级,一般是充值获得的等级,数字表示,如 ‘10’
last_login 最后登录时间 必填 最后登录时间,10位Unix时间戳(秒),例如,1479960346
pack1 背包1 必填 主背包内容, 必填,Json,{道具id: 数量, 等级,…} 格式有游戏自定义,但首位要记数量
pack2 背包2 如存在必填 如有其它背包希望区别记录,可使用,各字段记录的内容需要对照表
pack3 背包3 如存在必填
pack4 背包4 如存在必填
pack5 背包5 如存在必填
game_ver 游戏版本号 如存在必填 当前游戏版本号
ver 数据SDK版本 如存在必填 数据SDK版本,默认值在SDK代码中提供 可能根据数据采集方式调整
customized 游戏自定义字段 手游必填 游戏自定义字段,Json,{英文字段名: 值}
※手游新增以下内容,yz_device_id必填;oaid只针对国内项目,海外项目忽略:
(1)yz_device_id,游族设备ID,需要接入游族supersdk,规范游族内移动设备ID数据,使不同数据源内容保持一致,现supersdk提供游族统一设备ID获取接口,给所有游族设备进行统一编号。
(2)oaid,国内安卓联盟设备ID,oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识,统一由supersdk接口获取。
注:字段内格式不限制,但数据中心入库时最多解析一层Json,增删字段前需要与数据中心确认如 。如:{“yz_device_id”: “c434023a520cbc18e4eccd259ea78805”, “oaid”: “d967b13aeedf033a”}
device 设备 如存在必填
bundle_id 分包id 如存在必填
model 机型 如存在必填
extra_1 字段1 如存在必填
extra_2 字段2 如存在必填
extra_3 字段3 如存在必填
此处省略extra_4extra_47
extra_48 字段48 如存在必填
extra_49 字段49 如存在必填
extra_50 字段50 如存在必填

表4:公会快照表

活跃玩家每日日终公会状态

字段 新描述 是否必填 新说明 备注
log_type 日志类型 必填 固定为UnionCache,即工会快照 记录公会各维度截至服务器当地时间每日24点的状态,可筛选当日活跃玩家的信息做快照
server_id 服务器ID 必填 服务器ID,一般为10位数字,例如,2015311523
op_id 运营商ID 如存在必填 游族统一运营商ID,新标准中应为4位数字;例如游族官方苹果商店 AppStore_CN,对应 2107 如果全服只有一个运营商,必填
cache_day 快照日期 必填 快照前一天日期,格式为2016-01-01,表明是截至2016-01-02 00:00点的玩家状态
createtime_local 当地时间 必填 快照生成时的当地时间,格式为2016-01-01 00:00:03
timestamp 10位时间戳 必填 10位Unix时间戳(秒),例如,1479960346
time_zone 时区 必填 服务器当地时区,文字格式,需严格参考,America/Los_Angeles,Asia/Chongqing等国际通用标准,大小写敏感
union_id 公会ID 必填 公会ID
union_name 公会名 必填 公会名称
union_createtime 公会创建时间 必填 公会创建时间,10位Unix时间戳(秒),例如,1479960346
union_createtime_local 公会创建当地时间 必填 公会创建的当地时间
union_level 公会等级 必填 公会等级,数字表示
founder_id 公会创始人ID 必填 角色升级后VIP等级,一般是充值获得的等级,数字表示,如 ‘10’
deacon_id 当前会长ID 必填 最后登录时间,10位Unix时间戳(秒),例如,1479960346
union_maxmember 公会当前人数上限 必填 公会当前人数上限
union_member 公会当前人数 必填 公会当前会员数
union_login 公会当日登录人数 必填 公会当日登录人数
union_donate 公会当日总捐献经验 必填 公会当日总捐献经验
union_rank 公会排名 必填 公会排行榜名词
union_power 公会总战力 如存在必填 公会总战力
sub_dim_1 维度填充 如存在必填 公会建筑等级,随着公会建筑增加可以扩充
sub_dim_2 维度填充 如存在必填
sub_dim_3 维度填充 如存在必填
sub_dim_4 维度填充 如存在必填
sub_dim_5 维度填充 如存在必填
sub_dim_6 维度填充 如存在必填
sub_dim_7 维度填充 如存在必填
sub_dim_8 维度填充 如存在必填
sub_dim_9 维度填充 如存在必填
sub_dim_10 维度填充 如存在必填
sub_dim_11 维度填充 如存在必填
sub_dim_12 维度填充 如存在必填
sub_dim_13 维度填充 如存在必填
sub_dim_14 维度填充 如存在必填
sub_dim_15 维度填充 如存在必填
sub_dim_16 维度填充 如存在必填
sub_dim_17 维度填充 如存在必填
sub_dim_18 维度填充 如存在必填
sub_dim_19 维度填充 如存在必填
sub_dim_20 维度填充 如存在必填
sub_dim_21 维度填充 如存在必填
sub_dim_22 维度填充 如存在必填
sub_dim_23 维度填充 如存在必填
sub_dim_24 维度填充 如存在必填
sub_dim_25 维度填充 如存在必填
sub_dim_26 维度填充 如存在必填
sub_dim_27 维度填充 如存在必填
sub_dim_28 维度填充 如存在必填
sub_dim_29 维度填充 如存在必填
sub_dim_30 维度填充 如存在必填
game_ver 游戏版本号 如存在必填 当前游戏版本号
ver 数据SDK版本 如存在必填 数据SDK版本,默认值在SDK代码中提供 可能根据数据采集方式调整
customized 游戏自定义字段 如存在必填 游戏自定义字段,Json,{英文字段名: 值} 注:字段内格式不限制,但数据中心入库时最多解析一层Json 增删字段前需要与数据中心确认
device 设备 如存在必填
bundle_id 分包id 如存在必填
model 机型 如存在必填
extra_1 字段1 如存在必填
extra_2 字段2 如存在必填
extra_3 字段3 如存在必填
此处省略extra_4extra_47
extra_48 字段48 如存在必填
extra_49 字段49 如存在必填
extra_50 字段50 如存在必填

表5:道具快照表

活跃玩家每日日终背包中道具拥有量

字段 新描述 是否必填 新说明 备注
log_type 日志类型 必填 固定为ItemCache,即道具快照 记录背包中道具拥有量截至服务器当地时间每日24点的状态,可筛选当日活跃玩家的信息做快照
gameid 游戏ID 必填 游戏ID,开服系统中的游戏ID
server_id 服务器ID 必填 服务器ID,一般为10位数字,例如,2015311523
opgame_id 混服组ID 必填 混服组ID,如不能直接获取,默认使用server_id前4位
op_id 运营商ID 如存在必填 游族统一运营商ID,新标准中应为4位数字;例如游族官方苹果商店 AppStore_CN,对应 2107 如果全服只有一个运营商,必填
cache_day 快照日期 必填 快照前一天日期,格式为2016-01-01,表明是截至2016-01-02 00:00点的玩家状态
account 平台账号 必填 玩家登录时用的平台账号,如游族平台账号,带前缀。 带前缀!通过SuperSDK登陆可能获取到如0060015_test123的账号,格式示例:0060015_test123
role_id 角色ID 必填 角色ID,应为全服唯一的ID 玩家进入游戏后被分配的账号,应为全服唯一的账号
item_id 道具ID 必填 道具ID,例如,如果红宝石的道具ID为30030,发 ‘30030’
item_name 道具名称 必填 道具名称,发中文或可读的英文,例如,’橙色吕布碎片’,’红宝石’
item_num 道具数量 必填 背包中道具拥有数量,默认为0
device 设备 如存在必填
bundle_id 分包id 如存在必填
model 机型 如存在必填
extra_1 字段1 如存在必填
extra_2 字段2 如存在必填
extra_3 字段3 如存在必填
此处省略extra_4extra_47
extra_48 字段48 如存在必填
extra_49 字段49 如存在必填
extra_50 字段50 如存在必填

三.生态行为日志

生态行为日志记录了玩家角色在游戏内的各类游戏相关行为,比如玩法参与、活动参与、资源产销、道具购买等。

公共字段

公共字段记录的是玩家角色的基础信息,能够明确标明该生态行为发生时,角色的具体信息。

字段 新描述 是否必填 新说明 备注
game_id 游戏ID 必填 游戏ID,开服系统中的游戏ID
event_id 事件ID 必填 事件id,根据事件类型,角色id,发生时间地点等来产生该 id。例如两个人对战,处于同一事件,共用一个事件ID;用两种资源一起兑换一个道具,两条消耗日志,使用同一个事件ID。 记录事件 ID 主要可以用于标示多条日志是同一行为产生的,方便追溯和定位玩家行为。
server_id 服务器ID 必填 服务器ID,一般为10位数字,例如,2015311523
opgame_id 混服组ID 必填 混服组ID,如不能直接获取,默认使用server_id前4位
server_type 服务器类型 必填 1:正式服,2:非正式服(包含各类测试服)。填数字,例如,’2’,代表正式服。 注意:在各类常规报表中,测试服数据不会被统计在内 或许需要通过开服系统获取
op_id 运营商ID 必填 游族统一运营商ID,新标准中应为4位数字;例如游族官方苹果商店 AppStore_CN,对应 2107 非常重要!如果不确定,需要找运维同事确认!
createtime_local 当地时间 必填 行为发生时的当地时间,格式为2015-11-01 12:20:22
timestamp 10位时间戳 必填 10位Unix时间戳(秒),例如,1479960346
time_zone 时区 必填 服务器当地时区,文字格式,需严格参考,America/Los_Angeles,Asia/Chongqing等国际通用标准,大小写敏感
account 平台账号 必填 玩家登录时用的平台账号,如游族平台账号,带前缀。 带前缀!通过SuperSDK登陆可能获取到如0060015_test123的账号,格式示例:0060015_test123
account_regtime 平台账号注册时间 必填 平台账号在平台首次注册的时间,10位Unix时间戳(秒),例如,1479960346 海外平台数据接口开发中
account_first_ingame_time 平台账号首次进入游戏时间 必填 平台账号在该游戏首次注册时间(所有游戏服里,第一个角色的注册时间),从平台接口获取,10位Unix时间戳(秒),例如,1479960346 海外平台数据接口开发中
client_ip 客户端IP 必填 客户端IP,不需要服务端IP,不需要端口号,例如,192.168.1.7
country 国家 如存在必填 中国、俄罗斯等
language 语种 如存在必填 中文、英语等
role_id 角色ID 必填 角色ID,应为全服唯一的ID 玩家进入游戏后被分配的账号,应为全服唯一的账号
role_name 角色名 必填 玩家在当前服务器的的角色昵称
role_regtime 角色注册时间 必填 角色注册时间,10位Unix时间戳(秒),例如,1479960346
role_career 角色职业 如存在必填 角色职业
role_level 角色等级 必填 角色等级,数字表示,如’65’
role_vip 角色VIP等级 必填 角色vip等级,一般是充值获得的等级,数字表示,如 ‘10’
role_power 角色战力 必填 战力,发送当前战力数,默认值0
role_unionid 公会ID 如存在必填 成员团体的ID,如公会,部落、战队势力等。没有工会的默认发 ‘0’。
role_paid 是否付费用户 必填 如果该角色从未付过费,发送值0;如果付过费,发送值1 如U币充值两元也可以达到VIP1,该字段可不传?
role_type 角色类型 必填 角色类型,标识角色的分类属性,1:正常 2:测试(不计入充值等统计) 3:GM/福利号 4:机器人 5:其它 需要和数据中心确认计入日常统计的角色类型,例如,测试号和福利号充值是否计入充值?
ad_user 广告标签 如存在必填 1:广告用户,2:非广告用户,默认为2。填数字,例如, ‘1’,代表广告用户
channel_id CPS分包ID 手游需填 手机端注册游戏时CPS分包ID,默认值为0 手游分包必填
device_type 设备型号 如存在必填 设备型号,例如iPhone 6s,PC
device_os 操作系统 如存在必填 设备操作系统,例如 iOS 9.2
device_id 设备ID 如存在必填 设备号 取SuperSDK的设备号
game_ver 游戏版本号 如存在必填 当前游戏版本号
ver 数据SDK版本 如存在必填 数据SDK版本,默认值在SDK代码中提供 可能根据数据采集方式调整

玩法日志

玩法日志记录玩家在游戏中各类玩法的参与情况,并记录玩法参与前后的状态。

字段 新描述 是否必填 新说明 备注
log_type 日志类型 必填 固定为RoleBehavior,即玩法日志 记录玩家的玩法参与和特殊事件(非常规玩法,且不能计入已分类日志的行为,需和数据中心确认)
公共字段… 公共字段… 必填
b_type 玩法类别 必填 竞技场,组队副本,公会副本,随机副本,实时对战等,填中文名称(可理解意义的英文亦可)
zone 玩法子类 如存在必填 具体副本名称,地图区域等,尽量填中文或可理解的英文
b_id 玩法ID 如存在必填 玩法类型相对应的ID,如有需填 需要提供对照表
zone_id 副本ID 如存在必填 具体参与的副本ID 需要提供对照表
b_value 参与状态 必填 进入某面板\副本,点击开战,战斗胜利\失败,强制退出,扫荡/一次完成,黄金完成等,以策划为准,尽量发中文或可读的英文
session_length 玩法停留时间 如存在必填 玩家从进入玩法到结算/退出经历的时间,数字,秒
enemy_id 对手角色ID 如存在必填 对手的角色ID, 多个对手用JSON
rank_before 战斗前排名 如存在必填 战斗前,玩家在该玩法的排名
rank_after 战斗后排名 如存在必填 战斗后,玩家在该玩法的排名
b_param 自定义参数 如存在必填 其它玩法动作相关参数,需要提前将格式对照表发也给数据部门
union_name 公会名称 如存在必填 成员团体或公会的名称,如’雄霸天下’。没有工会的默认发 ‘0’。
battle_attr 玩家上阵道具属性 选填 JSON,{道具id:位置,等级,星数} 位置分两种:坐标和编号
buff_item_consume 消耗加成道具 选填 JSON,{道具id:消耗数量}
team_power 队伍战力 选填 组队战力
other_object 助阵对象 选填 JSON{玩家id or 助阵道具id:位置,等级..}
customized 游戏自定义字段 手游必填 游戏自定义字段,Json,{英文字段名: 值}手游新增以下内容,yz_device_id必填;oaid只针对国内项目,海外项目忽略:(1)yz_device_id,游族设备ID,需要接入游族supersdk,规范游族内移动设备ID数据,使不同数据源内容保持一致,现supersdk提供游族统一设备ID获取接口,给所有游族设备进行统一编号(2)oaid,国内安卓联盟设备ID,oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识,统一由supersdk接口获取 注:字段内格式不限制,但数据中心入库时最多解析一层Json,增删字段前需要与数据中心确认如 {“yz_device_id”: “c434023a520cbc18e4eccd259ea78805”, “oaid”: “d967b13aeedf033a”}
device 设备 如存在必填 注:与device_id重复,若已填device_id,此处填null
bundle_id 分包id 如存在必填
model 机型 如存在必填
extra_1 字段1 如存在必填
extra_2 字段2 如存在必填
extra_3 字段3 如存在必填
此处省略extra_4extra_47
extra_48 字段48 如存在必填
extra_49 字段49 如存在必填
extra_50 字段50 如存在必填

活动日志

活动日志记录玩家在游戏中的活动参与情况,以及活动中的消耗和获取情况。

字段 新描述 是否必填 新说明 备注
log_type 日志类型 必填 固定为RolePromo,即活动参与日志 记录玩家的活动参与行为,包括兑换活动
公共字段… 公共字段… 必填
activity_topic 活动主题 必填 活动名称的主题部分,用于活动归类,例如”充值送神将之神将赵云”,只需要发”充值送神将”;”月基金——五月好礼”,只要发”月基金”;专服活动须注明,如,’应用宝专享五月福利’ 活动主题用于后续活动分析中的活动归类,活动主题记录的详细程度由游戏自定义,以游戏自身具体的活动归类规则;如果没有副标题,如,’累计登录’, ‘累计签到’,’小周卡’,等可以直接发;
activity_step 活动子类 必填 具体活动副本,区间,档次,如果没有,发活动描述或活动主题;例如,’累计充值500钻’,’累计登录10天’,’月基金-低档’,’小周卡’ 活动子类用于单个活动的详细分析,不同期同主题的活动,如果各个参与档次的实际参与条件相同,应发送相同的活动子类名称
step_id 活动ID 必填 玩家实际参与的活动副本ID,一般为活动子类的副本ID,如果没有活动子类,发活动主题的副本ID
activity_id 活动唯一ID 如存在必填 本期活动的唯一ID,后续同类活动和同期其他活动不能使用同样的ID
item_spend 消耗的道具或资源 如存在必填 用于兑换类活动,记录兑换时消耗的道具和资源;JSON,{道具id:数量}
item_get 获得的活动奖励 如存在必填 参与活动获得的奖励;JSON,{道具id:数量}
activity_begin 活动开始时间 必填 活动开始的时间,10位Unix时间戳(秒),例如,1479960346
activity_end 活动结束时间 必填 活动结束的时间,10位Unix时间戳(秒),例如,1479960346
activity_special 是否精彩活动/配置活动 必填 0:非精彩活动(版本内固定活动,开服活动,日常活动等),1:精彩活动(非版本内固定活动,如Icon活动,配置活动)。填数字,如,’1’
activity_pay 是否充值活动 必填 1:充值活动(需要充值后参与) 0:不是充值活动,填数字,例如,’1’
activity_range 活动范围 必填 1:全服,2:专服,3:专属(个性化活动)
enter_level 可参与等级区间 如存在必填 可参与等级闭区间,如,[30, 60] 需要讨论记录格式
enter_vip 可参与VIP等级区间 如存在必填 可参与VIP闭区间,如,[3, 10]
diamond 钻石存量 必填 钻石存量,用户充值获得的钻石(也有可能叫黄金、元宝之类的),非赠送,默认值0
blackdiamond 赠送钻石存量 必填 假钻存量,赠送的钻石或参与玩法获得的钻石,默认值0
money 金币存量 如存在必填 金币存量,游戏内的基础货币,比如少三中的银币,默认值0
customized 游戏自定义字段 手游必填 游戏自定义字段,Json,{英文字段名: 值}手游新增以下内容,yz_device_id必填;oaid只针对国内项目,海外项目忽略:(1)yz_device_id,游族设备ID,需要接入游族supersdk,规范游族内移动设备ID数据,使不同数据源内容保持一致,现supersdk提供游族统一设备ID获取接口,给所有游族设备进行统一编号(2)oaid,国内安卓联盟设备ID,oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识,统一由supersdk接口获取 注:字段内格式不限制,但数据中心入库时最多解析一层Json,增删字段前需要与数据中心确认如 {“yz_device_id”: “c434023a520cbc18e4eccd259ea78805”, “oaid”: “d967b13aeedf033a”}
device 设备 如存在必填 注:与device_id重复,若已填device_id,此处填null
bundle_id 分包id 如存在必填
model 机型 如存在必填
extra_1 字段1 如存在必填
extra_2 字段2 如存在必填
extra_3 字段3 如存在必填
此处省略extra_4extra_47
extra_48 字段48 如存在必填
extra_49 字段49 如存在必填
extra_50 字段50 如存在必填

公会动作日志

公会日志记录玩家建立、加入、离开、解散公会的各项行为

字段 新描述 是否必填 新说明 备注
log_type 日志类型 必填 固定为UnionAction,即公会动作日志 记录玩家的在公会内的行为
event_id 事件ID 必填 事件id,根据事件类型,角色id,发生时间地点等来产生该 id。例如两个人对战,处于同一事件,共用一个事件ID;用两种资源一起兑换一个道具,两条消耗日志,使用同一个事件ID。 记录事件 ID 主要可以用于标示多条日志是同一行为产生的,方便追溯和定位玩家行为。
ver 数据SDK版本 必填 数据SDK版本,默认值在SDK代码中提供
op_id 运营商ID 必填 游族统一运营商ID,新标准中应为4位数字;例如游族官方苹果商店 AppStore_CN,对应 2107 非常重要!如果不确定,需要找运维同事确认!
opgame_id 混服组ID 必填 混服组ID,如不能直接获取,默认使用server_id前4位
server_type 服务器类型 必填 1:正式服,2:非正式服(包含各类测试服)。填数字,例如,’1’,代表正式服。 注意:在各类常规报表中,测试服数据不会被统计在内 或许需要通过开服系统获取
server_id 服务器ID 必填 服务器ID,一般为10位数字,例如,2015311523
createtime_local 当地时间 必填 行为发生时的当地时间,格式为2015-11-01 12:20:22
timestamp 10位时间戳 必填 10位Unix时间戳(秒),例如,1479960346
time_zone 时区 必填 服务器当地时区,文字格式,需严格参考,America/Los_Angeles,Asia/Chongqing等国际通用标准,大小写敏感
client_ip 客户端IP 必填 客户端IP,不需要服务端IP,不需要端口号,例如,192.168.1.7
account 平台账号 必填 玩家登录时用的平台账号,如游族平台账号,带前缀。 带前缀!通过SuperSDK登陆可能获取到如0060015_test123的账号,格式示例:0060015_test123
role_id 角色ID 必填 角色ID,应为全服唯一的ID 玩家进入游戏后被分配的账号,应为全服唯一的账号
role_type 角色类型 必填 角色类型,标识角色的分类属性,1:正常 2:测试(不计入充值等统计) 3:GM/福利号 4:机器人 5:其它 需要和数据中心确认计入日常统计的角色类型,例如,测试号和福利号充值是否计入充值?
role_name 角色名 必填 玩家在当前服务器的的角色昵称
ad_user 广告标签 如存在必填 1:广告用户,2:非广告用户,默认为2。填数字,例如, ‘1’,代表广告用户
role_career 角色职业 如存在必填 角色职业
role_level 角色等级 必填 角色等级,数字表示,如’65’
role_vip 角色VIP等级 必填 角色升级后VIP等级,一般是充值获得的等级,数字表示,如 ‘10’
role_unionid 角色公会ID 必填 成员团体的ID,如公会,部落、战队势力等。没有工会的默认发 ‘0’。
union_name 公会名称 必填 成员团体或公会的名称,如’雄霸天下’。没有工会的默认发 ‘0’。
union_level 公会等级 必填 公会的主要等级,填数字,例如’10’,默认为’0’;如有多个等级,由游戏选出最重要的等级维度发送
union_size 公会人数 必填 玩家所在公会当时的成员数
action_type 动作类型 必填 创建公会’,’加入公会’,’退出公会’,‘解散公会’,‘更改公告’ 五个动作需要严格发送,发中文,例如,’加入公会’;其他动作可自定义,如被踢出公会/踢人出公会/更改公告/开启公会副本/参与公会副本/职位变化等
action_object 操作对象 如存在必填 例如,副本id、变化后职位编号、被踢的玩家id、公告内容
role_regtime 角色注册时间 必填 角色注册时间,10位Unix时间戳(秒),例如,1479960346
role_paid 是否付费用户 必填 如果该角色在升级前从未付过费,即本次为首次成为VIP,发送值0;如果付过费,发送值1
diamond 钻石存量 必填 钻石存量,用户充值获得的钻石(也有可能叫黄金、元宝之类的),非赠送,默认值0
blackdiamond 赠送钻石存量 必填 假钻存量,赠送的钻石或参与玩法获得的钻石,默认值0
money 金币存量 如存在必填 金币存量,游戏内的基础货币,比如少三中的银币,默认值0
device_type 设备型号 如存在必填 设备型号,例如iPhone 6s,PC
device_os 操作系统 如存在必填 设备操作系统,例如 iOS 9.2
device_id 设备ID 如存在必填 设备号 取SuperSDK的设备号
account_first_ingame_time 平台账号首次进入游戏时间 必填 平台账号在该游戏首次注册时间(所有游戏服里,第一个角色的注册时间),从平台接口获取,10位Unix时间戳(秒),例如,1479960346
account_regtime 平台账号注册时间 必填 平台账号在平台首次注册的时间,10位Unix时间戳(秒),例如,1479960346
game_ver 游戏版本号 如存在必填 当前游戏版本号
customized 游戏自定义字段 手游必填 游戏自定义字段,Json,{英文字段名: 值} 注:游戏如有公会公告功能,则必发,样例,{“notice”:“公告内容”},其他内容在此json基础上增加 ※手游新增以下内容,yz_device_id必填;oaid只针对国内项目,海外项目忽略: (1)yz_device_id,游族设备ID,需要接入游族supersdk,规范游族内移动设备ID数据,使不同数据源内容保持一致,现supersdk提供游族统一设备ID获取接口,给所有游族设备进行统一编号 (2)oaid,国内安卓联盟设备ID,oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识,统一由supersdk接口获取 注:字段内格式不限制,但数据中心入库时最多解析一层Json,增删字段前需要与数据中心确认 如 {“yz_device_id”: “c434023a520cbc18e4eccd259ea78805”, “oaid”: “d967b13aeedf033a”}
device 设备 如存在必填 注:与device_id重复,若已填device_id,此处填null
bundle_id 分包id 如存在必填
model 机型 如存在必填
extra_1 字段1 如存在必填
extra_2 字段2 如存在必填
extra_3 字段3 如存在必填
此处省略extra_4至extra_47
extra_48 字段48 如存在必填
extra_49 字段49 如存在必填
extra_50 字段50 如存在必填

公会资源日志

公会资源日志记录公会各项资源的变化情况

字段 新描述 是否必填 新说明 备注
log_type 日志类型 必填 固定为UnionRes,即公会资源日志 记录公会自身的资源变化
event_id 事件ID 必填 事件id,根据事件类型,角色id,发生时间地点等来产生该 id。例如两个人对战,处于同一事件,共用一个事件ID;用两种资源一起兑换一个道具,两条消耗日志,使用同一个事件ID。 记录事件 ID 主要可以用于标示多条日志是同一行为产生的,方便追溯和定位玩家行为。
ver 数据SDK版本 必填 数据SDK版本,默认值在SDK代码中提供
op_id 运营商ID 如存在必填 游族统一运营商ID,新标准中应为4位数字;例如游族官方苹果商店 AppStore_CN,对应 2107 如果全服只有一个运营商,必填
opgame_id 混服组ID 必填 混服组ID,如不能直接获取,默认使用server_id前4位
server_type 服务器类型 必填 1:正式服,2:非正式服(包含各类测试服)。填数字,例如,’1’,代表正式服。 注意:在各类常规报表中,测试服数据不会被统计在内 或许需要通过开服系统获取
server_id 服务器ID 必填 服务器ID,一般为10位数字,例如,2015311523
createtime_local 当地时间 必填 行为发生时的当地时间,格式为2015-11-01 12:20:22
timestamp 10位时间戳 必填 10位Unix时间戳(秒),例如,1479960346
time_zone 时区 必填 服务器当地时区,文字格式,需严格参考,America/Los_Angeles,Asia/Chongqing等国际通用标准,大小写敏感
role_unionid 公会ID 必填 成员团体的ID,如公会,部落、战队势力等。
union_name 公会名称 如存在必填 成员团体或公会的名称,如’雄霸天下’。没有工会的默认发 ‘0’。
union_level 公会等级 必填 公会的主要等级,填数字,例如’10’,默认为’0’;如有多个等级,由游戏选出最重要的等级维度发送
union_size 公会人数 必填 玩家所在公会当时的成员数
res_id 公会资源ID 必填 公会资源ID,公会活跃,贡献等;例如,若公会活跃的资源ID为102,发 ‘102’
res_name 公会资源名称 必填 资源名称,中文或可读英文,例如,’公会活跃’
amount_before 变化前数量 必填 变化发生前数量,数字
amount_after 变化后数量 必填 变化发生后/当前数量,数字
change_type 变化类型 必填 1:产出 2:消耗
change_amount 变化数量 必填 动作引起的数量变化,(变化后-变化前)的绝对值
change_reason 变化原因 必填 引起变化的原因,中文,例如,’玩家捐赠’ 如有公会间资源交易需要注明,并在相关对象ID中记录交易对方ID
related_id 相关对象ID 如存在必填 引起变化/变化涉及的玩家ID,其它公会ID,多个ID发JSON;如没有留空
game_ver 游戏版本号 如存在必填 当前游戏版本号
customized 游戏自定义字段 如存在必填 游戏自定义字段,Json,{英文字段名: 值} 注:字段内格式不限制,但数据中心入库时最多解析一层Json,增删字段前需要与数据中心确认
device 设备 如存在必填
bundle_id 分包id 如存在必填
model 机型 如存在必填
extra_1 字段1 如存在必填
extra_2 字段2 如存在必填
extra_3 字段3 如存在必填
此处省略extra_4extra_47
extra_48 字段48 如存在必填
extra_49 字段49 如存在必填
extra_50 字段50 如存在必填

商店购买日志

商店购买日志记录玩家在游戏内各项资源道具的购买和消耗情况。

字段 新描述 是否必填 新说明 备注
log_type 日志类型 必填 固定为RoleShop,即商店购买日志 记录玩家在游戏内商店的购买行为;
公共字段… 公共字段… 必填
shop_name 商店名称 必填 交易发生所在商店的名字,例如,’竞技场商店’
shop_id 商店ID 必填 交易发生所在商店的ID,例如,竞技场商店的ID为10016,发 ‘10016’
one_vs_one 是否一对一 必填 如果是一种资源兑换一种道具,填1;资源和道具,一对多或多对一或多对多时,填0 注意,兑换行为,即单笔交易中涉及三种及三种以上道具/资源的行为,type为0
items_spend 消耗的资源和数量 必填 记录消耗的资源种类和总数量;JSON,{资源id:数量}
items_get 获得的道具和数量 必填 记录买到的道具和总数量;JSON,{道具id:数量}
item_unit 商品单次购买数量 必填 商品单次购买数量,例如,10件蓝宝石打包卖,填10(如10件蓝宝有单独的打包道具id,填1即可)
item_amount 购买次数 必填 本次购买的购买件数,一般为购买件数框内玩家输入的数量
amount_limit 单日可购买次数上限 必填 若有购买上限,例如每人只能买5件,填5
discount_rate 折扣率 必填 小数,正价填1,75折填0.75
diamond 钻石存量 必填 钻石存量,用户充值获得的钻石(也有可能叫黄金、元宝之类的),非赠送,默认值0
blackdiamond 赠送钻石存量 必填 假钻存量,赠送的钻石或参与玩法获得的钻石,默认值0
money 金币存量 如存在必填 金币存量,游戏内的基础货币,比如少三中的银币,默认值0
customized 游戏自定义字段 手游必填 游戏自定义字段,Json,{英文字段名: 值}手游新增以下内容,yz_device_id必填;oaid只针对国内项目,海外项目忽略:(1)yz_device_id,游族设备ID,需要接入游族supersdk,规范游族内移动设备ID数据,使不同数据源内容保持一致,现supersdk提供游族统一设备ID获取接口,给所有游族设备进行统一编号(2)oaid,国内安卓联盟设备ID,oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识,统一由supersdk接口获取 注:字段内格式不限制,但数据中心入库时最多解析一层Json,增删字段前需要与数据中心确认如 {“yz_device_id”: “c434023a520cbc18e4eccd259ea78805”, “oaid”: “d967b13aeedf033a”}
device 设备 如存在必填 注:与device_id重复,若已填device_id,此处填null
bundle_id 分包id 如存在必填
model 机型 如存在必填
extra_1 字段1 如存在必填
extra_2 字段2 如存在必填
extra_3 字段3 如存在必填
此处省略extra_4extra_47
extra_48 字段48 如存在必填
extra_49 字段49 如存在必填
extra_50 字段50 如存在必填

资源产销日志

资源产销日志记录玩家各个资源产销点的资源获取和消耗情况

字段 新描述 是否必填 新说明 备注
log_type 日志类型 必填 固定为RoleRes,即资源产消日志 记录玩家的资源产出和消耗,资源包括钻石,黄金,金币,竞技币等货币,以及所有没有附加维度的消耗品(不能升级升阶等)
公共字段… 公共字段… 必填
res_id 资源ID 必填 资源ID,资源包括钻石,黄金,金币,竞技币等货币,以及所有没有附加维度的消耗品(不能升级升阶等);例如,如果钻石的资源ID为1,发 ‘1’
res_name 资源名称 必填 资源名称,发中文或可读的英文,例如,’钻石’,’竞技币’
amount_before 变化前数量 必填 变化发生前数量,数字
amount_after 变化后数量 必填 变化发生后/当前数量,数字
change_type 变化类型 必填 1:产出 2:消耗
change_amount 变化数量 必填 动作引起的数量变化,数字,(变化后-变化前)的绝对值
change_reason 变化原因 必填 引起变化的原因,中文或可读英文,例如,’充值’,’竞技场商店购买’,’活动奖励’,’钻石十连抽’;如果变化原因是玩家间交易, 应在这里注明,并且在”相关对象ID”中记录对方玩家角色ID所发送的原因将直接作为详细产销点, 用于资源产销的分析展示;玩家交易和资源转移指,两个玩家间的资源流动,如游戏没有交易系统可忽略
change_module 变化大类 如存在必填 引起变化的大模块,例如 ‘玩法’,’活动’,’商店’,’维度填充’,用于分析资源产销的一级分类,模块分类的细化程度以游戏自身需求为准 如果此字段为空,则默认用”变化原因”作为资源产销点的一级分类
related_id 相关对象ID 如存在必填 引起变化/变化涉及的其它玩家ID,多个ID发JSON;如没有留空
diamond 钻石存量 必填 钻石存量,用户充值获得的钻石(也有可能叫黄金、元宝之类的),非赠送,默认值0
blackdiamond 赠送钻石存量 必填 假钻存量,赠送的钻石或参与玩法获得的钻石,默认值0
money 金币存量 如存在必填 金币存量,游戏内的基础货币,比如少三中的银币,默认值0
customized 游戏自定义字段 手游必填 游戏自定义字段,Json,{英文字段名: 值}手游新增以下内容,yz_device_id必填;oaid只针对国内项目,海外项目忽略:(1)yz_device_id,游族设备ID,需要接入游族supersdk,规范游族内移动设备ID数据,使不同数据源内容保持一致,现supersdk提供游族统一设备ID获取接口,给所有游族设备进行统一编号(2)oaid,国内安卓联盟设备ID,oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识,统一由supersdk接口获取 注:字段内格式不限制,但数据中心入库时最多解析一层Json,增删字段前需要与数据中心确认如 {“yz_device_id”: “c434023a520cbc18e4eccd259ea78805”, “oaid”: “d967b13aeedf033a”}
device 设备 如存在必填 注:与device_id重复,若已填device_id,此处填null
bundle_id 分包id 如存在必填
model 机型 如存在必填
extra_1 字段1 如存在必填
extra_2 字段2 如存在必填
extra_3 字段3 如存在必填
此处省略extra_4extra_47
extra_48 字段48 如存在必填
extra_49 字段49 如存在必填
extra_50 字段50 如存在必填

道具和维度变化日志

道具和维度变化日志记录玩家对维度培养的行为以及各个维度的变化情况。

字段 新描述 是否必填 新说明 备注
log_type 日志类型 必填 固定为RoleItem,即道具和维度变化日志 记录玩家的道具和维度变化,包括武器,英雄,服装,宠物,技能等,变化包括道具的产出和消耗,各维度的升级,升阶等
公共字段… 公共字段… 必填
item_type 道具大类 必填 发中文或可读的英文,如武器,技能,英雄,服装,宠物,宝石,女神等
item_id 道具ID 必填 道具ID,例如,如果红宝石的道具ID为30030,发 ‘30030’
item_name 道具名称 必填 道具名称,发中文或可读的英文,例如,’橙色吕布碎片’,’红宝石’
change_type 变化类型 必填 “产出”,”消耗” 这两种变化需要严格发送,例如有道具被消耗,发 ‘消耗’;其它变化,升级,升阶,升星等等由游戏自定义,发中文或可读英文,如 ‘碎片合成’
status_before 变化前状态 必填 变化前的数量(发数字),等级(发数字),品阶,星级等
status_after 变化后状态 必填 变化后的数量(发数字),等级(发数字),品阶,星级等
change_reason 变化原因 必填 引起变化的原因,中文或可读英文,例如,’竞技场商店购买’,’钻石十连抽’;如果没有特殊原因,可和”变化类型”相同;如果变化原因是玩家间交易,应在这里注明,并且在”相关对象ID”中记录对方玩家角色ID 玩家交易和道具转移指,两个玩家间的资源/道具流动,如游戏没有交易系统可忽略
change_module 变化大类 如存在必填 引起变化的大模块,例如 ‘玩法’,’活动’,’商店’,’维度填充’,用于分析道具变化原因的一级分类,模块分类的细化程度以游戏自身需求为准 如果此字段为空,则默认用”变化原因”作为道具变化原因的一级分类
related_id 相关对象ID 如存在必填 引起变化/变化涉及的其它玩家ID,多个ID发JSON;如没有可留空
diamond 钻石存量 必填 钻石存量,用户充值获得的钻石(也有可能叫黄金、元宝之类的),非赠送,默认值0
blackdiamond 赠送钻石存量 必填 假钻存量,赠送的钻石或参与玩法获得的钻石,默认值0
money 金币存量 如存在必填 金币存量,游戏内的基础货币,比如少三中的银币,默认值0
customized 游戏自定义字段 手游必填 游戏自定义字段,Json,{英文字段名: 值} ※手游新增以下内容,yz_device_id必填;oaid只针对国内项目,海外项目忽略: (1)yz_device_id,游族设备ID,需要接入游族supersdk,规范游族内移动设备ID数据,使不同数据源内容保持一致,现supersdk提供游族统一设备ID获取接口,给所有游族设备进行统一编号 (2)oaid,国内安卓联盟设备ID,oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识,统一由supersdk接口获取 注:字段内格式不限制,但数据中心入库时最多解析一层Json,增删字段前需要与数据中心确认 如 {“yz_device_id”: “c434023a520cbc18e4eccd259ea78805”, “oaid”: “d967b13aeedf033a”}
device 设备 如存在必填 注:与device_id重复,若已填device_id,此处填null
bundle_id 分包id 如存在必填
model 机型 如存在必填
extra_1 字段1 如存在必填
extra_2 字段2 如存在必填
extra_3 字段3 如存在必填
此处省略extra_4至extra_47
extra_48 字段48 如存在必填
extra_49 字段49 如存在必填
extra_50 字段50 如存在必填

VIP升级日志

VIP升级日志记录玩家vip等级的升级行为。

字段 新描述 是否必填 新说明 备注
log_type 日志类型 必填 固定为RoleVip,即VIP升级日志 记录玩家的VIP等级,即角色付费等级提升;一次升多级
公共字段… 公共字段… 必填
role_vip_before 升级前VIP等级 必填 角色升级前VIP等级,一般是充值获得的等级,数字表示,如’9’
role_vip_after 升级后VIP等级 必填 角色升级后VIP等级,一般是充值获得的等级,数字表示,如 ‘10’
role_vipexp_before 升级前VIP经验 必填 升级前VIP经验,一般为历史累计充值金额,数字,默认值0
role_vipexp 升级后VIP经验 必填 升级后VIP经验,一般为升级后累计充值金额,数字,默认值0
role_energy 角色体力 如存在必填 体力,玩法参与时消耗的资源,发送剩余体力数,默认值0
diamond 钻石存量 必填 钻石存量,用户充值获得的钻石(也有可能叫黄金、元宝之类的),非赠送,默认值0
blackdiamond 赠送钻石存量 必填 假钻存量,赠送的钻石或参与玩法获得的钻石,默认值0
money 金币存量 如存在必填 金币存量,游戏内的基础货币,比如少三中的银币,默认值0
customized 游戏自定义字段 手游必填 游戏自定义字段,Json,{英文字段名: 值}手游新增以下内容,yz_device_id必填;oaid只针对国内项目,海外项目忽略:(1)yz_device_id,游族设备ID,需要接入游族supersdk,规范游族内移动设备ID数据,使不同数据源内容保持一致,现supersdk提供游族统一设备ID获取接口,给所有游族设备进行统一编号(2)oaid,国内安卓联盟设备ID,oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识,统一由supersdk接口获取 注:字段内格式不限制,但数据中心入库时最多解析一层Json,增删字段前需要与数据中心确认如 {“yz_device_id”: “c434023a520cbc18e4eccd259ea78805”, “oaid”: “d967b13aeedf033a”}
device 设备 如存在必填 注:与device_id重复,若已填device_id,此处填null
bundle_id 分包id 如存在必填
model 机型 如存在必填
extra_1 字段1 如存在必填
extra_2 字段2 如存在必填
extra_3 字段3 如存在必填
此处省略extra_4extra_47
extra_48 字段48 如存在必填
extra_49 字段49 如存在必填
extra_50 字段50 如存在必填

任务日志

任务日志记录玩家在游戏内各项任务的参与与完成情况。

字段 新描述 是否必填 新说明 备注
log_type 日志类型 必填 固定为RoleTask,即任务日志 记录玩家的任务完成进度
公共字段… 公共字段… 必填
task_type 任务类别 如存在必填 推图,日常,成就等,游戏自定义,尽量发中文或可读英文 用于任务归类
task_name 任务名称 如存在必填 任务的名字,中文或可读英文
task_id 任务ID 必填 任务ID,研发自定义,相应ID值以及对应的中文名称需要同步到数据中心,例如 ‘10010’ 任务ID尽量按增序分配,例如,任务A完成后才是任务B,任务B的ID应该比任务A的ID大
pre_task_id 前一步任务ID 如存在必填 前一步强制任务ID(完成前一步任务才能接受当前任务),用于整理引导展示顺序,例如‘10009’ 如不能保证任务ID为增序,请务必保证此字段准确发送
status 参与状态 如存在必填 任务的状态,1:到达/触发/接受 2:完成 3:失败 4:一键完成 5: 黄金完成 6:其它 如需增加状态 和数据中心核对 增加对照表
diamond 钻石存量 必填 钻石存量,用户充值获得的钻石(也有可能叫黄金、元宝之类的),非赠送,默认值0
blackdiamond 赠送钻石存量 必填 假钻存量,赠送的钻石或参与玩法获得的钻石,默认值0
money 金币存量 如存在必填 金币存量,游戏内的基础货币,比如少三中的银币,默认值0
customized 游戏自定义字段 手游必填 游戏自定义字段,Json,{英文字段名: 值}手游新增以下内容,yz_device_id必填;oaid只针对国内项目,海外项目忽略:(1)yz_device_id,游族设备ID,需要接入游族supersdk,规范游族内移动设备ID数据,使不同数据源内容保持一致,现supersdk提供游族统一设备ID获取接口,给所有游族设备进行统一编号(2)oaid,国内安卓联盟设备ID,oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识,统一由supersdk接口获取 注:字段内格式不限制,但数据中心入库时最多解析一层Json,增删字段前需要与数据中心确认如 {“yz_device_id”: “c434023a520cbc18e4eccd259ea78805”, “oaid”: “d967b13aeedf033a”}
device 设备 如存在必填 注:与device_id重复,若已填device_id,此处填null
bundle_id 分包id 如存在必填
model 机型 如存在必填
extra_1 字段1 如存在必填
extra_2 字段2 如存在必填
extra_3 字段3 如存在必填
此处省略extra_4extra_47
extra_48 字段48 如存在必填
extra_49 字段49 如存在必填
extra_50 字段50 如存在必填

聊天日志

聊天日志记录玩家在游戏内的聊天行为,包括所在频道,对象等

字段 新描述 是否必填 新说明 备注
log_type 日志类型 必填 固定为RoleChat,即聊天日志 记录玩家的聊天信息
公共字段… 公共字段… 必填
chat_channel 聊天频道 如存在必填 世界频道;公会频道;队伍频道;私聊
chat_object 聊天对象 如存在必填 公会id,队伍id,玩家id
chat_content 聊天内容 必填 具体聊天内容 由于聊天内容可能存在特殊字符(表情字符,游戏内特殊公式比如装备连接),需要确认存储格式
diamond 钻石存量 必填 钻石存量,用户充值获得的钻石(也有可能叫黄金、元宝之类的),非赠送,默认值0
blackdiamond 赠送钻石存量 必填 假钻存量,赠送的钻石或参与玩法获得的钻石,默认值0
money 金币存量 如存在必填 金币存量,游戏内的基础货币,比如少三中的银币,默认值0
customized 游戏自定义字段 手游必填 聊天内容的特殊内容可以通过自定义字段记录手游新增以下内容,yz_device_id必填;oaid只针对国内项目,海外项目忽略:(1)yz_device_id,游族设备ID,需要接入游族supersdk,规范游族内移动设备ID数据,使不同数据源内容保持一致,现supersdk提供游族统一设备ID获取接口,给所有游族设备进行统一编号(2)oaid,国内安卓联盟设备ID,oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识,统一由supersdk接口获取 如 {“yz_device_id”: “c434023a520cbc18e4eccd259ea78805”, “oaid”: “d967b13aeedf033a”}
device 设备 如存在必填 注:与device_id重复,若已填device_id,此处填null
bundle_id 分包id 如存在必填
model 机型 如存在必填
extra_1 字段1 如存在必填
extra_2 字段2 如存在必填
extra_3 字段3 如存在必填
此处省略extra_4extra_47
extra_48 字段48 如存在必填
extra_49 字段49 如存在必填
extra_50 字段50 如存在必填

黄金消耗日志

黄金消耗日志记录记录玩家每笔的黄金消耗以及消耗类型、以及折算百分比

字段 新描述 是否必填 新说明 备注
log_type 日志类型 必填 固定为RoleGold,即黄金消耗日志 记录玩家每笔的黄金消耗以及消耗类型、以及折算百分比
game_id 游戏ID 必填 游戏ID,开服系统中的游戏ID
server_id 服务器ID 必填 服务器ID,一般为10位数字,例如,2015311523
opgame_id 混服组ID 必填 混服组ID,如不能直接获取,默认使用server_id前4位
op_id 运营商ID 必填 游族统一运营商ID,新标准中应为4位数字;例如游族官方苹果商店 AppStore_CN,对应 2107 非常重要!如果不确定,需要找运维同事确认!
createtime_local 当地时间 必填 行为发生时的当地时间,格式为2015-11-01 12:20:22 日志时间
account 平台账号 必填 玩家登录时用的平台账号,如游族平台账号,带前缀。 带前缀!通过SuperSDK登陆可能获取到如0060015_test123的账号,格式示例:0060015_test123
role_id 角色ID 必填 角色ID,应为全服唯一的ID 玩家进入游戏后被分配的账号,应为全服唯一的账号
role_paid 是否付费用户 必填 如果该角色从未付过费,发送值0;如果付过费,发送值1 如U币充值两元也可以达到VIP1,该字段可不传?
channel_id CPS分包ID 手游需填 手机端注册游戏时CPS分包ID,默认值为0 手游分包必填
device_type 设备型号 如存在必填 设备型号,例如iPhone 6s,PC
device_os 操作系统 如存在必填 设备操作系统,例如 iOS 9.2
device_id 设备ID 如存在必填 设备号 取SuperSDK的设备号
factory 机型(主要) 如存在必填 机型型号,对应supersdk factory
model 机型(次要) 如存在必填 机型型号,对应supersdk model
consume_type 黄金消费类型 必填 消费类型
reason 产生原因 必填 产生原因
gold 总黄金消耗量 必填 (兑换+赠送)黄金的消耗,默认值0
item_id 道具ID 必填 道具ID,例如,如果红宝石的道具ID为30030,发 ‘30030’ 功能型的黄金消费,没有item_id ,item_name 。 处理方式:手工设定item_id,对应功能名称为item_name。 注意点:功能型的黄金消耗设定的item_id,一定要保证唯一,因为后面统计计算的时候,会做聚合计算。 影响:如果item_id,item_name 为空不传,后面的统计计算会把这部分数据排掉,不做相应计算。
item_name 道具名称 必填 道具名称,发中文或可读的英文,例如,’橙色吕布碎片’,’红宝石’
item_number 道具数量 必填 相关道具数量,默认值0 功能型消耗:默认值0
audit_type 分摊类型 必填 分摊类型:混合型、消耗型、长期型 长期型:所购买的道具(功能)可使用期间大于1个月,且部位一次性使用则属于长期型道具; 消耗型:购买的道具(功能),为一次性使用或者视同期限不超过1个月,为消耗型道具; 混合型:购买的物品为混合大礼包,礼包中包含长期型和消耗型道具;
long_ratio 长期型类型占比 必填 长期型类型占比 数据格式:0到100
short_ratio 消耗型类型占比 必填 消耗型类型占比 数据格式:0到100
param1 预留参数1 如存在必填 预留参数1
param2 预留参数2 如存在必填 预留参数2
customized 游戏自定义字段 手游必填 特殊内容可以通过自定义字段记录手游新增以下内容,yz_device_id必填;oaid只针对国内项目,海外项目忽略:(1)yz_device_id,游族设备ID,需要接入游族supersdk,规范游族内移动设备ID数据,使不同数据源内容保持一致,现supersdk提供游族统一设备ID获取接口,给所有游族设备进行统一编号(2)oaid,国内安卓联盟设备ID,oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识,统一由supersdk接口获取 如 {“yz_device_id”: “c434023a520cbc18e4eccd259ea78805”, “oaid”: “d967b13aeedf033a”}
device 设备 如存在必填 注:与device_id重复,若已填device_id,此处填null
bundle_id 分包id 如存在必填
extra_1 字段1 如存在必填
extra_2 字段2 如存在必填
extra_3 字段3 如存在必填
此处省略extra_4extra_47
extra_48 字段48 如存在必填
extra_49 字段49 如存在必填
extra_50 字段50 如存在必填

好友添加日志

记录玩家添加好友行为

字段 新描述 是否必填 新说明 备注
字段 新描述 是否必填 新说明 备注
log_type 日志类型 必填 固定为RoleFriend,即好友添加日志 记录玩家添加好友行为
公共字段 公共字段… 必填
friend_serverid 好友所在服务器id 必填
friend_account 好友账号 必填
friend_roleid 好友角色ID 必填
friend_name 好友名称 必填
friend_group 好友分组 必填
action_type 动作类型 必填
bundle_id 分包id 必填
model 机型 必填
extra_1 字段1 如存在必填
extra_2 字段2 如存在必填
extra_3 字段3 如存在必填
extra_4 字段4 如存在必填
extra_5 字段5 手游必填 手游新增以下内容,yz_device_id必填;oaid只针对国内项目,海外项目忽略:(1)yz_device_id,游族设备ID,需要接入游族supersdk,规范游族内移动设备ID数据,使不同数据源内容保持一致,现supersdk提供游族统一设备ID获取接口,给所有游族设备进行统一编号(2)oaid,国内安卓联盟设备ID,oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识,统一由supersdk接口获取 如 {“yz_device_id”: “c434023a520cbc18e4eccd259ea78805”, “oaid”: “d967b13aeedf033a”}

游戏自定义日志

游戏自定义日志供游戏方记录游戏自身所需日志,共有50个额外字段。

字段 新描述 是否必填 新说明 备注
log_type 日志类型 必填 固定为RoleExtra,按游戏自身填写,自定义日志表中可以存储多种日志
公共字段… 公共字段… 必填
extra_1 字段1 如存在必填
extra_2 字段2 如存在必填
extra_3 字段3 如存在必填
此处省略extra_4extra_47
extra_48 字段48 如存在必填
extra_49 字段49 如存在必填
extra_50 字段50 如存在必填
customized 游戏自定义字段 手游必填 游戏自定义字段,Json,{英文字段名: 值}手游新增以下内容,yz_device_id必填;oaid只针对国内项目,海外项目忽略:(1)yz_device_id,游族设备ID,需要接入游族supersdk,规范游族内移动设备ID数据,使不同数据源内容保持一致,现supersdk提供游族统一设备ID获取接口,给所有游族设备进行统一编号(2)oaid,国内安卓联盟设备ID,oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识,统一由supersdk接口获取 注:字段内格式不限制,但数据中心入库时最多解析一层Json,增删字段前需要与数据中心确认如 {“yz_device_id”: “c434023a520cbc18e4eccd259ea78805”, “oaid”: “d967b13aeedf033a”}