Table of Contents

游戏数据快照上报规范-v2.0

1 接入说明

• 快照与字段名称必须参考文档中的要求，不得缺失，如有特殊困难请及时沟通

• 文档中样例只供格式、内容参考，不得直接复制使用

• 快照数据该报哪些?

  玩家快照数据仅包括当天活跃角色的数据
  工会/联盟快照数据包括所有工会/联盟的快照数据

• 数据格式，数据采用csv格式传输，首行为表头行，从第二行开始为数据行，表头行和数据行不同字段之间用英文逗号(,)分隔，不同行之间用换行符分隔

• 特殊字符，快照中字段的值，不得包含如下字符，也不得出现非UTF8字符，如果有需要研发自行过滤，不然会导致解析串行

• 字段为空时，接入时若遇到无此字段或标记可以传空的字段，经运营人员确认后，可以传空字符串，即两个分隔符（英文逗号）之间为空，如：“,,”

• gameid介绍，gameid标识在特定发行区域发行的一个产品，比如:苍之骑士团日本版:2000004503, 苍之骑士团国服版:2000004501， 具体编码接入时可由技术支持同事提供。

• 文件名介绍， 文件名格式: snapshot_{快照名}_{yyyy-MM-dd}_{gameid}_{区服id}.csv

  “yyyy-MM-dd”中的MM和dd，若不足两位请自动补0，如2月为02，1号为01；区服id指游戏服id。
  注意：文件名中的日期是快照数据的日期，如凌晨2点生成前一天的数据快照，则日期为前一天的日期。
  文件名示例：snapshot_role_2022-02-19_2000003401_10001.csv

• 存放目录， 根目录：/data/bi 根目录建议保持这个规范，如果有原因无法保持这个目录，需要提前找运维同学沟通

  /data/bi
      -- event
      -- snapshot
             -- 2022-02-19
                         -- snapshot_role_2022-02-19_2000003401_10001.csv
                         -- snapshot_role_2022-02-19_2000003401_10002.csv
                         -- snapshot_develop_2022-02-19_2000003401_10001.csv
                         -- snapshot_develop_2022-02-19_2000003401_10002.csv

  注意：日期目录和快照文件名中的日期目录要求一致，即都表示快照数据的日期，如凌晨0点10分生成前一天的数据快照，则日期为前一天的日期。

• 生成时间， 快照每天生成一次，需要在凌晨0点10分生成前一天的快照

• 数据传输， 研发同学只负责按照要求生成在指定的目录中，同步给数据中心的工作由运维同学协助完成

2 玩家数据快照

玩家快照数据仅包括当天活跃角色的数据

2.1 role（角色快照）

游戏品类:全品类

样例：

gameid,openid,clientid,roleid,rolename,create_time,last_login_time,level,viplevel,profession,leagueid,own_after_bound,own_after_unbound,ce,time_used,friend_num,extend1_long,extend2_long,extend3_long,extend1_string,extend2_string,extend3_string`
2000003401,0100010000000000000000000000000155968681,1001,1000601027277819617,多利安·伯蒂姆,1445844754000,1445844754000,88,8,1000001,12,20,,165420,6840,,,,,,,

2.2 develop （养成快照）

游戏品类:全品类

样例：

gameid,openid,clientid,roleid,level,viplevel,item_id,item_name,item_status,item_subid,item_subname,dev_id,dev_name,dev_level,extend1_long,extend2_long,extend3_long,extend1_string,extend2_string,extend3_string
2000003401,0100010000000000000000000000000155968681,1001,1000601027277819617,88,8,,,,,,,,,,,,,,

2.3 coin（货币冗余快照 ）

游戏品类:全品类

样例：

gameid,openid,clientid,roleid,level,viplevel,boundtype,coinid,coinname,redundancy,extend1_long,extend2_long,extend3_long,extend1_string,extend2_string,extend3_string
2000003401,0100010000000000000000000000000155968681,1001,1000601027277819617,88,8,1,1001,金币,100054,,,,,,

2.4 props （道具冗余 快照）

游戏品类:全品类

样例：

gameid,openid,clientid,roleid,level,viplevel,boundtype,propsid,propsname,redundancy,extend1_long,extend2_long,extend3_long,extend1_string,extend2_string,extend3_string
2000003401,0100010000000000000000000000000155968681,1001,1000601027277819617,88,8,1,1001,1001,100054,,,,,,

3 工会/联盟数据快照

工会/联盟快照数据包括所有工会/联盟的快照数据

3.1 union （联盟/公会 快照）

游戏品类:全品类

样例：

gameid,clientid,union_id,union_name,union_level,union_users,union_dau,union_last_active,extend1_long,extend2_long,extend3_long,extend1_string,extend2_string,extend3_string
2000003401,1001,1,tt,88,89,15,1445844754000,,,,,,

3.2 uniondevelop （工会养成进度快照）

游戏品类:全品类

样例：

gameid,clientid,union_id,union_name,union_level,item_id,item_name,item_status,item_subid,item_subname,dev_id,dev_name,dev_level,extend1_long,extend2_long,extend3_long,extend1_string,extend2_string,extend3_string
2000003401,1001,1,tt,88,,,,,,,,,,,,,,

3.3 rank （角色/联盟排行榜快照）

游戏品类:全品类
具体每个榜单需要传前多少名的数据，由运营根据各个产品各个榜单具体决定

样例：

gameid,clientid,rank_type,rank_id,rank_name,rank_data_id,rank_data_name,rank_data_value,rank_data_num,extend1_long,extend2_long,extend3_long,extend1_string,extend2_string,extend3_string
2000003401,1001,2,1,tt,1001,name,88,2,,,,,,

4 自定义快照

4.1 custom2role2{自定义快照code} （角色维度）

游戏品类:产品级，各产品根据需求通过该快照扩展角色维度的自定义快照数据
注意：{自定义快照code}中只能是字母或数字，不能包含任何非数字和字符之外的字符，如角色聊天数据的自定义快照:custom2role2chat，此时的快照文件名是：snapshot_custom2role2chat_2022-02-19_2000003401_10001.csv
其中...标识可以传自定义的参数key，参数类型完全按照字符串值类型进行解析，自定义参数key的格式最大不应超过15个

样例：

gameid,openid,clientid,roleid,level,viplevel,key1,key2
2000003401,0100010000000000000000000000000155968681,1001,1000601027277819617,88,8,key1value,key2value

4.2 custom2server2{自定义快照code} （区服维度）

游戏品类:产品级，各产品根据需求通过该快照扩展区服维度（非角色维度）的自定义快照数据
注意：{自定义快照code}中只能是字母或数字，不能包含任何非数字和字符之外的字符，如角区服钻石总量的自定义快照:custom2server2diamond，此时的快照文件名是：snapshot_custom2server2diamond_2022-02-19_2000003401_10001.csv
其中...标识可以传自定义的参数key，参数类型完全按照字符串值类型进行解析，自定义参数key的格式最大不应超过15个

样例：

gameid,clientid,key1,key2
2000003401,1001,key1value,key2value