下载文档

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

数据中心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
 
©2021 www.gtarcade.com All Rights Reserved