# 数据中心标准生态日志
## 一.概述
数据中心标准生态日志是对游戏内各种玩家角色行为和状态的统一标准记录规范。
主要包含以下日志:
| 日志类型 | 日志名称 | 内容 |
| ------------------ | ------------ | ------------------------------------------------------------ |
| 玩家快照表 | 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_4**至**extra_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_4**至**extra_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_4**至**extra_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_4**至**extra_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_4**至**extra_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_4**至**extra_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_4**至**extra_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_4**至**extra_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_4**至**extra_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_4**至**extra_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_4**至**extra_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_4**至**extra_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_4**至**extra_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"}** |