# 数据中心KPI日志规范

## 1 **概述**

1.1 基础KPI

基础KPI数据主要有：注册，激活，登陆，登出，充值，升级，人数；基础KPI数据必须在PR1前完成。

| 序号 | Action      | 描述           | 文件划分间隔 |
| ---- | ----------- | -------------- | ------------ |
| 1    | RoleReg     | 注册日志       | 按天         |
| 2    | RoleAct     | 激活日志       | 按天         |
| 3    | RoleLogin   | 登录日志       | 按天         |
| 4    | RoleLogout  | 退出日志       | 按天         |
| 5    | PayRecharge | 充值日志       | 按天         |
| 6    | SerPcu      | 服在线人数日志 | 按天         |
| 7    | RoleLvup    | 升级日志       | 按天         |

## 2 **日志规范**

游戏中产生的日志，记录所有变化过程，需要被统一存放，并且可以在一定条件下回放为游戏库的状态。通过对于sdk的重新定义，希望可以实现游戏日志的统一规范，并且要求可满足各种数据统计需求。

1. 日志定义为按｜分割的日志内容，要求每个字段中均不含有｜符号。**对于包含角色名等用户输入字段的内容，一定要屏蔽竖杠、\t、\n这类特殊字符。**

2. 对于不存在的字段使用 **默认值** 标记，**默认值不得与字段类型冲突**。对于需要增加的属性直接加在最后的字段中。

3. 日志接入的优先级，以及字段有特殊情况，请及时与数据中心和负责接入的同事沟通、确认。

4. **KPI日志会用于较多系统的分析和业务，如果某些数据仅是测试用途，如项目精英测试、支付订单调试等，项目正式上线前需要清除的，这些数据中的server_id只可以使用测试服，禁止使用正式服。**

5. 如果研发使用mysql表存储中间日志，对于string类型的字段，建议直接存为text，不要使用varchar，以免字段内容缺失。

### **2.1**  **角色变化类**

包括新用户登录（注册），激活，新增，登录，登出，升级等。

#### **2.1.1** **新用户登录（注册）**

埋点：玩家首次进入区服，生成role_id或者生成账号ID，记为新用户注册。

 

| 字段               | 描述               | 字段类型 | 是否必填 | 说明                                                         |
| ------------------ | ------------------ | -------- | -------- | ------------------------------------------------------------ |
| RoleReg            | 新用户登录（注册） | string   | 是       | 该行为包括两张行为，1、在游戏服生成了账号ID，此时可能还没有角色ID；2、玩家创建角色，生成了角色ID，这时角色还没有角色名称，记为新用户注册，字段固定值RoleReg |
| event_id           | 事件id             | string   |          | 事件id，event_id 字段 ，根据事件类型，角色id，发生时间地点等来产生该 id。例如打倒 boss 获取了3件装备，但是这属于同一事件产生的。记录事件 ID 主要可以用于标示多条日志是同一行为产生的，方便追溯和定位玩家行为。 |
| ver                | sdk版本            | string   |          | 数据中心SDK版本，填默认值1.1                                 |
| op_id              | 运营商 id          | int      | 是       | 运营商 id，使用游族统一分配的运营商ID，不可为空，取不到时默认填0  supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->游族模块，获取opid |
| opgame_id          | 混服组 id          | int      | 是       | 混服组 id，不可为空，默认是server_id的前4位，取不到时默认填0 supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->游族模块，获取opgameid |
| server_id          | 服 id              | string   | 是       | 服 id，游戏服在游族的数字编号，比如2066310028；如使用研发自己的服id，需要运营在开服系统中配置映射关系 |
| createtime         | 发生时间本地化显示 | string   | 是       | 行为发生时间，是行为发生时的当地时间，格式为2015-11-01 12:20:22 |
| client_ip          | 客户端 ip          | string   | 是       | 客户端ip，需要发客户端的IP，不是服务器IP，不需要端口号，比如180.109.231.249 |
| device             | 设备号             | string   | 是       | 设备号，PC、手游需要发送客户端设备ID，统一使用公司标准，页游可以根据需要发送相应值，比如浏览器信息 手游通过supersdk提供接口获取 android：优先imei，取不到用android_id ios:优先idfa，取不到用idfv supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->工具模块，"获取新版设备ID" |
| account            | 平台账号           | string   | 是       | 平台账号，用户登录游戏账号，此账号要和存在游戏库中的一致；如果接入SuperSdk，必须填带游族前缀的账号，如0060015_1596427066632641928636997 |
| role_id            | 角色 id            | string   | 是       | 角色 id(全服唯一)，一个账号在某个服注册的角色编号            |
| role_type          | 角色 类型          | int      |          | 角色类型，标识角色的分类属性，1:正常 2:测试 3:gm/福利 4:其他 |
| ad_id              | 广告用户 id        | int      |          | 广告id，如果是广告导入的用户，需要填写相应的广告id，默认为0  |
| pt_account_regtime | 账号注册时间       | string   |          | 账号注册时间，账号在游戏首次注册时间，为当地时间，格式为2015-11-01 12:20:22 |
| channel_id         | 用户来源 id        | int      |          | cps id，手游的分包ID，默认值为0。cps id在手游分包中是必须要发的数据 |
| multiscreen_type   | 多屏类型           | string   | 是       | web: 网页  wap: wap页面 app: 手机客户端 pc: pc主机 micro：微端，海外游戏如果有使用微端，需要发 |
| spare_one          | 备用字段           | string   |          | Json格式                                                     |
| bundle_id          | 分包id             | string   |          |                                                              |
| model              | 机型               | string   | 是       |                                                              |
| country            | 国家               | string   | 是       | 根据客户端的国家信息来判定玩家的国家，使用国家中文名称来表示。例如，中国为“中国” |
| region             | 地区               | string   |          | 根据客户端的国家信息来判定玩家的地区，使用地区中文名称来表示。例如，东南亚为“东南亚” |
| timezone           | 时区               | string   | 是       | 根据客户端的时区信息来判定玩家的国家。例如，北京时间表示为为 “+8” |
| timestamp          | 时间戳             | int      | 是       | 0时区的时间戳，到秒，如1596771683                            |
| language           | 语种               | string   | 是       | 根据客户端的语言信息来判定玩家的语种，使用语种中文名称来表示。例如，简体中文为“简体中文” |
| yz_device_id       | 游族设备ID         | string   | 是       | 规范游族内移动设备ID数据，使不同数据源内容保持一致，现supersdk提供游族统一设备ID获取接口，给所有游族设备进行统一编号 supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->工具模块，"获取游族ID" |
| oaid               | 国内安卓联盟设备ID | string   |          | oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识，统一由supersdk接口获取 |

#### **2.1.2**   **新用户激活**

埋点：玩家首次进入区服，生成role_id，并且生成角色名称，记为新用户激活。

 

| 字段               | 描述               | 字段类型 | 是否必填 | 说明                                                         |
| ------------------ | ------------------ | -------- | -------- | ------------------------------------------------------------ |
| RoleAct            | 新用户激活         | string   | 是       | 1. 有创角页面的，创角后记为激活； 2 无创角的，第一次加载完游戏主界面后，记为激活；固定值RoleAct |
| event_id           | 事件id             | string   |          | 事件id，event_id 字段 ，根据事件类型，角色id，发生时间地点等来产生该 id。例如打倒 boss 获取了3件装备，但是这属于同一事件产生的。记录事件 ID 主要可以用于标示多条日志是同一行为产生的，方便追溯和定位玩家行为。 |
| ver                | sdk版本            | string   |          | 数据中心SDK版本，填默认值1.1                                 |
| op_id              | 运营商 id          | int      | 是       | 运营商 id，使用游族统一分配的运营商ID，不可为空，取不到时默认填0 supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->游族模块，获取opid |
| opgame_id          | 混服组 id          | int      | 是       | 混服组 id，不可为空，默认是server_id的前4位，取不到时默认填0 supersdk官网 http://docs.supersdk.cn/  网游->java（举例，其他语言）->扩展模块->游族模块，获取opgameid |
| server_id          | 服 id              | string   | 是       | 服 id，游戏服在游族的数字编号，比如2066310028；如使用研发自己的服id，需要运营在开服系统中配置映射关系 |
| createtime         | 发生时间本地化显示 | string   | 是       | 行为发生时间，是行为发生时的当地时间，格式为2015-11-01 12:20:22 |
| client_ip          | 客户端 ip          | string   | 是       | 客户端ip，需要发客户端的IP，不是服务器IP，不需要端口号，比如180.109.231.249 |
| device             | 设备号             | string   | 是       | 设备号，PC、手游需要发送客户端设备ID，统一使用公司标准，页游可以根据需要发送相应值，比如浏览器信息 手游通过supersdk提供接口获取 android：优先imei，取不到用android_id ios:优先idfa，取不到用idfv supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->工具模块，"获取新版设备ID" |
| account            | 平台账号           | string   | 是       | 平台账号，用户登录游戏账号，此账号要和存在游戏库中的一致 如果接入SuperSdk，必须填带游族前缀的账号，如0060015_1596427066632641928636997 |
| role_id            | 角色 id            | string   | 是       | 必填，角色 id(全服唯一)，一个账号在某个服注册的角色编号      |
| role_type          | 角色 类型          | int      |          | 角色类型，标识角色的分类属性，1:正常 2:测试 3:gm/福利 4:其他 |
| role_name          | 角色名             | string   | 是       | 角色名，角色的游戏名称，需要屏蔽换行、竖杠、\t等特殊字符     |
| role_career        | 角色职业           | int      |          | 角色职业，使用数字表示，比如魔法天堂，0 默认，1 代表战士，2代表法师等，数字可以自定义，但需要同步到数据中心 |
| role_level         | 角色等级           | int      |          | 角色等级，角色的当前等级，是数字表示，比如65                 |
| role_vip           | 角色vip等级        | int      |          | 角色vip等级，一般是充值获得的等级，数字表示，比如10          |
| role_regtime       | 角色注册时间       | string   | 是       | 角色注册时间，在游戏服生成角色ID时的当地时间，尤其是像欧洲、北美这种海外时区的数据，必须要发当地时间，格式为2015-11-01 12:20:22 |
| ad_id              | 广告用户 id        | int      |          | 广告id，如果是广告导入的用户，需要填写相应的广告id，默认为0  |
| pt_account_regtime | 账号注册时间       | string   | 是       | 账号注册时间，账号在游戏首次注册时间，为当地时间，格式为2015-11-01 12:20:22 |
| channel_id         | 用户来源 id        | int      |          | cps id，手游的分包ID，默认值为0。cps id在手游分包中是必须要发的数据 |
| multiscreen_type   | 多屏类型           | string   | 是       | web: 网页 wap: wap页面 app: 手机客户端 pc: pc主机  micro：微端，海外游戏如果有使用微端，需要发 |
| spare_one          | 备用字段           | string   |          | Json格式                                                     |
| bundle_id          | 分包id             | string   |          |                                                              |
| model              | 机型               | string   | 是       |                                                              |
| country            | 国家               | string   | 是       | 根据客户端的国家信息来判定玩家的国家，使用国家中文名称来表示。例如，中国为“中国” |
| region             | 地区               | string   |          | 根据客户端的国家信息来判定玩家的地区，使用地区中文名称来表示。例如，东南亚为“东南亚” |
| timezone           | 时区               | string   | 是       | 根据客户端的时区信息来判定玩家的国家。例如，北京时间表示为为 “+8” |
| timestamp          | 时间戳             | int      | 是       | 0时区的时间戳，到秒，如1596771683                            |
| language           | 语种               | string   | 是       | 根据客户端的语言信息来判定玩家的语种，使用语种中文名称来表示。例如，简体中文为“简体中文” |
| yz_device_id       | 游族设备ID         | string   | 是       | 规范游族内移动设备ID数据，使不同数据源内容保持一致，现supersdk提供游族统一设备ID获取接口，给所有游族设备进行统一编号 supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->工具模块，"获取游族ID" |
| oaid               | 国内安卓联盟设备ID | string   |          | oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识，统一由supersdk接口获取 |

#### **2.1.3**   **角色登录**

埋点：玩家登录区服进入游戏主界面，记为角色登录。用户注册时不需要发登录日志，只有已激活用户需要发送登录日志，包括新激活用户、老用户。

对于跨天在线的情况，需要研发在每天开始打一条login日志

 

| 字段             | 描述               | 字段类型 | 是否必填 | 说明                                                         |
| ---------------- | ------------------ | -------- | -------- | ------------------------------------------------------------ |
| RoleLogin        | 用户登录           | string   | 是       | 角色登录行为，固定值RoleLogin                                |
| event_id         | 事件id             | string   |          | 事件id，event_id 字段 ，根据事件类型，角色id，发生时间地点等来产生该 id。例如打倒 boss 获取了3件装备，但是这属于同一事件产生的。记录事件 ID 主要可以用于标示多条日志是同一行为产生的，方便追溯和定位玩家行为。 |
| ver              | sdk版本            | string   |          | 数据中心SDK版本，填默认值1.1                                 |
| op_id            | 运营商 id          | int      | 是       | 运营商 id，使用游族统一分配的运营商ID，不可为空，取不到时默认填0 supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->游族模块，获取opid |
| opgame_id        | 混服组 id          | int      | 是       | 混服组 id，不可为空，默认是server_id的前4位，取不到时默认填0 supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->游族模块，获取opgameid |
| server_id        | 服 id              | string   | 是       | 服 id，游戏服在游族的数字编号，比如2066310028；如使用研发自己的服id，需要运营在开服系统中配置映射关系 |
| createtime       | 发生时间本地化显示 | string   | 是       | 发生时间，是行为发生时的当地时间，格式为2015-11-01 12:20:22  |
| client_ip        | 客户端 ip          | string   | 是       | 客户端ip，需要发客户端的IP，不是服务器IP，不需要端口号，比如180.109.231.249。 |
| device           | 设备号             | string   | 是       | 设备号，PC、手游需要发送客户端设备ID，统一使用公司标准，页游可以根据需要发送相应值，比如浏览器信息 手游通过supersdk提供接口获取 android：优先imei，取不到用android_id ios:优先idfa，取不到用idfv supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->工具模块，"获取新版设备ID" |
| account          | 平台账号           | string   | 是       | 平台账号，用户登录游戏账号，此账号要和存在游戏库中的一致；如果接入SuperSdk，必须填带游族前缀的账号，如0060015_1596427066632641928636997 |
| role_id          | 角色 id            | string   | 是       | 角色 id(全服唯一)，一个账号在某个服注册的角色编号            |
| role_type        | 角色 类型          | int      |          | 角色类型，标识角色的分类属性，1:正常 2:测试 3:gm/福利 4:其他 |
| role_name        | 角色名             | string   | 是       | 角色名，角色的游戏名称，需要屏蔽换行、竖杠、\t等特殊字符     |
| role_career      | 角色职业           | int      |          | 角色职业，使用数字表示，比如魔法天堂，0 默认，1 代表战士，2代表法师等，数字可以自定义，但需要同步到数据中心 |
| role_level       | 角色等级           | int      | 是       | 角色等级，角色的当前等级，是数字表示，比如65，如果没有默认填 0 |
| role_vip         | 角色vip等级        | int      | 是       | 角色vip等级，一般是充值获得的等级，数字表示，比如10          |
| role_unionid     | 角色工会id         | string   | 是       | 成员团体的ID，团体可能是公会，也可能是部落、战队等           |
| role_regtime     | 角色注册时间       | string   | 是       | 角色注册时间，在游戏服生成角色ID时的当地时间，尤其是像欧洲、北美这种海外时区的数据，必须要发当地时间，格式为2015-11-01 12:20:22 |
| role_paid        | 是否付费用户       | int      |          | 如果该角色从未付过费，发默认值0；如果付过费，发送1           |
| role_exp         | 角色经验           | int      |          | 经验，角色当前的经验值，数字，默认值0                        |
| role_energy      | 角色体力           | int      |          | 体力，玩法参与时消耗的资源，发送剩余体力数，默认值0          |
| diamond          | 钻石数量           | int      | 是       | 钻石存量，用户充值获得的钻石(也有可能叫黄金、元宝之类的)，非赠送，默认值0 |
| blackdiamond     | 赠送钻石数量       | int      |          | 假钻存量，赠送的钻石或参与玩法获得的钻石，默认值0            |
| money            | 金币               | int      |          | 金币存量，游戏内的基础货币，比如少三中的银币，默认值0        |
| channel_id       | 用户来源 id        | int      |          | cps id，手游的分包ID，默认值为0。cps id在手游分包中是必须要发的数据 |
| multiscreen_type | 多屏类型           | string   | 是       | web: 网页 wap: wap页面 app: 手机客户端 pc: pc主机 micro：微端，海外游戏如果有使用微端，需要发 |
| spare_one        | 备用字段           | string   |          | Json格式                                                     |
| bundle_id        | 分包id             | string   |          |                                                              |
| model            | 机型               | string   | 是       |                                                              |
| country          | 国家               | string   | 是       | 根据客户端的国家信息来判定玩家的国家，使用国家中文名称来表示。例如，中国为“中国” |
| region           | 地区               | string   |          | 根据客户端的国家信息来判定玩家的地区，使用地区中文名称来表示。例如，东南亚为“东南亚” |
| timezone         | 时区               | string   | 是       | 根据客户端的时区信息来判定玩家的国家。例如，北京时间表示为为 “+8” |
| timestamp        | 时间戳             | int      | 是       | 0时区的时间戳，到秒，如1596771683                            |
| language         | 语种               | string   | 是       | 根据客户端的语言信息来判定玩家的语种，使用语种中文名称来表示。例如，简体中文为“简体中文” |
| yz_device_id     | 游族设备ID         | string   | 是       | 规范游族内移动设备ID数据，使不同数据源内容保持一致，现supersdk提供游族统一设备ID获取接口，给所有游族设备进行统一编号 supersdk官网 http://docs.supersdk.cn/  网游->java（举例，其他语言）->扩展模块->工具模块，"获取游族ID" |
| oaid             | 国内安卓联盟设备ID | string   |          | oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识，统一由supersdk接口获取 |

#### **2.1.4**   **角色登出**

埋点：玩家退出游戏时发送日志，记为角色登出

 

| 字段             | 描述               | 字段类型 | 是否必填 | 说明                                                         |
| ---------------- | ------------------ | -------- | -------- | ------------------------------------------------------------ |
| RoleLogout       | 用户登出           | string   | 是       | 角色退出行为，固定值RoleLogout                               |
| event_id         | 事件id             | string   |          | 事件id，event_id 字段 ，根据事件类型，角色id，发生时间地点等来产生该 id。例如打倒 boss 获取了3件装备，但是这属于同一事件产生的。记录事件 ID 主要可以用于标示多条日志是同一行为产生的，方便追溯和定位玩家行为。 |
| ver              | sdk版本            | string   |          | 数据中心SDK版本，填默认值1.1                                 |
| op_id            | 运营商 id          | int      | 是       | 运营商 id，使用游族统一分配的运营商ID，不可为空，取不到时默认填0 supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->游族模块，获取opid |
| opgame_id        | 混服组 id          | int      | 是       | 混服组 id，不可为空，默认是server_id的前4位，取不到时默认填0 supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->游族模块，获取opgameid |
| server_id        | 服 id              | string   | 是       | 服 id，游戏服在游族的数字编号，比如2066310028；如使用研发自己的服id，需要运营在开服系统中配置映射关系 |
| createtime       | 发生时间本地化显示 | string   | 是       | 行为发生时间，是行为发生时的当地时间，格式为2015-11-01 12:20:22 |
| logintime        | 登录时间           | int      | 是       | 角色登录时的当地时间，格式为2015-11-01 12:20:22              |
| onlinetime       | 在线时间, 单位秒   | int      | 是       | 本次登录的在线持续时间                                       |
| client_ip        | 客户端 ip          | string   | 是       | 客户端ip，需要发客户端的IP，不是服务器IP，不需要端口号，比如180.109.231.249。 |
| device           | 设备号             | string   | 是       | 设备号，PC、手游需要发送客户端设备ID，统一使用公司标准，页游可以根据需要发送相应值，比如浏览器信息 手游通过supersdk提供接口获取  android：优先imei，取不到用android_id ios:优先idfa，取不到用idfv supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->工具模块，"获取新版设备ID" |
| account          | 平台账号           | string   | 是       | 平台账号，用户登录游戏账号，此账号要和存在游戏库中的一致；如果接入SuperSdk，必须填带游族前缀的账号，如0060015_1596427066632641928636997 |
| role_id          | 角色 id            | string   | 是       | 角色 id(全服唯一)，一个账号在某个服注册的角色编号            |
| role_type        | 角色 类型          | int      |          | 角色类型，标识角色的分类属性，1:正常 2:测试 3:gm/福利 4:其他 |
| role_name        | 角色名             | string   | 是       | 角色名，角色的游戏名称，需要屏蔽换行、竖杠、\t等特殊字符     |
| role_career      | 角色职业           | int      |          | 角色职业，使用数字表示，比如魔法天堂，0 默认，1 代表战士，2代表法师等，数字可以自定义，但需要同步到数据中心 |
| role_level       | 角色等级           | int      | 是       | 角色等级，角色的当前等级，是数字表示，比如65                 |
| role_vip         | 角色vip等级        | int      | 是       | 角色vip等级，一般是充值获得的等级，数字表示，比如10          |
| role_unionid     | 角色工会id         | string   | 是       | 成员团体的ID，团体可能是公会，也可能是部落、战队等           |
| role_regtime     | 角色注册时间       | string   | 是       | 角色注册时间，在游戏服生成角色ID时的当地时间，尤其是像欧洲、北美这种海外时区的数据，必须要发当地时间，格式为2015-11-01 12:20:22 |
| role_paid        | 是否付费用户       | int      |          | 如果该角色从未付过费，发送值0；如果付过费，发送值1           |
| role_exp         | 角色经验           | int      |          | 经验，角色当前的经验值，数字，默认值0                        |
| role_energy      | 角色体力           | int      |          | 体力，玩法参与时消耗的资源，发送剩余体力数，默认值0          |
| reason           | 下线原因           | int      |          | 1: 正常登出 2: gm踢下线 3: 挤下线（同账号多处登录）4: 其他   |
| diamond          | 钻石数量           | int      | 是       | 钻石存量，用户充值获得的钻石(也有可能叫黄金、元宝之类的)，非赠送，默认值0 |
| blackdiamond     | 赠送钻石数量       | int      |          | 假钻存量，赠送的钻石或参与玩法获得的钻石，默认值0            |
| money            | 金币               | int      |          | 金币存量，游戏内的基础货币，比如少三中的银币，默认值0        |
| channel_id       | 用户来源 id        | int      |          | cps id，手游的分包ID，默认值为0。cps id在手游分包中是必须要发的数据 |
| multiscreen_type | 多屏类型           | string   |          | web: 网页 wap: wap页面 app: 手机客户端 pc: pc主机 micro：微端，海外游戏如果有使用微端，需要发 |
| spare_one        | 备用字段           | string   |          | Json格式 如战力{"role_power":1000}                           |
| bundle_id        | 分包id             | string   |          |                                                              |
| model            | 机型               | string   | 是       |                                                              |
| country          | 国家               | string   | 是       | 根据客户端的国家信息来判定玩家的国家，使用国家中文名称来表示。例如，中国为“中国” |
| region           | 地区               | string   |          | 根据客户端的国家信息来判定玩家的地区，使用地区中文名称来表示。例如，东南亚为“东南亚” |
| timezone         | 时区               | string   | 是       | 根据客户端的时区信息来判定玩家的国家。例如，北京时间表示为为 “+8” |
| timestamp        | 时间戳             | int      | 是       | 0时区的时间戳，到秒，如1596771683                            |
| language         | 语种               | string   | 是       | 根据客户端的语言信息来判定玩家的语种，使用语种中文名称来表示。例如，简体中文为“简体中文” |
| yz_device_id     | 游族设备ID         | string   | 是       | 规范游族内移动设备ID数据，使不同数据源内容保持一致，现supersdk提供游族统一设备ID获取接口，给所有游族设备进行统一编号 supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->工具模块，"获取游族ID" |
| oaid             | 国内安卓联盟设备ID | string   |          | oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识，统一由supersdk接口获取 |

#### **2.1.5**   **角色升级**

埋点：玩家角色有升级行为发生时，需要发送该日志，记为角色升级，这里的等级是指游戏中基础等级维度，非VIP等级

同时判断有效用户，根据每个游戏给定的有效用户等级判断。

 

| 字段              | 描述               | 字段类型 | 是否必填 | 说明                                                         |
| ----------------- | ------------------ | -------- | -------- | ------------------------------------------------------------ |
| RoleLvup          | 用户升级           | string   | 是       | 角色升级日志，固定值RoleLvup                                 |
| event_id          | 事件id             | string   |          | 事件id，event_id 字段 ，根据事件类型，角色id，发生时间地点等来产生该 id。例如打倒 boss 获取了3件装备，但是这属于同一事件产生的。记录事件 ID 主要可以用于标示多条日志是同一行为产生的，方便追溯和定位玩家行为。 |
| ver               | sdk版本            | string   |          | 数据中心SDK版本，填默认值1.1                                 |
| op_id             | 运营商 id          | int      | 是       | 运营商 id，使用游族统一分配的运营商ID，不可为空，取不到时默认填0 supersdk官网  http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->游族模块，获取opid |
| opgame_id         | 混服组 id          | int      | 是       | 混服组 id，不可为空，默认是server_id的前4位，取不到时默认填0 supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->游族模块，获取opgameid |
| server_id         | 服 id              | string   | 是       | 服 id，游戏服在游族的数字编号，比如2066310028；如使用研发自己的服id，需要运营在开服系统中配置映射关系 |
| createtime        | 发生时间本地化显示 | string   | 是       | 行为发生时间，是行为发生时的当地时间，格式为2015-11-01 12:20:22 |
| client_ip         | 客户端 ip          | string   | 是       | 客户端ip，需要发客户端的IP，不是服务器IP，不需要端口号，比如180.109.231.249。 |
| device            | 设备号             | string   | 是       | 设备号，PC、手游需要发送客户端设备ID，统一使用公司标准，页游可以根据需要发送相应值，比如浏览器信息 手游通过supersdk提供接口获取 android：优先imei，取不到用android_id ios:优先idfa，取不到用idfv supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->工具模块，"获取新版设备ID" |
| account           | 平台账号           | string   | 是       | 平台账号，用户登录游戏账号，此账号要和存在游戏库中的一致；如果接入SuperSdk，必须填带游族前缀的账号，如0060015_1596427066632641928636997 |
| role_id           | 角色 id            | string   | 是       | 角色 id(全服唯一)，一个账号在某个服注册的角色编号            |
| role_type         | 角色 类型          | int      |          | 角色类型，标识角色的分类属性，1:正常 2:测试 3:gm/福利 4:其他 |
| role_name         | 角色名             | string   | 是       | 角色名，角色的游戏名称，需要屏蔽换行、竖杠、\t等特殊字符     |
| role_career       | 角色职业           | int      |          | 角色职业，使用数字表示，比如魔法天堂，0 默认，1 代表战士，2代表法师等，数字可以自定义，但需要同步到数据中心 |
| role_level        | 角色等级           | int      | 是       | 角色升级后的等级，与role_level_before相对应。角色的当前等级，是数字表示，比如65，大于role_level_before值 |
| role_level_before | 角色等级before     | int      |          | 角色升级前的等级，与role_level相对应。角色的当前等级，是数字表示，比如64，小于role_level值 |
| role_vip          | 角色vip等级        | int      | 是       | 角色vip等级，一般是充值获得的等级，数字表示，比如10          |
| role_unionid      | 角色工会id         | string   | 是       | 成员团体的ID，团体可能是公会，也可能是部落、战队等           |
| role_regtime      | 角色注册时间       | string   | 是       | 角色注册时间，在游戏服生成角色ID时的当地时间，尤其是像欧洲、北美这种海外时区的数据，必须要发当地时间，格式为2015-11-01 12:20:22 |
| role_paid         | 是否付费用户       | int      |          | 如果该角色从未付过费，发默认值0；如果付过费，发送1           |
| role_exp          | 角色经验           | int      |          | 经验，角色当前的经验值，数字，默认值0                        |
| role_energy       | 角色体力           | int      |          | 体力，玩法参与时消耗的资源，发送剩余体力数，默认值0          |
| diamond           | 钻石数量           | int      | 是       | 钻石存量，用户充值获得的钻石(也有可能叫黄金、元宝之类的)，非赠送，默认值0 |
| blackdiamond      | 赠送钻石数量       | int      |          | 假钻存量，赠送的钻石或参与玩法获得的钻石，默认值0            |
| money             | 金币               | int      |          | 金币存量，游戏内的基础货币，比如少三中的银币，默认值0        |
| channel_id        | 用户来源 id        | int      |          | cps id，手游的分包ID，默认值为0。cps id在手游分包中是必须要发的数据 |
| multiscreen_type  | 多屏类型           | string   |          | web: 网页 wap: wap页面 app: 手机客户端 pc: pc主机 micro：微端，海外游戏如果有使用微端，需要发 |
| spare_one         | 备用字段           | string   |          | Json格式                                                     |
| bundle_id         | 分包id             | string   |          |                                                              |
| model             | 机型               | string   | 是       |                                                              |
| country           | 国家               | string   | 是       | 根据客户端的国家信息来判定玩家的国家，使用国家中文名称来表示。例如，中国为“中国” |
| region            | 地区               | string   |          | 根据客户端的国家信息来判定玩家的地区，使用地区中文名称来表示。例如，东南亚为“东南亚” |
| timezone          | 时区               | string   | 是       | 根据客户端的时区信息来判定玩家的国家。例如，北京时间表示为为 “+8” |
| timestamp         | 时间戳             | int      | 是       | 0时区的时间戳，到秒，如1596771683                            |
| language          | 语种               | string   | 是       | 根据客户端的语言信息来判定玩家的语种，使用语种中文名称来表示。例如，简体中文为“简体中文” |
| yz_device_id      | 游族设备ID         | string   | 是       | 规范游族内移动设备ID数据，使不同数据源内容保持一致，现supersdk提供游族统一设备ID获取接口，给所有游族设备进行统一编号 supersdk官网 http://docs.supersdk.cn/  网游->java（举例，其他语言）->扩展模块->工具模块，"获取游族ID" |
| oaid              | 国内安卓联盟设备ID | string   |          | oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识，统一由supersdk接口获取 |

### **2.2**  **充值支付消耗类**

包括游戏货币购买，月卡购买，以及其他收费道具，赠送货币，消耗货币等。统计钻石流水。

补充字段，可以直接加在最后，比如彩钻。

维度：

 

| diamond       | 钻石，充值获得的货币   |
| ------------- | ---------------------- |
| black_diamond | 假钻，游戏中赠送的钻石 |
| money         | 金币，游戏内基础货币   |

#### **2.2.1**   **充值付费**

埋点：玩家角色有付费行为发生时，需要发送该日志，记为角色付费，充值赠送的钻石需要单独发送 PayGift日志

 

| 字段             | 描述               | 字段类型 | 是否必填 | 说明                                                         |
| ---------------- | ------------------ | -------- | -------- | ------------------------------------------------------------ |
| PayRecharge      | 充值付费           | string   | 是       | 付费的操作都需要记录，固定值PayRecharge                      |
| event_id         | 事件id             | string   |          | 事件id，event_id 字段 ，根据事件类型，角色id，发生时间地点等来产生该 id。例如打倒 boss 获取了3件装备，但是这属于同一事件产生的。记录事件 ID 主要可以用于标示多条日志是同一行为产生的，方便追溯和定位玩家行为。 |
| ver              | sdk版本            | string   |          | Sdk版本，默认值在SDK代码中提供                               |
| op_id            | 运营商 id          | int      | 是       | 运营商 id，使用游族统一分配的运营商ID，不可为空，取不到时默认填0 supersdk官网  http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->游族模块，获取opid |
| opgame_id        | 混服组 id          | int      | 是       | 混服组 id，不可为空，默认是server_id的前4位，取不到时默认填0 supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->游族模块，获取opgameid |
| server_id        | 服 id              | int      | 是       | 服 id，游戏服在游族的数字编号，比如2066310028；如使用研发自己的服id，需要运营在开服系统中配置映射关系 |
| createtime       | 发生时间本地化显示 | string   | 是       | 发生时间，是行为发生时的当地时间，格式为2015-11-01 12:20:22  |
| account          | 平台账号           | string   | 是       | 平台账号，用户登录游戏账号，此账号要和存在游戏库中的一致；如果接入SuperSdk，必须填带游族前缀的账号，如0060015_1596427066632641928636997 |
| role_id          | 角色 id            |          | 是       | 角色 id(全服唯一)，一个账号在某个服注册的角色编号            |
| role_type        | 角色 类型          | int      |          | 角色类型，标识角色的分类属性，1:正常 2:测试 3:gm/福利 4:其他 |
| role_name        | 角色名             | string   | 是       | 角色名，角色的游戏名称，需要屏蔽换行、竖杠、\t等特殊字符     |
| role_career      | 角色职业           | int      |          | 角色职业，使用数字表示，比如魔法天堂，0 默认，1 代表战士，2代表法师等，数字可以自定义，但需要同步到数据中心 |
| role_level       | 角色等级           | int      | 是       | 角色等级，角色的当前等级，是数字表示，比如65                 |
| role_vip         | 角色vip等级        | int      | 否       | 角色vip等级，一般是充值获得的等级，数字表示，比如10          |
| role_regtime     | 角色注册时间       | string   | 是       | 角色注册时间，在游戏服生成角色ID时的当地时间，尤其是像欧洲、北美这种海外时区的数据，必须要发当地时间，格式为2015-11-01 12:20:22 |
| role_paid        | 是否付费用户       | int      |          | 如果该角色从未付过费，发默认值0；如果付过费，发送1           |
| pay_type         | 充值类型           | int      |          | 根据购买的道具类型，1:购买钻石 2:购买道具比如月卡 3:其他     |
| pay_orderid      | 充值订单           | string   | 是       | 订单号，需要与游族平台的一致                                 |
| pay_discount     | 充值折扣           | float    |          | 活动促销时的打折信息，没有打折默认发1，如果打九折则发送0.9   |
| pay_way          | 充值渠道           | int      |          | 支付的方式，-1：测试订单，0:默认，1:游族U币,2:支付宝,3:微信,4:网银,5：其他 |
| pay_itemid       | 购买道具id         | string   | 是       | 购买的道具编号，比如月卡、首充卡等                           |
| pay_money        | 购买的金额         | float    | 是       | 购买道具实际支付的金额                                       |
| pay_currency     | 货币类型           | string   | 是       | 支付的货币类型，比如CNY、USD、EUR等 单个项目使用的币种必须统一 |
| pay_diamond      | 钻石增加购买数     | int      |          | 实际购买的真钻数，对于充值赠送的部分应额外发送赠送日志PayGift |
| diamond          | 钻石数量           | int      | 是       | 钻石存量，用户充值获得的钻石(也有可能叫黄金、元宝之类的)，非赠送，默认值0 |
| blackdiamond     | 赠送钻石数量       | int      |          | 假钻存量，赠送的钻石或参与玩法获得的钻石，默认值0            |
| money            | 金币               | int      |          | 金币存量，游戏内的基础货币，比如少三中的银币，默认值0        |
| channel_id       | 用户来源 id        | int      |          | cps id，手游的分包ID，默认值为0。cps id在手游分包中是必须要发的数据 |
| multiscreen_type | 多屏类型           | string   |          | web:网页                                                     |
| spare_one        | 备用字段           | string   |          | Json格式                                                     |
| device           | 设备               | string   | 是       | 设备号，PC、手游需要发送客户端设备ID，统一使用公司标准，页游可以根据需要发送相应值，比如浏览器信息 手游通过supersdk提供接口获取 android：优先imei，取不到用android_id ios:优先idfa，取不到用idfv supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->工具模块，"获取新版设备ID" |
| bundle_id        | 分包id             | string   |          |                                                              |
| model            | 机型               | string   |          |                                                              |
| country          | 国家               | string   | 是       | 根据客户端的国家信息来判定玩家的国家，使用国家中文名称来表示。例如，中国为“中国” |
| region           | 地区               | string   |          | 根据客户端的国家信息来判定玩家的地区，使用地区中文名称来表示。例如，东南亚为“东南亚” |
| timezone         | 时区               | string   | 是       | 根据客户端的时区信息来判定玩家的国家。例如，北京时间表示为为 “+8” |
| timestamp        | 时间戳             | int      | 是       | 0时区的时间戳，到秒，如1596771683                            |
| language         | 语种               | string   | 是       | 根据客户端的语言信息来判定玩家的语种，使用语种中文名称来表示。例如，简体中文为“简体中文” |
| yz_device_id     | 游族设备ID         | string   | 是       | 规范游族内移动设备ID数据，使不同数据源内容保持一致，现supersdk提供游族统一设备ID获取接口，给所有游族设备进行统一编号 supersdk官网  http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->工具模块，"获取游族ID" |
| oaid             | 国内安卓联盟设备ID | string   |          | oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识，统一由supersdk接口获取 |
| client_ip        | 客户端 ip          | string   | 是       | 客户端ip，需要发客户端的IP，不是服务器IP，不需要端口号，比如180.109.231.249。 |

#### **2.2.2**   **游戏内货币获取**

埋点：除了付费行为下获得真实钻石，其他方式获得的钻石都需要发送该日志，包括充值赠送的钻石，记为货币获取，其他获取的方式可能还包括玩法获取、系统赠送、玩家交易等等。

**非必接项，有分析需要再单独接入**

 

| 字段              | 描述               | 字段类型 | 是否必填 | 说明                                                         |
| ----------------- | ------------------ | -------- | -------- | ------------------------------------------------------------ |
| PayGift           | 非充值获取         | string   | 是       | 游戏内非充值获取钻石，比如任务完成、充值赠送、系统赠送等，只包含钻石部分，固定值PayGift |
| event_id          | 事件id             | string   |          | 事件id，event_id 字段 ，根据事件类型，角色id，发生时间地点等来产生该 id。例如打倒 boss 获取了3件装备，但是这属于同一事件产生的。记录事件 ID 主要可以用于标示多条日志是同一行为产生的，方便追溯和定位玩家行为。 |
| ver               | Sdk版本            | string   |          | 数据中心SDK版本，填默认值1.1                                 |
| op_id             | 运营商 id          | int      | 是       | 运营商 id，使用游族统一分配的运营商ID，不可为空，取不到时默认填0  supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->游族模块，获取opid |
| opgame_id         | 混服组 id          | int      | 是       | 混服组 id，不可为空，默认是server_id的前4位，取不到时默认填0 supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->游族模块，获取opgameid |
| server_id         | 服 id              | string   | 是       | 服 id，游戏服在游族的数字编号，比如2066310028；如使用研发自己的服id，需要运营在开服系统中配置映射关系 |
| createtime        | 发生时间本地化显示 | string   | 是       | 发生时间，是行为发生时的当地时间，格式为2015-11-01 12:20:22  |
| account           | 平台账号           | string   | 是       | 平台账号，用户登录游戏账号，此账号要和存在游戏库中的一致；如果接入SuperSdk，必须填带游族前缀的账号，如0060015_1596427066632641928636997 |
| role_id           | 角色 id            | string   | 是       | 角色 id(全服唯一)，一个账号在某个服注册的角色编号            |
| role_type         | 角色 类型          | int      |          | 角色类型，标识角色的分类属性，1:正常 2:测试 3:gm/福利 4:其他 |
| role_name         | 角色名             | string   | 是       | 角色名，角色的游戏名称，需要屏蔽换行、竖杠、\t等特殊字符     |
| role_career       | 角色职业           | int      |          | 角色职业，使用数字表示，比如魔法天堂，0 默认，1 代表战士，2代表法师等，数字可以自定义，但需要同步到数据中心 |
| role_level        | 角色等级           | int      |          | 角色等级，角色的当前等级，是数字表示，比如65                 |
| role_vip          | 角色vip等级        | int      |          | 角色vip等级，一般是充值获得的等级，数字表示，比如10          |
| role_regtime      | 角色注册时间       | string   | 是       | 角色注册时间，在游戏服生成角色ID时的当地时间，尤其是像欧洲、北美这种海外时区的数据，必须要发当地时间，格式为2015-11-01 12:20:22 |
| role_paid         | 是否付费用户       | int      |          | 如果该角色从未付过费，发默认值0；如果付过费，发送1           |
| gift_type         | 赠送类型           | int      |          | 1:玩法任务奖励 2:充值赠送（月卡） 3:玩家间交易 (手续费扣除需要增加一条扣除日志) 4:系统加 5:其他 |
| gift_diamond      | 钻石赠送数         | int      | 是       | 本次行为获得的真钻数，默认值0                                |
| gift_blackdiamond | black钻石赠送数    | int      |          | 本次行为获得的假钻数，默认值0                                |
| b_type            | 行为类型           | string   |          | 该行为的具体分类信息，由游戏方自己划分，如果没有，默认值为空，比如世界BOOS初级、世界BOSS高级同属于世界BOSS |
| b_id              | 行为id             | string   | 是       | 游戏对该行为的ID编号，比如参加天角竞技场的行为ID，如果没有，默认值为空 |
| other_role_id     | 玩家交易的另外一方 | string   |          | 当该行为是玩家相互交易时，发送交易玩家的角色ID               |
| diamond           | 钻石数量           | int      |          | 钻石存量，用户充值获得的钻石(也有可能叫黄金、元宝之类的)，非赠送，默认值0 |
| blackdiamond      | 赠送钻石数量       | int      |          | 假钻存量，赠送的钻石或参与玩法获得的钻石，默认值0            |
| money             | 金币               | int      |          | 金币存量，游戏内的基础货币，比如少三中的银币，默认值0        |
| channel_id        | 用户来源 id        | int      |          | cps id，手游的分包ID，默认值为0。cps id在手游分包中是必须要发的数据 |
| multiscreen_type  | 多屏类型           | string   |          | web:网页                                                     |
| spare_one         | 备用字段           | string   |          | Json格式                                                     |
| device            | 设备               | string   | 是       | 设备号，PC、手游需要发送客户端设备ID，统一使用公司标准，页游可以根据需要发送相应值，比如浏览器信息 手游通过supersdk提供接口获取  android：优先imei，取不到用android_id ios:优先idfa，取不到用idfv supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->工具模块，"获取新版设备ID" |
| bundle_id         | 分包id             | string   |          |                                                              |
| model             | 机型               | string   | 是       |                                                              |
| country           | 国家               | string   | 是       | 根据客户端的国家信息来判定玩家的国家，使用国家中文名称来表示。例如，中国为“中国” |
| region            | 地区               | string   |          | 根据客户端的国家信息来判定玩家的地区，使用地区中文名称来表示。例如，东南亚为“东南亚” |
| timezone          | 时区               | string   | 是       | 根据客户端的时区信息来判定玩家的国家。例如，北京时间表示为为 “+8” |
| timestamp         | 时间戳             | int      | 是       | 0时区的时间戳，到秒，如1596771683                            |
| language          | 语种               | string   | 是       | 根据客户端的语言信息来判定玩家的语种，使用语种中文名称来表示。例如，简体中文为“简体中文” |
| yz_device_id      | 游族设备ID         | string   | 是       | 规范游族内移动设备ID数据，使不同数据源内容保持一致，现supersdk提供游族统一设备ID获取接口，给所有游族设备进行统一编号 supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->工具模块，"获取游族ID" |
| oaid              | 国内安卓联盟设备ID | string   |          | oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识，统一由supersdk接口获取 |

#### **2.2.3**   **游戏内货币消耗**

埋点：只要有消耗到钻石的行为，都需要发送消耗日志，记为货币消耗，比如购买体力、购买道具等等

**非必接项，有分析需要再单独接入**

 

| 字段                   | 描述               | 字段类型 | 是否必填 | 说明                                                         |
| ---------------------- | ------------------ | -------- | -------- | ------------------------------------------------------------ |
| PayConsume             | 消耗               | string   | 是       | 游戏内消耗，例如使用钻石购买道具，只包含钻石部分，固定值PayConsume |
| event_id               | 事件id             | string   |          | 事件id，event_id 字段 ，根据事件类型，角色id，发生时间地点等来产生该 id。例如打倒 boss 获取了3件装备，但是这属于同一事件产生的。记录事件 ID 主要可以用于标示多条日志是同一行为产生的，方便追溯和定位玩家行为。 |
| ver                    | sdk版本            | string   |          | Sdk版本，默认值在SDK代码中提供                               |
| op_id                  | 运营商 id          | int      | 是       | 运营商 id，使用游族统一分配的运营商ID，不可为空，取不到时默认填0 supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->游族模块，获取opid |
| opgame_id              | 混服组 id          | int      | 是       | 混服组 id，不可为空，默认是server_id的前4位，取不到时默认填0 supersdk官网 http://docs.supersdk.cn/  网游->java（举例，其他语言）->扩展模块->游族模块，获取opgameid |
| server_id              | 服 id              | string   | 是       | 服 id，游戏服在游族的数字编号，比如2066310028；如使用研发自己的服id，需要运营在开服系统中配置映射关系 |
| createtime             | 发生时间本地化显示 | string   | 是       | 发生时间，是行为发生时的当地时间，格式为2015-11-01 12:20:22  |
| account                | 平台账号           | string   | 是       | 平台账号，用户登录游戏账号，此账号要和存在游戏库中的一致；如果接入SuperSdk，必须填带游族前缀的账号，如0060015_1596427066632641928636997 |
| role_id                | 角色 id            | string   | 是       | 角色 id(全服唯一)，一个账号在某个服注册的角色编号            |
| role_type              | 角色 类型          | int      |          | 角色类型，标识角色的分类属性，1:正常 2:测试 3:gm/福利 4:其他 |
| role_name              | 角色名             | string   |          | 角色名，角色的游戏名称，需要屏蔽换行、竖杠、\t等特殊字符     |
| role_career            | 角色职业           | int      |          | 角色职业，使用数字表示，比如魔法天堂，0 默认，1 代表战士，2代表法师等，数字可以自定义，但需要同步到数据中心 |
| role_level             | 角色等级           | int      |          | 角色等级，角色的当前等级，是数字表示，比如65                 |
| role_vip               | 角色vip等级        | int      |          | 角色vip等级，一般是充值获得的等级，数字表示，比如10          |
| role_regtime           | 角色注册时间       | string   | 是       | 角色注册时间，在游戏服生成角色ID时的当地时间，尤其是像欧洲、北美这种海外时区的数据，必须要发当地时间，格式为2015-11-01 12:20:22 |
| role_paid              | 是否付费用户       | int      |          | 如果该角色从未付过费，发默认值0；如果付过费，发送1           |
| consume_type           | 消耗类型           | int      |          | 1:购买道具 2:游戏玩法 3:玩家间交易 4.系统扣除 5.其他         |
| consume_diamond        | 钻石消耗数         | int      | 是       | 本次行为消耗的钻石总数，包含真钻、black部分                  |
| consume_blackdiamond   | black钻石消耗数    | int      |          | 本次行为消耗的假钻数                                         |
| b_type                 | 行为类型           | string   |          | 该行为的具体分类信息，由游戏方自己划分，如果没有，默认值为空，比如世界BOOS初级、世界BOSS高级同属于世界BOSS |
| b_id                   | 行为id             | string   | 是       | 是由哪个行为消耗的，游戏对该行为的ID编号，具体表示某行为，例如商城购买，创建工会，完成副本扫荡等。行为分到具体情况，比如单抽，10连抽，竞技场胜负，竞技场排名变化，如果没有，默认值为空 |
| consume_rs_id          | 资源id             | string   |          | 代表的是由哪个资源消耗的钻石，游戏中每种资源都有对应的资源ID，研发自定义，相应ID值以及对应的中文名称需要同步到数据中心，如果没有默认值为空 |
| consume_rs_property_id | 资源属性id         | string   |          | 资源哪个属性的变化导致了钻石或者金币的消耗，例如资源的等级，星级，品阶变化等，属性都有对应的属性ID，研发自定义，相应ID值以及对应的中文名称需要同步到数据中心，如果没有默认值为空 |
| other_role_id          | 玩家交易的另一方   | string   |          | 当该行为是玩家相互交易时，发送交易玩家的角色ID               |
| diamond                | 钻石数量           | int      |          | 钻石存量，用户充值获得的钻石(也有可能叫黄金、元宝之类的)，非赠送，默认值0 |
| blackdiamond           | 赠送钻石数量       | int      |          | 假钻存量，赠送的钻石或参与玩法获得的钻石，默认值0            |
| money                  | 金币               | int      |          | 金币存量，游戏内的基础货币，比如少三中的银币，默认值0        |
| channel_id             | 用户来源 id        | int      |          | cps id，手游的分包ID，默认值为0。cps id在手游分包中是必须要发的数据 |
| multiscreen_type       | 多屏类型           | string   |          | web: 网页 wap: wap页面 app: 手机客户端 pc: pc主机  micro：微端，海外游戏如果有使用微端，需要发 |
| spare_one              | 备用字段           | string   |          | Json格式                                                     |
| device                 | 设备               | string   |          | 设备号，PC、手游需要发送客户端设备ID，统一使用公司标准，页游可以根据需要发送相应值，比如浏览器信息 手游通过supersdk提供接口获取 android：优先imei，取不到用android_id ios:优先idfa，取不到用idfv supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->工具模块，"获取新版设备ID" |
| bundle_id              | 分包id             | string   |          |                                                              |
| model                  | 机型               | string   |          |                                                              |
| country                | 国家               | string   |          | 根据客户端的国家信息来判定玩家的国家，使用国家中文名称来表示。例如，中国为“中国” |
| region                 | 地区               | string   |          | 根据客户端的国家信息来判定玩家的地区，使用地区中文名称来表示。例如，东南亚为“东南亚” |
| timezone               | 时区               | string   |          | 根据客户端的时区信息来判定玩家的国家。例如，北京时间表示为为 “+8” |
| timestamp              | 时间戳             | int      | 是       | 0时区的时间戳，到秒，如1596771683                            |
| language               | 语种               | string   |          | 根据客户端的语言信息来判定玩家的语种，使用语种中文名称来表示。例如，简体中文为“简体中文” |
| yz_device_id           | 游族设备ID         | string   | 是       | 规范游族内移动设备ID数据，使不同数据源内容保持一致，现supersdk提供游族统一设备ID获取接口，给所有游族设备进行统一编号 supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->工具模块，"获取游族ID" |
| oaid                   | 国内安卓联盟设备ID | string   |          | oaid是由中国信息通讯研究院号召,移动安全联盟推行的安卓设备标识,在无法获取安卓设备号情况下用于替代imei标识，统一由supersdk接口获取 |

### **2.3**  **服基础信息类**

包括当前在线人数，每5分钟发送。

#### **2.3.1**   **服人数信息**

埋点：在服务器端每 **5****分钟** 统计一次当前在线人数，记为当前服人数

**国内、海外游戏** **timestamp** **都要发**

| 字段             | 描述               | 字段类型 | 是否必填 | 说明                                                         |
| ---------------- | ------------------ | -------- | -------- | ------------------------------------------------------------ |
| SerPcu           | 服人数             | string   | 是       | 发送服当前在线人数，固定值SerPcu                             |
| event_id         | 事件id             | string   |          | 事件id，event_id 字段 ，根据事件类型，角色id，发生时间地点等来产生该 id。例如打倒 boss 获取了3件装备，但是这属于同一事件产生的。记录事件 ID 主要可以用于标示多条日志是同一行为产生的，方便追溯和定位玩家行为。 |
| ver              | sdk版本            | string   |          | 数据中心SDK版本，填默认值1.1                                 |
| op_id            | 运营商 id          | int      | 是       | 填默认值0                                                    |
| opgame_id        | 混服组 id          | int      | 是       | 混服组 id，不可为空，默认是server_id的前4位，取不到时默认填0 supersdk官网 http://docs.supersdk.cn/ 网游->java（举例，其他语言）->扩展模块->游族模块，获取opgameid |
| server_id        | 服 id              | string   | 是       | 服 id，游戏服在游族的数字编号，比如2066310028；如使用研发自己的服id，需要运营在开服系统中配置映射关系 |
| createtime       | 发生时间本地化显示 | string   | 是       | 发生时间，是行为发生时的当地时间，格式为2015-11-01 12:20:22  |
| pcu              | 人数               | int      | 是       | 服当前在线人数，数值必须为整数，默认值0                      |
| spare_one        | 备用字段           | string   |          | Json格式                                                     |
| multiscreen_type | 多屏类型           | string   |          | web: 网页 wap: wap页面 app: 手机客户端 pc: pc主机  micro：微端，海外游戏如果有使用微端，需要发 |
| timezone         | 时区               | string   |          | 根据客户端的时区信息来判定玩家的国家。例如，北京时间表示为为 “+8” |
| timestamp        | 时间戳             | int      | 是       | 0时区的时间戳，到秒，如1596771683                            |