服务端打点事件上报规范-v2.0

0 修改历史

日期 说明
2022-08-17 事件存储目录拆分为base、consume、other
2022-10-18 增加玩家充值发货事件:BI_payment_deliver

1 接入说明

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

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

  • 游戏品类中标记为全品类时所有品类产品都需要接入, 标记为卡牌、MMO、SLG品类时只是相对应的游戏品类接入, 标记为产品级时具体是否需要接入由产品运营决定

  • 数据格式,数据格式为标准的JSON格式,每条日志使用换行符进行分隔

  • 字段若不需要,传递时请传null,注意不是字符串的”null”,如:extend1_long”: null,

  • 特殊字符,字段值不允许出现非UTF8字符,也不得出现如下字符,请研发自行过滤

字符 说明
\r 回车符
\n 换行符
\t 制表符
| 竖线
  • service_code介绍,service_code字段是由龙图SDK生成的带有设备、游戏包信息的加密串,获取方式参考serviceCode获取方式注意:获取时机需要在龙图账号登录后获取,不然会缺失部分必要信息

  • uniquekey介绍,uniquekey字段用来标识每条日志的唯一性,建议使用UUID即可

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

  • 文件名格式,每个服每天可创建一个(或多个)文件(需要实时以追加的方式写入新的日志),文件名格式:yyyy-MM-dd_游戏服ID_进程或服务编码.log, 文件只可追加不能删除重写,也不可覆盖更新
    注意1:文件名称中的“进程或服务编码”,只能是数字和字母,长度限制在15个字符以内,如果不需要可以用default替代,例如:2021-07-02_2_default.log; 增加进程或服务编码是为解决个别研发团队同一个游戏服下多进程下会产生文件名重复的问题
    注意2: 实时追加方式写入日志,文件不得自行删除,已经写入数据后不得从头进行重写,因为如果从头重写,会导致在增量数据同步模式下丢失部分数据

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

    1. /data/bi/
    2. -- base // 基础事件存放目录
    3. -- 2021-07-02_2_core.log
    4. -- 2021-07-02_2_gm.log
    5. -- 2021-07-02_1_default.log
    6. -- consume // 玩家获得/消耗事件存放目录
    7. -- 2021-07-02_2_core.log
    8. -- 2021-07-02_2_gm.log
    9. -- 2021-07-02_1_default.log
    10. -- other // 其他事件存放目录
    11. -- 2021-07-02_2_core.log
    12. -- 2021-07-02_2_gm.log
    13. -- 2021-07-02_1_default.log
  • 文件传输, 研发同学只负责写入,同步给数据中心的工作由 运维同学协助完成,同步采用增量数据同步模式进行。
    注意: 若研发同学自己同步,可以使用rsync的--append参数,如果不清楚可以找龙图运维同学协助,建议1分钟进行一次增量同步,仅同步当天和昨天的文件即可,一定不要同步昨天之前的文件,不然会导致数据重复消费,进而导致BI这边会出现重复日志

  • 特殊对象字段 目前支持下列特殊对象字段录入到TGA中

    1. 1JSON对象,以字段example为例如下所示
    2. {
    3. "example":{"attribute1":"value1","attribute2":"value2"}
    4. }
    5. 2, JSONArray, 以字段example为例如下所示
    6. {
    7. "example":["value1","value2"]
    8. }
    9. 注意:单条数据中不可存在换行符,不然影响日志切割

2 基础事件

注意:该分类下的事件需要写入到"base"目录下

2.1 BI_login(账号登录事件)

游戏品类:全品类
上报时机:账号登录完成后立即上报
该事件由平台上报,游戏无须关注

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key BI_login
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
openid string 必填 平台分配的用户ID 0100010000000000000000000000000155968681
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
service_code string 必填 平台对于游戏包及设备的特征串 详细介绍接入说明
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891

样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_login",
  3. "gameid": "2000003401",
  4. "openid": "0100010000000000000000000000000155968681",
  5. "eventtime": 1445844754000,
  6. "service_code": "MjAwMDAwNDgzMTAwMDgwMDAwMDMxMDAwODAwMzEwMDA4MDAwMDAyMDF8LXw5RDhCMTU0Ni00OEFFLTRBQTEtOTEyMy02NjhGMUEyRDFENUF8LXxpUGhvbmUxMCw2fDEyLjEuMnwxMTI1eDI0MzZ8LXxhcHBsZXwtfDJ8LXw1NjF8MS4wLjN8LXwtfC18MS4wLjN8OTFEOEYyMTUtQzE2OC00NkU0LTg3QjctRTA5NzJBRjg1OUU0fC18LXwxfC18Mi43NkdCfDZ8LXwxNjc3NzIyOF8xfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDlEOEIxNTQ2LTQ4QUUtNEFBMS05MTIzLTY2OEYxQTJEMUQ1QXwtfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDIyMy4xNDYuODUuNHwtfC18LXwxfGlQaG9uZTEwLDZ8MTIuMS4yfDExMjV4MjQzNnwwfDQ2MDAwfDB8YXBwbGV8LXwtfDU2MXx8LXwt",
  7. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891"
  8. }

2.2 BI_role_new(创建角色事件)

游戏品类:全品类
上报时机:角色创建完成后立即上报

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key BI_role_new
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
openid string 必填 平台分配的用户ID 0100010000000000000000000000000155968681
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
clientid string 必填 游戏区服ID 1001
roleid string 必填 角色ID 1000601027277819617
rolename string 必填 角色名称,若创建角色时没有角色名,可以传空字符串 多利安·伯蒂姆
profession string MMO和SLG品类必填 角色的职业、门派、种族ID,不需要时传空即可 1000001
extend1_long long 产品级 扩展参数1,long类型,不用传空即可
extend2_long long 产品级 扩展参数2,long类型,不用传空即可
extend3_long long 产品级 扩展参数3,long类型,不用传空即可
extend1_string string 产品级 扩展参数1,string类型,不用传空即可
extend2_string string 产品级 扩展参数2,string类型,不用传空即可
extend3_string string 产品级 扩展参数3,string类型,不用传空即可
service_code string 必填 平台对于游戏包及设备的特征串 详细介绍接入说明
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891

样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_role_new",
  3. "gameid": "2000003401",
  4. "openid": "0100010000000000000000000000000155968681",
  5. "eventtime": 1445844754000,
  6. "clientid": "10001",
  7. "roleid":"1000601027277819617",
  8. "rolename": "多利安·伯蒂姆",
  9. "profession": "1000001",
  10. "extend1_long": null,
  11. "extend2_long": null,
  12. "extend3_long": null,
  13. "extend1_string": null,
  14. "extend2_string": null,
  15. "extend3_string": null,
  16. "service_code": "MjAwMDAwNDgzMTAwMDgwMDAwMDMxMDAwODAwMzEwMDA4MDAwMDAyMDF8LXw5RDhCMTU0Ni00OEFFLTRBQTEtOTEyMy02NjhGMUEyRDFENUF8LXxpUGhvbmUxMCw2fDEyLjEuMnwxMTI1eDI0MzZ8LXxhcHBsZXwtfDJ8LXw1NjF8MS4wLjN8LXwtfC18MS4wLjN8OTFEOEYyMTUtQzE2OC00NkU0LTg3QjctRTA5NzJBRjg1OUU0fC18LXwxfC18Mi43NkdCfDZ8LXwxNjc3NzIyOF8xfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDlEOEIxNTQ2LTQ4QUUtNEFBMS05MTIzLTY2OEYxQTJEMUQ1QXwtfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDIyMy4xNDYuODUuNHwtfC18LXwxfGlQaG9uZTEwLDZ8MTIuMS4yfDExMjV4MjQzNnwwfDQ2MDAwfDB8YXBwbGV8LXwtfDU2MXx8LXwt",
  17. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891"
  18. }

2.3 BI_role_login(角色登录/登出事件)

游戏品类:全品类
上报时机:角色登录/登出完成后立即上报

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key BI_role_login
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
openid string 必填 平台分配的用户ID 0100010000000000000000000000000155968681
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
clientid string 必填 游戏区服ID 1001
roleid string 必填 角色ID 1000601027277819617
rolename string 必填 角色名称 多利安·伯蒂姆
profession string 产品级 角色当前的职业、门派、种族ID,各产品根据自身情况决定是否需要,不需要时传空即可 1000001
leagueid string 必填 角色当前加入的联盟(工会)ID,未加入可传空 12
type string 必填 登入1;登出 2 1
level int 必填 角色当前等级 88
viplevel int 产品级 角色当前VIP等级,各产品根据自身情况决定是否需要,不需要时传空即可 8
own_after_bound long 产品级 角色当前存量的一级货币(绑定状态)数量,各产品根据自身情况决定是否需要,不需要时传空即可 100
own_after_unbound long 产品级 角色当前存量的一级货币(非绑定状态)数量,各产品根据自身情况决定是否需要,不需要时传空即可 100
online_time long 必填 登入时报0,登出时报本次登录在线时长(单位秒) 6840
extend1_long long 产品级 扩展参数1,long类型,不用传空即可
extend2_long long 产品级 扩展参数2,long类型,不用传空即可
extend3_long long 产品级 扩展参数3,long类型,不用传空即可
extend1_string string 产品级 扩展参数1,string类型,不用传空即可
extend2_string string 产品级 扩展参数2,string类型,不用传空即可
extend3_string string 产品级 扩展参数3,string类型,不用传空即可
service_code string 必填 平台对于游戏包及设备的特征串 详细介绍接入说明
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891

样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_role_login",
  3. "gameid": "2000003401",
  4. "openid": "0100010000000000000000000000000155968681",
  5. "eventtime": 1445844754000,
  6. "clientid": "10001",
  7. "roleid":"1000601027277819617",
  8. "rolename": "多利安·伯蒂姆",
  9. "profession": "1000001",
  10. "leagueid": "12",
  11. "type": "1",
  12. "level": 88,
  13. "viplevel": 8,
  14. "own_after_bound": 100,
  15. "own_after_unbound": 100,
  16. "online_time":0,
  17. "extend1_long": null,
  18. "extend2_long": null,
  19. "extend3_long": null,
  20. "extend1_string": null,
  21. "extend2_string": null,
  22. "extend3_string": null,
  23. "service_code": "MjAwMDAwNDgzMTAwMDgwMDAwMDMxMDAwODAwMzEwMDA4MDAwMDAyMDF8LXw5RDhCMTU0Ni00OEFFLTRBQTEtOTEyMy02NjhGMUEyRDFENUF8LXxpUGhvbmUxMCw2fDEyLjEuMnwxMTI1eDI0MzZ8LXxhcHBsZXwtfDJ8LXw1NjF8MS4wLjN8LXwtfC18MS4wLjN8OTFEOEYyMTUtQzE2OC00NkU0LTg3QjctRTA5NzJBRjg1OUU0fC18LXwxfC18Mi43NkdCfDZ8LXwxNjc3NzIyOF8xfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDlEOEIxNTQ2LTQ4QUUtNEFBMS05MTIzLTY2OEYxQTJEMUQ1QXwtfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDIyMy4xNDYuODUuNHwtfC18LXwxfGlQaG9uZTEwLDZ8MTIuMS4yfDExMjV4MjQzNnwwfDQ2MDAwfDB8YXBwbGV8LXwtfDU2MXx8LXwt",
  24. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891"
  25. }

2.4 BI_payment(玩家充值事件)

游戏品类:全品类
上报时机:充值完成后立即上报,注意本事件不关注是否发货成功,仅关注充值成功
该事件由平台上报,游戏无须关注
注意:如果只接入平台的统计SDK,该事件还是由游戏侧上报

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key BI_payment
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
openid string 必填 平台分配的用户ID 0100010000000000000000000000000155968681
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
clientid string 必填 游戏区服ID 1001
roleid string 必填 角色ID 1000601027277819617
level int 必填 角色当前等级 88
viplevel int 产品级 角色当前VIP等级,各产品根据自身情况决定是否需要,不需要时传空即可 8
amount long 必填 充值金额,单位默认为分,具体根据各地区发行时的默认货币有关 600
currency string 必填 充值货币,取自下单时的货币转换为国际标准货币码 CNY
goodsid string 必填 购买商品ID 10001
goodsname string 必填 购买商品名称 10001
transactionid string 必填 平台充值订单号,游戏侧上报时订单号由游戏侧生成(小于50位的字符串即可) 0012022021416483085100
extend1_long long 产品级 扩展参数1,long类型,不用传空即可
extend2_long long 产品级 扩展参数2,long类型,不用传空即可
extend3_long long 产品级 扩展参数3,long类型,不用传空即可
extend1_string string 产品级 扩展参数1,string类型,不用传空即可
extend2_string string 产品级 扩展参数2,string类型,不用传空即可
extend3_string string 产品级 扩展参数3,string类型,不用传空即可
service_code string 必填 平台对于游戏包及设备的特征串 详细介绍接入说明
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891

样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_payment",
  3. "gameid": "2000003401",
  4. "openid": "0100010000000000000000000000000155968681",
  5. "eventtime": 1445844754000,
  6. "clientid": "10001",
  7. "roleid": "1000601027277819617",
  8. "level": 89,
  9. "viplevel": 8,
  10. "amount": 600,
  11. "currency": "CNY",
  12. "goodsid": "100001",
  13. "goodsname": "30钻",
  14. "transactionid": "0012022021416483085100",
  15. "extend1_long": null,
  16. "extend2_long": null,
  17. "extend3_long": null,
  18. "extend1_string": null,
  19. "extend2_string": null,
  20. "extend3_string": null,
  21. "service_code": "MjAwMDAwNDgzMTAwMDgwMDAwMDMxMDAwODAwMzEwMDA4MDAwMDAyMDF8LXw5RDhCMTU0Ni00OEFFLTRBQTEtOTEyMy02NjhGMUEyRDFENUF8LXxpUGhvbmUxMCw2fDEyLjEuMnwxMTI1eDI0MzZ8LXxhcHBsZXwtfDJ8LXw1NjF8MS4wLjN8LXwtfC18MS4wLjN8OTFEOEYyMTUtQzE2OC00NkU0LTg3QjctRTA5NzJBRjg1OUU0fC18LXwxfC18Mi43NkdCfDZ8LXwxNjc3NzIyOF8xfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDlEOEIxNTQ2LTQ4QUUtNEFBMS05MTIzLTY2OEYxQTJEMUQ1QXwtfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDIyMy4xNDYuODUuNHwtfC18LXwxfGlQaG9uZTEwLDZ8MTIuMS4yfDExMjV4MjQzNnwwfDQ2MDAwfDB8YXBwbGV8LXwtfDU2MXx8LXwt",
  22. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891"
  23. }

货币类型表:

代码 中文说明 代码 中文说明 代码 中文说明 代码 中文说明
CNY 人民币 MYR 马来西亚币 ZAR 南非货币 THB 泰铢
USD 美元 AUD 澳元 BTN 努尔特鲁姆 GBP 英镑
TWD 台币 MOP 澳门币 TRY 土耳其里拉 KHR 利尔斯(柬埔寨)
CAD 加拿大元 KRW 韩币 PHP 菲律宾比索 SAR 沙亚币
JPY 日元 VND 越南盾 RON 罗马尼亚 RUB 俄罗斯卢布
HKD 港币 IDR 印尼卢比 CHF 瑞士法郎 SGD 新币

2.5 BI_payment_deliver(玩家充值发货事件)

游戏品类:全品类
上报时机:充值完成并发货成功后上报

  1. 注意:
  2. 1goodsid是在平台申请的计费商品ID,同时也是客户端下单时传递的商品信息;transactionid是平台通知发货时的订单号;amountcurrency是平台通知发货时传的chargePricecurrencyType(货币类型需要进行转化)
  3. 2packageidpackagename是礼包型购买项对应的具体礼包ID和礼包名称
  4. 3propsList以及数组下的道具列表,是本次充值发货的具体货币和道具,其中数量分为绑定态数量和费绑定态数量,接入时请先和运营同学沟通
参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key BI_payment_deliver
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
openid string 必填 平台分配的用户ID 0100010000000000000000000000000155968681
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
clientid string 必填 游戏区服ID 1001
roleid string 必填 角色ID 1000601027277819617
level int 必填 角色当前等级 88
viplevel int 产品级 角色当前VIP等级,各产品根据自身情况决定是否需要,不需要时传空即可 8
amount long 必填 充值金额,具体为平台通知发货时传的chargePrice 600
currency string 必填 充值货币,具体为平台通知发货时传的currencyType按照货币对应表进行转换,如1转换为CNY CNY
transactionid string 必填 平台充值订单号 0012022021416483085100
goodsid string 必填 计费商品ID,对应充值订单中的下单商品ID 10001
packageid string 选填 购买实际礼包ID,若直接购买道具时该字段可为空 package_1000033
packagename string 选填 购买实际礼包名称,若直接购买道具时该字段可为空 精炼大礼包
packagetype string 选填 购买实际礼包类型,若直接购买道具时该字段可为空
packagetypename string 选填 购买实际礼包类型名称,若直接购买道具时该字段可为空
propsList array 必填 具体发放的物品明细
- propsid string 必填 具体发货的物品ID props_10000234
- propsname string 必填 具体发货的物品名称 金币
- propstype string 必填 类型,货币填0,道具填1 金币
- count_bound long 必填 具体物品绑定态发货数量 100000
- count_unbound long 必填 具体物品非绑定态发货数量 100000
extend1_long long 产品级 扩展参数1,long类型,不用传空即可
extend2_long long 产品级 扩展参数2,long类型,不用传空即可
extend3_long long 产品级 扩展参数3,long类型,不用传空即可
extend1_string string 产品级 扩展参数1,string类型,不用传空即可
extend2_string string 产品级 扩展参数2,string类型,不用传空即可
extend3_string string 产品级 扩展参数3,string类型,不用传空即可
service_code string 必填 平台对于游戏包及设备的特征串 详细介绍接入说明
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891

样例:

  1. {
  2. "eventkey": "BI_payment_deliver",
  3. "gameid": "2000003401",
  4. "openid": "0100010000000000000000000000000155968681",
  5. "eventtime": 1445844754000,
  6. "clientid": "10001",
  7. "roleid": "1000601027277819617",
  8. "level": 89,
  9. "viplevel": 8,
  10. "amount": 600,
  11. "currency": "CNY",
  12. "transactionid": "0012022021416483085100",
  13. "goodsid": "100001",
  14. "packageid": "package_1000033",
  15. "packagename": "精炼大礼包",
  16. "packagetype": "packagetype_1002",
  17. "packagetypename": "礼包类型名称",
  18. "propsList":[
  19. {
  20. "propsid": "8",
  21. "propsname": "钻石",
  22. "propstype":"0",
  23. "count_bound":0,
  24. "count_unbound":30
  25. },
  26. {
  27. "propsid": "1000231",
  28. "propsname": "水晶魔杖",
  29. "propstype":"1",
  30. "count_bound":1,
  31. "count_unbound":0
  32. }
  33. ]
  34. "extend1_long": null,
  35. "extend2_long": null,
  36. "extend3_long": null,
  37. "extend1_string": null,
  38. "extend2_string": null,
  39. "extend3_string": null,
  40. "service_code": "MjAwMDAwNDgzMTAwMDgwMDAwMDMxMDAwODAwMzEwMDA4MDAwMDAyMDF8LXw5RDhCMTU0Ni00OEFFLTRBQTEtOTEyMy02NjhGMUEyRDFENUF8LXxpUGhvbmUxMCw2fDEyLjEuMnwxMTI1eDI0MzZ8LXxhcHBsZXwtfDJ8LXw1NjF8MS4wLjN8LXwtfC18MS4wLjN8OTFEOEYyMTUtQzE2OC00NkU0LTg3QjctRTA5NzJBRjg1OUU0fC18LXwxfC18Mi43NkdCfDZ8LXwxNjc3NzIyOF8xfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDlEOEIxNTQ2LTQ4QUUtNEFBMS05MTIzLTY2OEYxQTJEMUQ1QXwtfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDIyMy4xNDYuODUuNHwtfC18LXwxfGlQaG9uZTEwLDZ8MTIuMS4yfDExMjV4MjQzNnwwfDQ2MDAwfDB8YXBwbGV8LXwtfDU2MXx8LXwt",
  41. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891"
  42. }

货币转换对应表:

平台回传货币代码 转换后货币标识 说明
1 CNY 人民币(分)
2 USD 美元(分)
3 JPY 日元
4 HKD 港币(分)
7 VND 越南盾
8 TWD 台币
9 KRW 韩币
10 THB 泰铢

2.6 BI_online(区服在线人数上报)

游戏品类:全品类
上报时机:每个区服每小时的0,5,10,15,20,25,30,35,40,45,50,55分钟时各上报一次当前的在线人数

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key BI_online
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
eventtime long 必填 事件发生时间戳(毫秒),比如上报2022-02-16 10:05分时间点的在线人数传 1644977100000 1644977100000
clientid string 必填 游戏区服ID 1001
users int 必填 当前在线角色数 136
extend1_long long 产品级 扩展参数1,long类型,不用传空即可
extend2_long long 产品级 扩展参数2,long类型,不用传空即可
extend3_long long 产品级 扩展参数3,long类型,不用传空即可
extend1_string string 产品级 扩展参数1,string类型,不用传空即可
extend2_string string 产品级 扩展参数2,string类型,不用传空即可
extend3_string string 产品级 扩展参数3,string类型,不用传空即可
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891

样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_online",
  3. "gameid": "2000003401",
  4. "eventtime": 1644977100000,
  5. "clientid": "10001",
  6. "users": 136,
  7. "extend1_long": null,
  8. "extend2_long": null,
  9. "extend3_long": null,
  10. "extend1_string": null,
  11. "extend2_string": null,
  12. "extend3_string": null,
  13. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891"
  14. }

3 玩家获得/消耗事件

注意:该分类下的事件需要写入到"consume"目录下

3.1 BI_diamond_get(一级货币获得事件)

游戏品类:全品类
上报时机:游戏内玩家针对一级货币获得完成后上报

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key BI_diamond_get
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
openid string 必填 平台分配的用户ID 0100010000000000000000000000000155968681
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
clientid string 必填 游戏区服ID 1001
roleid string 必填 角色ID 1000601027277819617
level int 必填 角色当前等级 88
viplevel int 产品级 角色当前VIP等级,各产品根据自身情况决定是否需要,不需要时传空即可 8
get_count_bound long 必填 绑定状态的一级货币获得的数量,若本次未获得绑定态货币,则传0 20
get_count_unbound long 必填 非绑定状态的一级货币获得的数量,若本次未获得非绑定态货币,则传0 0
own_after_bound long 必填 绑定状态的一级货币获得后角色剩余数量 350
own_after_unbound long 必填 非绑定状态的一级货币获得后角色剩余数量 60
get_wayclassid string 必填 本次获得的获得方式类型 2
get_wayclassname string 必填 本次获得的获得方式类型的名称 商城购买
get_wayid string 必填 本次获得的获得方式子类型,无可传空
get_wayname string 必填 本次获得的获得方式子类型的名称,无可传空
extend1_long long 产品级 扩展参数1,long类型,不用传空即可
extend2_long long 产品级 扩展参数2,long类型,不用传空即可
extend3_long long 产品级 扩展参数3,long类型,不用传空即可
extend1_string string 产品级 扩展参数1,string类型,不用传空即可
extend2_string string 产品级 扩展参数2,string类型,不用传空即可
extend3_string string 产品级 扩展参数3,string类型,不用传空即可
service_code string 必填 平台对于游戏包及设备的特征串 详细介绍接入说明
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891

样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_diamond_get",
  3. "gameid": "2000003401",
  4. "openid": "0100010000000000000000000000000155968681",
  5. "eventtime": 1445844754000,
  6. "clientid": "10001",
  7. "roleid": "1000601027277819617",
  8. "level": 89,
  9. "viplevel": 8,
  10. "get_count_bound": 20,
  11. "get_count_unbound": 0,
  12. "own_after_bound": 350,
  13. "own_after_unbound": 60,
  14. "get_wayclassid": "2",
  15. "get_wayclassname": "商城购买",
  16. "get_wayid": null,
  17. "get_wayname": null,
  18. "extend1_long": null,
  19. "extend2_long": null,
  20. "extend3_long": null,
  21. "extend1_string": null,
  22. "extend2_string": null,
  23. "extend3_string": null,
  24. "service_code": "MjAwMDAwNDgzMTAwMDgwMDAwMDMxMDAwODAwMzEwMDA4MDAwMDAyMDF8LXw5RDhCMTU0Ni00OEFFLTRBQTEtOTEyMy02NjhGMUEyRDFENUF8LXxpUGhvbmUxMCw2fDEyLjEuMnwxMTI1eDI0MzZ8LXxhcHBsZXwtfDJ8LXw1NjF8MS4wLjN8LXwtfC18MS4wLjN8OTFEOEYyMTUtQzE2OC00NkU0LTg3QjctRTA5NzJBRjg1OUU0fC18LXwxfC18Mi43NkdCfDZ8LXwxNjc3NzIyOF8xfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDlEOEIxNTQ2LTQ4QUUtNEFBMS05MTIzLTY2OEYxQTJEMUQ1QXwtfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDIyMy4xNDYuODUuNHwtfC18LXwxfGlQaG9uZTEwLDZ8MTIuMS4yfDExMjV4MjQzNnwwfDQ2MDAwfDB8YXBwbGV8LXwtfDU2MXx8LXwt",
  25. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891"
  26. }

3.2 BI_diamond_consume(一级货币消耗事件)

游戏品类:全品类
上报时机:游戏内玩家针对一级货币消耗完成后上报

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key BI_diamond_consume
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
openid string 必填 平台分配的用户ID 0100010000000000000000000000000155968681
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
clientid string 必填 游戏区服ID 1001
roleid string 必填 角色ID 1000601027277819617
level int 必填 角色当前等级 88
viplevel int 产品级 角色当前VIP等级,各产品根据自身情况决定是否需要,不需要时传空即可 8
consume_count_bound long 必填 绑定状态的一级货币消耗的数量,若本次未消耗绑定态货币,则传0 20
consume_count_unbound long 必填 非绑定状态的一级货币消耗的数量,若本次未消耗非绑定态货币,则传0 0
own_after_bound long 必填 绑定状态的一级货币消耗后角色剩余数量 350
own_after_unbound long 必填 非绑定状态的一级货币消耗后角色剩余数量 60
consume_wayclassid string 必填 本次消耗的消耗方式类型 2
consume_wayclassname string 必填 本次消耗的消耗方式类型的名称 商城购买
consume_wayid string 必填 本次消耗的消耗方式子类型,无可传空
consume_wayname string 必填 本次消耗的消耗方式子类型的名称,无可传空
goodsid string 必填 本次消耗购买商品ID 10001
goodsprice long 必填 本次消耗购买商品单价,注意是单价 5
goodsnum long 必填 本次消耗购买商品数量 10
poundage long 必填 本次消耗的手续费,如果无,则传0即可 0
extend1_long long 产品级 扩展参数1,long类型,不用传空即可
extend2_long long 产品级 扩展参数2,long类型,不用传空即可
extend3_long long 产品级 扩展参数3,long类型,不用传空即可
extend1_string string 产品级 扩展参数1,string类型,不用传空即可
extend2_string string 产品级 扩展参数2,string类型,不用传空即可
extend3_string string 产品级 扩展参数3,string类型,不用传空即可
service_code string 必填 平台对于游戏包及设备的特征串 详细介绍接入说明
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891

样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_diamond_consume",
  3. "gameid": "2000003401",
  4. "openid": "0100010000000000000000000000000155968681",
  5. "eventtime": 1445844754000,
  6. "clientid": "10001",
  7. "roleid": "1000601027277819617",
  8. "level": 89,
  9. "viplevel": 8,
  10. "consume_count_bound": 20,
  11. "consume_count_unbound": 0,
  12. "own_after_bound": 350,
  13. "own_after_unbound": 60,
  14. "consume_wayclassid": "2",
  15. "consume_wayclassname": "商城购买",
  16. "consume_wayid": null,
  17. "consume_wayname": null,
  18. "goodsid": "10001",
  19. "goodsprice": 5,
  20. "goodsnum": 10,
  21. "poundage":0,
  22. "extend1_long": null,
  23. "extend2_long": null,
  24. "extend3_long": null,
  25. "extend1_string": null,
  26. "extend2_string": null,
  27. "extend3_string": null,
  28. "service_code": "MjAwMDAwNDgzMTAwMDgwMDAwMDMxMDAwODAwMzEwMDA4MDAwMDAyMDF8LXw5RDhCMTU0Ni00OEFFLTRBQTEtOTEyMy02NjhGMUEyRDFENUF8LXxpUGhvbmUxMCw2fDEyLjEuMnwxMTI1eDI0MzZ8LXxhcHBsZXwtfDJ8LXw1NjF8MS4wLjN8LXwtfC18MS4wLjN8OTFEOEYyMTUtQzE2OC00NkU0LTg3QjctRTA5NzJBRjg1OUU0fC18LXwxfC18Mi43NkdCfDZ8LXwxNjc3NzIyOF8xfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDlEOEIxNTQ2LTQ4QUUtNEFBMS05MTIzLTY2OEYxQTJEMUQ1QXwtfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDIyMy4xNDYuODUuNHwtfC18LXwxfGlQaG9uZTEwLDZ8MTIuMS4yfDExMjV4MjQzNnwwfDQ2MDAwfDB8YXBwbGV8LXwtfDU2MXx8LXwt",
  29. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891"
  30. }

3.3 BI_coin_get(其他货币获得事件)

游戏品类:全品类
上报时机:游戏内玩家针对其他货币(非一级货币)获得完成后上报

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key BI_coin_get
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
openid string 必填 平台分配的用户ID 0100010000000000000000000000000155968681
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
clientid string 必填 游戏区服ID 1001
roleid string 必填 角色ID 1000601027277819617
level int 必填 角色当前等级 88
viplevel int 产品级 角色当前VIP等级,各产品根据自身情况决定是否需要,不需要时传空即可 8
coinid string 必填 货币道具ID 1001
coinname string 必填 货币道具名称 金币
get_count long 必填 其他货币获得的数量 20
own_after_coin long 必填 其他货币获得后角色剩余数量 350
get_wayclassid string 必填 本次获得的获得方式类型 2
get_wayclassname string 必填 本次获得的获得方式类型的名称 商城购买
get_wayid string 必填 本次获得的获得方式子类型,无可传空
get_wayname string 必填 本次获得的获得方式子类型的名称,无可传空
extend1_long long 产品级 扩展参数1,long类型,不用传空即可
extend2_long long 产品级 扩展参数2,long类型,不用传空即可
extend3_long long 产品级 扩展参数3,long类型,不用传空即可
extend1_string string 产品级 扩展参数1,string类型,不用传空即可
extend2_string string 产品级 扩展参数2,string类型,不用传空即可
extend3_string string 产品级 扩展参数3,string类型,不用传空即可
service_code string 必填 平台对于游戏包及设备的特征串 详细介绍接入说明
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891

样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_coin_get",
  3. "gameid": "2000003401",
  4. "openid": "0100010000000000000000000000000155968681",
  5. "eventtime": 1445844754000,
  6. "clientid": "10001",
  7. "roleid": "1000601027277819617",
  8. "level": 89,
  9. "viplevel": 8,
  10. "coinid":"1001",
  11. "coinname":"金币",
  12. "get_count": 20,
  13. "own_after_coin": 350,
  14. "get_wayclassid": "2",
  15. "get_wayclassname": "商城购买",
  16. "get_wayid": null,
  17. "get_wayname": null,
  18. "extend1_long": null,
  19. "extend2_long": null,
  20. "extend3_long": null,
  21. "extend1_string": null,
  22. "extend2_string": null,
  23. "extend3_string": null,
  24. "service_code": "MjAwMDAwNDgzMTAwMDgwMDAwMDMxMDAwODAwMzEwMDA4MDAwMDAyMDF8LXw5RDhCMTU0Ni00OEFFLTRBQTEtOTEyMy02NjhGMUEyRDFENUF8LXxpUGhvbmUxMCw2fDEyLjEuMnwxMTI1eDI0MzZ8LXxhcHBsZXwtfDJ8LXw1NjF8MS4wLjN8LXwtfC18MS4wLjN8OTFEOEYyMTUtQzE2OC00NkU0LTg3QjctRTA5NzJBRjg1OUU0fC18LXwxfC18Mi43NkdCfDZ8LXwxNjc3NzIyOF8xfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDlEOEIxNTQ2LTQ4QUUtNEFBMS05MTIzLTY2OEYxQTJEMUQ1QXwtfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDIyMy4xNDYuODUuNHwtfC18LXwxfGlQaG9uZTEwLDZ8MTIuMS4yfDExMjV4MjQzNnwwfDQ2MDAwfDB8YXBwbGV8LXwtfDU2MXx8LXwt",
  25. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891"
  26. }

3.4 BI_coin_consume(其他货币消耗事件)

游戏品类:全品类
上报时机:游戏内玩家针对其他货币(非一级货币)消耗完成后上报

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key BI_coin_consume
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
openid string 必填 平台分配的用户ID 0100010000000000000000000000000155968681
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
clientid string 必填 游戏区服ID 1001
roleid string 必填 角色ID 1000601027277819617
level int 必填 角色当前等级 88
viplevel int 产品级 角色当前VIP等级,各产品根据自身情况决定是否需要,不需要时传空即可 8
coinid string 必填 货币道具ID 1001
coinname string 必填 货币道具名称 金币
consume_count long 必填 其他货币消耗后的数量 20
own_after_coin long 必填 其他货币消耗后角色剩余数量 350
consume_wayclassid string 必填 本次消耗的消耗方式类型 2
consume_wayclassname string 必填 本次消耗的获得方式类型的名称 商城购买
consume_wayid string 必填 本次消耗的消耗方式子类型,无可传空
consume_wayname string 必填 本次消耗的消耗得方式子类型的名称,无可传空
goodsid string 必填 本次消耗购买商品ID 10001
goodsprice long 必填 本次消耗购买商品单价,注意是单价 5
goodsnum long 必填 本次消耗购买商品数量 10
poundage long 必填 本次消耗的手续费,如果无,则传0即可 0
extend1_long long 产品级 扩展参数1,long类型,不用传空即可
extend2_long long 产品级 扩展参数2,long类型,不用传空即可
extend3_long long 产品级 扩展参数3,long类型,不用传空即可
extend1_string string 产品级 扩展参数1,string类型,不用传空即可
extend2_string string 产品级 扩展参数2,string类型,不用传空即可
extend3_string string 产品级 扩展参数3,string类型,不用传空即可
service_code string 必填 平台对于游戏包及设备的特征串 详细介绍接入说明
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891

样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_coin_consume",
  3. "gameid": "2000003401",
  4. "openid": "0100010000000000000000000000000155968681",
  5. "eventtime": 1445844754000,
  6. "clientid": "10001",
  7. "roleid": "1000601027277819617",
  8. "level": 89,
  9. "viplevel": 8,
  10. "coinid":"1001",
  11. "coinname":"金币",
  12. "consume_count": 20,
  13. "own_after_coin": 350,
  14. "consume_wayclassid": "2",
  15. "consume_wayclassname": "商城购买",
  16. "consume_wayid": null,
  17. "consume_wayname": null,
  18. "goodsid": "10001",
  19. "goodsprice": 5,
  20. "goodsnum": 10,
  21. "poundage":0,
  22. "extend1_long": null,
  23. "extend2_long": null,
  24. "extend3_long": null,
  25. "extend1_string": null,
  26. "extend2_string": null,
  27. "extend3_string": null,
  28. "service_code": "MjAwMDAwNDgzMTAwMDgwMDAwMDMxMDAwODAwMzEwMDA4MDAwMDAyMDF8LXw5RDhCMTU0Ni00OEFFLTRBQTEtOTEyMy02NjhGMUEyRDFENUF8LXxpUGhvbmUxMCw2fDEyLjEuMnwxMTI1eDI0MzZ8LXxhcHBsZXwtfDJ8LXw1NjF8MS4wLjN8LXwtfC18MS4wLjN8OTFEOEYyMTUtQzE2OC00NkU0LTg3QjctRTA5NzJBRjg1OUU0fC18LXwxfC18Mi43NkdCfDZ8LXwxNjc3NzIyOF8xfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDlEOEIxNTQ2LTQ4QUUtNEFBMS05MTIzLTY2OEYxQTJEMUQ1QXwtfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDIyMy4xNDYuODUuNHwtfC18LXwxfGlQaG9uZTEwLDZ8MTIuMS4yfDExMjV4MjQzNnwwfDQ2MDAwfDB8YXBwbGV8LXwtfDU2MXx8LXwt",
  29. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891"
  30. }

3.5 BI_props_get(道具的获得事件)

游戏品类:全品类
上报时机:游戏内玩家针对道具获得完成后上报

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key BI_props_get
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
openid string 必填 平台分配的用户ID 0100010000000000000000000000000155968681
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
clientid string 必填 游戏区服ID 1001
roleid string 必填 角色ID 1000601027277819617
level int 必填 角色当前等级 88
viplevel int 产品级 角色当前VIP等级,各产品根据自身情况决定是否需要,不需要时传空即可 8
propsid string 必填 道具ID 1001
propsname string 必填 道具名称 英雄卷书
get_count_bound long 必填 绑定状态的道具获得的数量,若本次未获得绑定态货币,则传0 20
get_count_unbound long 必填 非绑定状态的道具获得的数量,若本次未获得非绑定态货币,则传0 0
own_after_bound long 必填 绑定状态的道具获得后角色剩余数量 350
own_after_unbound long 必填 非绑定状态的道具获得后角色剩余数量 60
get_wayclassid string 必填 本次获得的获得方式类型 2
get_wayclassname string 必填 本次获得的获得方式类型的名称 商城购买
get_wayid string 必填 本次获得的获得方式子类型,无可传空
get_wayname string 必填 本次获得的获得方式子类型的名称,无可传空
extend1_long long 产品级 扩展参数1,long类型,不用传空即可
extend2_long long 产品级 扩展参数2,long类型,不用传空即可
extend3_long long 产品级 扩展参数3,long类型,不用传空即可
extend1_string string 产品级 扩展参数1,string类型,不用传空即可
extend2_string string 产品级 扩展参数2,string类型,不用传空即可
extend3_string string 产品级 扩展参数3,string类型,不用传空即可
service_code string 必填 平台对于游戏包及设备的特征串 详细介绍接入说明
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891

样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_props_get",
  3. "gameid": "2000003401",
  4. "openid": "0100010000000000000000000000000155968681",
  5. "eventtime": 1445844754000,
  6. "clientid": "10001",
  7. "roleid": "1000601027277819617",
  8. "level": 89,
  9. "viplevel": 8,
  10. "propsid":"1001",
  11. "propsname":"英雄卷书",
  12. "get_count_bound": 1,
  13. "get_count_unbound": 0,
  14. "own_after_bound": 5,
  15. "own_after_unbound": 0,
  16. "get_wayclassid": "2",
  17. "get_wayclassname": "商城购买",
  18. "get_wayid": null,
  19. "get_wayname": null,
  20. "extend1_long": null,
  21. "extend2_long": null,
  22. "extend3_long": null,
  23. "extend1_string": null,
  24. "extend2_string": null,
  25. "extend3_string": null,
  26. "service_code": "MjAwMDAwNDgzMTAwMDgwMDAwMDMxMDAwODAwMzEwMDA4MDAwMDAyMDF8LXw5RDhCMTU0Ni00OEFFLTRBQTEtOTEyMy02NjhGMUEyRDFENUF8LXxpUGhvbmUxMCw2fDEyLjEuMnwxMTI1eDI0MzZ8LXxhcHBsZXwtfDJ8LXw1NjF8MS4wLjN8LXwtfC18MS4wLjN8OTFEOEYyMTUtQzE2OC00NkU0LTg3QjctRTA5NzJBRjg1OUU0fC18LXwxfC18Mi43NkdCfDZ8LXwxNjc3NzIyOF8xfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDlEOEIxNTQ2LTQ4QUUtNEFBMS05MTIzLTY2OEYxQTJEMUQ1QXwtfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDIyMy4xNDYuODUuNHwtfC18LXwxfGlQaG9uZTEwLDZ8MTIuMS4yfDExMjV4MjQzNnwwfDQ2MDAwfDB8YXBwbGV8LXwtfDU2MXx8LXwt",
  27. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891"
  28. }

3.6 BI_props_consume(道具消耗事件)

游戏品类:全品类
上报时机:游戏内玩家针对道具消耗完成后上报

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key BI_props_consume
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
openid string 必填 平台分配的用户ID 0100010000000000000000000000000155968681
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
clientid string 必填 游戏区服ID 1001
roleid string 必填 角色ID 1000601027277819617
level int 必填 角色当前等级 88
viplevel int 产品级 角色当前VIP等级,各产品根据自身情况决定是否需要,不需要时传空即可 8
propsid string 必填 道具ID 1001
propsname string 必填 道具名称 英雄卷书
consume_count_bound long 必填 绑定状态的道具消耗的数量,若本次未消耗绑定态货币,则传0 20
consume_count_unbound long 必填 非绑定状态的道具消耗的数量,若本次未消耗非绑定态货币,则传0 0
own_after_bound long 必填 绑定状态的道具消耗后角色剩余数量 350
own_after_unbound long 必填 非绑定状态的道具消耗后角色剩余数量 60
consume_wayclassid string 必填 本次消耗的消耗方式类型 2
consume_wayclassname string 必填 本次消耗的消耗方式类型的名称 商城购买
consume_wayid string 必填 本次消耗的消耗方式子类型,无可传空
consume_wayname string 必填 本次消耗的消耗方式子类型的名称,无可传空
extend1_long long 产品级 扩展参数1,long类型,不用传空即可
extend2_long long 产品级 扩展参数2,long类型,不用传空即可
extend3_long long 产品级 扩展参数3,long类型,不用传空即可
extend1_string string 产品级 扩展参数1,string类型,不用传空即可
extend2_string string 产品级 扩展参数2,string类型,不用传空即可
extend3_string string 产品级 扩展参数3,string类型,不用传空即可
service_code string 必填 平台对于游戏包及设备的特征串 详细介绍接入说明
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891

样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_props_consume",
  3. "gameid": "2000003401",
  4. "openid": "0100010000000000000000000000000155968681",
  5. "eventtime": 1445844754000,
  6. "clientid": "10001",
  7. "roleid": "1000601027277819617",
  8. "level": 89,
  9. "viplevel": 8,
  10. "propsid":"1001",
  11. "propsname":"英雄卷书",
  12. "consume_count_bound": 1,
  13. "consume_count_unbound": 0,
  14. "own_after_bound": 5,
  15. "own_after_unbound": 0,
  16. "consume_wayclassid": "2",
  17. "consume_wayclassname": "商城购买",
  18. "consume_wayid": null,
  19. "consume_wayname": null,
  20. "extend1_long": null,
  21. "extend2_long": null,
  22. "extend3_long": null,
  23. "extend1_string": null,
  24. "extend2_string": null,
  25. "extend3_string": null,
  26. "service_code": "MjAwMDAwNDgzMTAwMDgwMDAwMDMxMDAwODAwMzEwMDA4MDAwMDAyMDF8LXw5RDhCMTU0Ni00OEFFLTRBQTEtOTEyMy02NjhGMUEyRDFENUF8LXxpUGhvbmUxMCw2fDEyLjEuMnwxMTI1eDI0MzZ8LXxhcHBsZXwtfDJ8LXw1NjF8MS4wLjN8LXwtfC18MS4wLjN8OTFEOEYyMTUtQzE2OC00NkU0LTg3QjctRTA5NzJBRjg1OUU0fC18LXwxfC18Mi43NkdCfDZ8LXwxNjc3NzIyOF8xfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDlEOEIxNTQ2LTQ4QUUtNEFBMS05MTIzLTY2OEYxQTJEMUQ1QXwtfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDIyMy4xNDYuODUuNHwtfC18LXwxfGlQaG9uZTEwLDZ8MTIuMS4yfDExMjV4MjQzNnwwfDQ2MDAwfDB8YXBwbGV8LXwtfDU2MXx8LXwt",
  27. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891"
  28. }

4 其他事件

注意:该分类下的事件需要写入到"other"目录下

4.1 BI_levelup(角色等级变更事件)

游戏品类:全品类
上报时机:角色等级变更时上报

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key BI_levelup
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
openid string 必填 平台分配的用户ID 0100010000000000000000000000000155968681
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
clientid string 必填 游戏区服ID 1001
roleid string 必填 角色ID 1000601027277819617
old_level int 必填 角色等级变更前等级 88
level int 必填 角色等级变更后等级 89
kingdom string MMO品类必填 角色等级或VIP等级变更原因,具体原因可自行定义
extend1_long long 产品级 扩展参数1,long类型,不用传空即可
extend2_long long 产品级 扩展参数2,long类型,不用传空即可
extend3_long long 产品级 扩展参数3,long类型,不用传空即可
extend1_string string 产品级 扩展参数1,string类型,不用传空即可
extend2_string string 产品级 扩展参数2,string类型,不用传空即可
extend3_string string 产品级 扩展参数3,string类型,不用传空即可
service_code string 必填 平台对于游戏包及设备的特征串 详细介绍接入说明
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891

样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_levelup",
  3. "gameid": "2000003401",
  4. "openid": "0100010000000000000000000000000155968681",
  5. "eventtime": 1445844754000,
  6. "clientid": "10001",
  7. "roleid":"1000601027277819617",
  8. "old_level":88,
  9. "level":89,
  10. "kingdom":null,
  11. "extend1_long": null,
  12. "extend2_long": null,
  13. "extend3_long": null,
  14. "extend1_string": null,
  15. "extend2_string": null,
  16. "extend3_string": null,
  17. "service_code": "MjAwMDAwNDgzMTAwMDgwMDAwMDMxMDAwODAwMzEwMDA4MDAwMDAyMDF8LXw5RDhCMTU0Ni00OEFFLTRBQTEtOTEyMy02NjhGMUEyRDFENUF8LXxpUGhvbmUxMCw2fDEyLjEuMnwxMTI1eDI0MzZ8LXxhcHBsZXwtfDJ8LXw1NjF8MS4wLjN8LXwtfC18MS4wLjN8OTFEOEYyMTUtQzE2OC00NkU0LTg3QjctRTA5NzJBRjg1OUU0fC18LXwxfC18Mi43NkdCfDZ8LXwxNjc3NzIyOF8xfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDlEOEIxNTQ2LTQ4QUUtNEFBMS05MTIzLTY2OEYxQTJEMUQ1QXwtfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDIyMy4xNDYuODUuNHwtfC18LXwxfGlQaG9uZTEwLDZ8MTIuMS4yfDExMjV4MjQzNnwwfDQ2MDAwfDB8YXBwbGV8LXwtfDU2MXx8LXwt",
  18. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891"
  19. }

备注:仅当 level 出现数值变化时上报日志(最少为 1 级),同一级别内的进度变化,不用上报。

4.2 BI_mission(玩家任务关卡副本事件)

游戏品类:产品级
上报时机:角色完成任务、关卡、副本事件时上报

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key BI_mission
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
openid string 必填 平台分配的用户ID 0100010000000000000000000000000155968681
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
clientid string 必填 游戏区服ID 1001
roleid string 必填 角色ID 1000601027277819617
level int 必填 角色当前等级 88
viplevel int 产品级 角色当前VIP等级,各产品根据自身情况决定是否需要,不需要时传空即可 8
mission_type string 必填 事件类型,关卡=1,任务=2,副本=3 1
mission_level int 产品级 开放等级,如无需求可报空 10
event_name string 必填 事件(关卡、任务、副本)名称 赤壁
event_id string 必填 事件(关卡、任务、副本)ID 1001
event_ok string 必填 事件完成状态;不成功=1,成功=2 2
extend1_long long 产品级 扩展参数1,long类型,不用传空即可
extend2_long long 产品级 扩展参数2,long类型,不用传空即可
extend3_long long 产品级 扩展参数3,long类型,不用传空即可
extend1_string string 产品级 扩展参数1,string类型,不用传空即可
extend2_string string 产品级 扩展参数2,string类型,不用传空即可
extend3_string string 产品级 扩展参数3,string类型,不用传空即可
service_code string 必填 平台对于游戏包及设备的特征串 详细介绍接入说明
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891

样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_mission",
  3. "gameid": "2000003401",
  4. "openid": "0100010000000000000000000000000155968681",
  5. "eventtime": 1445844754000,
  6. "clientid": "10001",
  7. "roleid": "1000601027277819617",
  8. "level": 89,
  9. "viplevel": 8,
  10. "mission_type": "1",
  11. "mission_level": 20,
  12. "event_name": "赤壁",
  13. "event_id": "1001",
  14. "event_ok": "2",
  15. "extend1_long": null,
  16. "extend2_long": null,
  17. "extend3_long": null,
  18. "extend1_string": null,
  19. "extend2_string": null,
  20. "extend3_string": null,
  21. "service_code": "MjAwMDAwNDgzMTAwMDgwMDAwMDMxMDAwODAwMzEwMDA4MDAwMDAyMDF8LXw5RDhCMTU0Ni00OEFFLTRBQTEtOTEyMy02NjhGMUEyRDFENUF8LXxpUGhvbmUxMCw2fDEyLjEuMnwxMTI1eDI0MzZ8LXxhcHBsZXwtfDJ8LXw1NjF8MS4wLjN8LXwtfC18MS4wLjN8OTFEOEYyMTUtQzE2OC00NkU0LTg3QjctRTA5NzJBRjg1OUU0fC18LXwxfC18Mi43NkdCfDZ8LXwxNjc3NzIyOF8xfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDlEOEIxNTQ2LTQ4QUUtNEFBMS05MTIzLTY2OEYxQTJEMUQ1QXwtfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDIyMy4xNDYuODUuNHwtfC18LXwxfGlQaG9uZTEwLDZ8MTIuMS4yfDExMjV4MjQzNnwwfDQ2MDAwfDB8YXBwbGV8LXwtfDU2MXx8LXwt",
  22. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891"
  23. }

4.3 玩家对战事件

上报时机:玩家对战事件结束后上报
不同品类参考下面不同的上报事件及字段

BI_player_vs_hero_tcg (卡牌、二次元品类)

游戏品类:卡牌品类

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key BI_player_vs_hero_tcg
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
openid string 必填 平台分配的用户ID 0100010000000000000000000000000155968681
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
clientid string 必填 游戏区服ID 1001
roleid string 必填 角色ID 1000601027277819617
level int 必填 角色当前等级 88
viplevel int 产品级 角色当前VIP等级,各产品根据自身情况决定是否需要,不需要时传空即可 8
versus_type_name string 必填 对战的玩法名称
versus_id string 必填 对战ID,每一场对战的唯一ID
versus_openlevel int 必填 对战开放等级 20
versus_ok string 必填 对战结果;不成功=1,成功=2 2
hero1_id string 必填 出战英雄1ID
hero1_name string 必填 出战英雄1ID名称
hero1_ce long 必填 出战英雄1战力(武力)值 18000
hero1_extend1_string string 产品级 出战英雄1扩展字段1,字符串格式,无传空即可
hero2_id string 产品级 出战英雄2ID
hero2_name string 产品级 出战英雄2ID名称
hero2_ce long 产品级 出战英雄2战力(武力)值 18000
hero2_extend1_string string 产品级 出战英雄2扩展字段1,字符串格式,无传空即可
hero3_id string 产品级 出战英雄3ID
hero3_name string 产品级 出战英雄3ID名称
hero3_ce long 产品级 出战英雄3战力(武力)值 18000
hero3_extend1_string string 产品级 出战英雄3扩展字段1,字符串格式,无传空即可
hero4_id string 产品级 出战英雄4ID
hero4_name string 产品级 出战英雄4ID名称
hero4_ce long 产品级 出战英雄4战力(武力)值 18000
hero4_extend1_string string 产品级 出战英雄4扩展字段1,字符串格式,无传空即可
hero5_id string 产品级 出战英雄5ID
hero5_name string 产品级 出战英雄5ID名称
hero5_ce long 产品级 出战英雄5战力(武力)值 18000
hero5_extend1_string string 产品级 出战英雄5扩展字段1,字符串格式,无传空即可
hero6_id string 产品级 出战英雄6ID
hero6_name string 产品级 出战英雄6ID名称
hero6_ce long 产品级 出战英雄6战力(武力)值 18000
hero6_extend1_string string 产品级 出战英雄6扩展字段1,字符串格式,无传空即可
extend1_long long 产品级 扩展参数1,long类型,不用传空即可
extend2_long long 产品级 扩展参数2,long类型,不用传空即可
extend3_long long 产品级 扩展参数3,long类型,不用传空即可
extend1_string string 产品级 扩展参数1,string类型,不用传空即可
extend2_string string 产品级 扩展参数2,string类型,不用传空即可
extend3_string string 产品级 扩展参数3,string类型,不用传空即可
service_code string 必填 平台对于游戏包及设备的特征串 详细介绍接入说明
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891

注意:英雄有几个传几个,多余不用的英雄字段传空即可
样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_player_vs_hero_tcg",
  3. "gameid": "2000003401",
  4. "openid": "0100010000000000000000000000000155968681",
  5. "eventtime": 1445844754000,
  6. "clientid": "10001",
  7. "roleid": "1000601027277819617",
  8. "level": 89,
  9. "viplevel": 8,
  10. "versus_type_name": "对战的玩法名称",
  11. "versus_id": "1",
  12. "versus_openlevel": 20,
  13. "versus_ok": "2",
  14. "hero1_id": "100001",
  15. "hero1_name": "英雄1名称",
  16. "hero1_ce": 18000,
  17. "hero1_extend1_string": null,
  18. "hero2_id": "100002",
  19. "hero2_name": "英雄2名称",
  20. "hero2_ce": 18000,
  21. "hero2_extend1_string": null,
  22. "hero3_id": "100003",
  23. "hero3_name": "英雄3名称",
  24. "hero3_ce": 18000,
  25. "hero3_extend1_string": null,
  26. "hero4_id": null,
  27. "hero4_name": null,
  28. "hero4_ce": null,
  29. "hero4_extend1_string": null,
  30. "hero5_id": null,
  31. "hero5_name": null,
  32. "hero5_ce": null,
  33. "hero5_extend1_string": null,
  34. "hero6_id": null,
  35. "hero6_name": null,
  36. "hero6_ce": null,
  37. "hero6_extend1_string": null,
  38. "extend1_long": null,
  39. "extend2_long": null,
  40. "extend3_long": null,
  41. "extend1_string": null,
  42. "extend2_string": null,
  43. "extend3_string": null,
  44. "service_code": "MjAwMDAwNDgzMTAwMDgwMDAwMDMxMDAwODAwMzEwMDA4MDAwMDAyMDF8LXw5RDhCMTU0Ni00OEFFLTRBQTEtOTEyMy02NjhGMUEyRDFENUF8LXxpUGhvbmUxMCw2fDEyLjEuMnwxMTI1eDI0MzZ8LXxhcHBsZXwtfDJ8LXw1NjF8MS4wLjN8LXwtfC18MS4wLjN8OTFEOEYyMTUtQzE2OC00NkU0LTg3QjctRTA5NzJBRjg1OUU0fC18LXwxfC18Mi43NkdCfDZ8LXwxNjc3NzIyOF8xfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDlEOEIxNTQ2LTQ4QUUtNEFBMS05MTIzLTY2OEYxQTJEMUQ1QXwtfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDIyMy4xNDYuODUuNHwtfC18LXwxfGlQaG9uZTEwLDZ8MTIuMS4yfDExMjV4MjQzNnwwfDQ2MDAwfDB8YXBwbGV8LXwtfDU2MXx8LXwt",
  45. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891"
  46. }

BI_player_vs_hero_slg (SLG品类)

游戏品类:SLG品类

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key BI_player_vs_hero_slg
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
openid string 必填 平台分配的用户ID 0100010000000000000000000000000155968681
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
clientid string 必填 游戏区服ID 1001
roleid string 必填 角色ID 1000601027277819617
level int 必填 角色当前等级 88
viplevel int 产品级 角色当前VIP等级,各产品根据自身情况决定是否需要,不需要时传空即可 8
versus_type_name string 必填 对战的玩法名称
versus_id string 必填 对战ID,每一场对战的唯一ID
versus_ok string 必填 对战结果;不成功=1,成功=2 2
versus_site string 必填 对战x轴y轴坐标
versus_role string 必填 参战角色对战类型,单人攻城击方、单人防守方、集结攻击方队长、集结攻击方成员、防守方队长、防守方成员
troops_id string 必填 出征部队id 1001
versus_hero1 string 必填 主将英雄ID
versus_hero2 string 必填 副将英雄ID
extend1_long long 产品级 扩展参数1,long类型,不用传空即可
extend2_long long 产品级 扩展参数2,long类型,不用传空即可
extend3_long long 产品级 扩展参数3,long类型,不用传空即可
extend1_string string 产品级 扩展参数1,string类型,不用传空即可
extend2_string string 产品级 扩展参数2,string类型,不用传空即可
extend3_string string 产品级 扩展参数3,string类型,不用传空即可
service_code string 必填 平台对于游戏包及设备的特征串 详细介绍接入说明
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891

样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_player_vs_hero_slg",
  3. "gameid": "2000003401",
  4. "openid": "0100010000000000000000000000000155968681",
  5. "eventtime": 1445844754000,
  6. "clientid": "10001",
  7. "roleid": "1000601027277819617",
  8. "level": 89,
  9. "viplevel": 8,
  10. "versus_type_name": "对战的玩法名称",
  11. "versus_id": "1",
  12. "versus_ok": "2",
  13. "versus_site": "116.30,40.05",
  14. "versus_role": "单人攻城击方",
  15. "troops_id": "1001",
  16. "versus_hero1": "100001",
  17. "versus_hero2": "100002",
  18. "extend1_long": null,
  19. "extend2_long": null,
  20. "extend3_long": null,
  21. "extend1_string": null,
  22. "extend2_string": null,
  23. "extend3_string": null,
  24. "service_code": "MjAwMDAwNDgzMTAwMDgwMDAwMDMxMDAwODAwMzEwMDA4MDAwMDAyMDF8LXw5RDhCMTU0Ni00OEFFLTRBQTEtOTEyMy02NjhGMUEyRDFENUF8LXxpUGhvbmUxMCw2fDEyLjEuMnwxMTI1eDI0MzZ8LXxhcHBsZXwtfDJ8LXw1NjF8MS4wLjN8LXwtfC18MS4wLjN8OTFEOEYyMTUtQzE2OC00NkU0LTg3QjctRTA5NzJBRjg1OUU0fC18LXwxfC18Mi43NkdCfDZ8LXwxNjc3NzIyOF8xfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDlEOEIxNTQ2LTQ4QUUtNEFBMS05MTIzLTY2OEYxQTJEMUQ1QXwtfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDIyMy4xNDYuODUuNHwtfC18LXwxfGlQaG9uZTEwLDZ8MTIuMS4yfDExMjV4MjQzNnwwfDQ2MDAwfDB8YXBwbGV8LXwtfDU2MXx8LXwt",
  25. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891"
  26. }

BI_player_vs_hero_mmo (MMO品类)

游戏品类:MMO品类

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key BI_player_vs_hero_mmo
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
openid string 必填 平台分配的用户ID 0100010000000000000000000000000155968681
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
clientid string 必填 游戏区服ID 1001
roleid string 必填 角色ID 1000601027277819617
level int 必填 角色当前等级 88
viplevel int 产品级 角色当前VIP等级,各产品根据自身情况决定是否需要,不需要时传空即可 8
versus_type_name string 必填 对战的玩法名称
versus_id string 必填 对战ID,每一场对战的唯一ID
versus_auto string 必填 自动对战或手动对战,1:自动;2:手动
versus_openlevel int 必填 对战开放等级 20
versus_ok string 必填 对战结果;不成功=1,成功=2 2
versus_time_cost int 必填 对战时长,单位:秒
versus_die_count int 必填 对战死亡人次
versus_revive_count int 必填 对战复活人次
extend1_long long 产品级 扩展参数1,long类型,不用传空即可
extend2_long long 产品级 扩展参数2,long类型,不用传空即可
extend3_long long 产品级 扩展参数3,long类型,不用传空即可
extend1_string string 产品级 扩展参数1,string类型,不用传空即可
extend2_string string 产品级 扩展参数2,string类型,不用传空即可
extend3_string string 产品级 扩展参数3,string类型,不用传空即可
service_code string 必填 平台对于游戏包及设备的特征串 详细介绍接入说明
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891

样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_player_vs_hero_mmo",
  3. "gameid": "2000003401",
  4. "openid": "0100010000000000000000000000000155968681",
  5. "eventtime": 1445844754000,
  6. "clientid": "10001",
  7. "roleid": "1000601027277819617",
  8. "level": 89,
  9. "viplevel": 8,
  10. "versus_type_name": "对战的玩法名称",
  11. "versus_id": "1",
  12. "versus_auto": "1",
  13. "versus_openlevel": 20,
  14. "versus_ok": "2",
  15. "versus_time_cost": 120,
  16. "versus_die_count": 5,
  17. "versus_revive_count": 2,
  18. "extend1_long": null,
  19. "extend2_long": null,
  20. "extend3_long": null,
  21. "extend1_string": null,
  22. "extend2_string": null,
  23. "extend3_string": null,
  24. "service_code": "MjAwMDAwNDgzMTAwMDgwMDAwMDMxMDAwODAwMzEwMDA4MDAwMDAyMDF8LXw5RDhCMTU0Ni00OEFFLTRBQTEtOTEyMy02NjhGMUEyRDFENUF8LXxpUGhvbmUxMCw2fDEyLjEuMnwxMTI1eDI0MzZ8LXxhcHBsZXwtfDJ8LXw1NjF8MS4wLjN8LXwtfC18MS4wLjN8OTFEOEYyMTUtQzE2OC00NkU0LTg3QjctRTA5NzJBRjg1OUU0fC18LXwxfC18Mi43NkdCfDZ8LXwxNjc3NzIyOF8xfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDlEOEIxNTQ2LTQ4QUUtNEFBMS05MTIzLTY2OEYxQTJEMUQ1QXwtfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDIyMy4xNDYuODUuNHwtfC18LXwxfGlQaG9uZTEwLDZ8MTIuMS4yfDExMjV4MjQzNnwwfDQ2MDAwfDB8YXBwbGV8LXwtfDU2MXx8LXwt",
  25. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891"
  26. }

4.4 BI_dev_participation(养成事件)

游戏品类:全品类
上报时机:养成结束是上报

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key BI_dev_participation
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
openid string 必填 平台分配的用户ID 0100010000000000000000000000000155968681
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
clientid string 必填 游戏区服ID 1001
roleid string 必填 角色ID 1000601027277819617
level int 必填 角色当前等级 88
viplevel int 产品级 角色当前VIP等级,各产品根据自身情况决定是否需要,不需要时传空即可 8
dev_type string 必填 养成项分类,若无此属性可传空
dev_type_name string 必填 养成项分类名称,若无此属性可传空
dev_id string 必填 养成项ID 1
dev_name string 必填 养成项名称,装备强化、装备进阶、宠物升级、坐骑激活等
dev_openlevel int 必填 养成项相应的开放等级 20
extend1_long long 产品级 扩展参数1,long类型,不用传空即可
extend2_long long 产品级 扩展参数2,long类型,不用传空即可
extend3_long long 产品级 扩展参数3,long类型,不用传空即可
extend1_string string 产品级 扩展参数1,string类型,不用传空即可
extend2_string string 产品级 扩展参数2,string类型,不用传空即可
extend3_string string 产品级 扩展参数3,string类型,不用传空即可
service_code string 必填 平台对于游戏包及设备的特征串 详细介绍接入说明
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891

样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_dev_participation",
  3. "gameid": "2000003401",
  4. "openid": "0100010000000000000000000000000155968681",
  5. "eventtime": 1445844754000,
  6. "clientid": "10001",
  7. "roleid": "1000601027277819617",
  8. "level": 89,
  9. "viplevel": 8,
  10. "dev_type": null,
  11. "dev_type_name": null,
  12. "dev_id": "1",
  13. "dev_name": "养成项名称",
  14. "dev_openlevel": 20,
  15. "extend1_long": null,
  16. "extend2_long": null,
  17. "extend3_long": null,
  18. "extend1_string": null,
  19. "extend2_string": null,
  20. "extend3_string": null,
  21. "service_code": "MjAwMDAwNDgzMTAwMDgwMDAwMDMxMDAwODAwMzEwMDA4MDAwMDAyMDF8LXw5RDhCMTU0Ni00OEFFLTRBQTEtOTEyMy02NjhGMUEyRDFENUF8LXxpUGhvbmUxMCw2fDEyLjEuMnwxMTI1eDI0MzZ8LXxhcHBsZXwtfDJ8LXw1NjF8MS4wLjN8LXwtfC18MS4wLjN8OTFEOEYyMTUtQzE2OC00NkU0LTg3QjctRTA5NzJBRjg1OUU0fC18LXwxfC18Mi43NkdCfDZ8LXwxNjc3NzIyOF8xfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDlEOEIxNTQ2LTQ4QUUtNEFBMS05MTIzLTY2OEYxQTJEMUQ1QXwtfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDIyMy4xNDYuODUuNHwtfC18LXwxfGlQaG9uZTEwLDZ8MTIuMS4yfDExMjV4MjQzNnwwfDQ2MDAwfDB8YXBwbGV8LXwtfDU2MXx8LXwt",
  22. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891"
  23. }

4.5 BI_union_player (角色公会玩法参与事件)

游戏品类:全品类
上报时机:根据产品工会玩法情况自行决定

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key BI_union_player
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
openid string 必填 平台分配的用户ID 0100010000000000000000000000000155968681
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
clientid string 必填 游戏区服ID 1001
roleid string 必填 角色ID 1000601027277819617
level int 必填 角色当前等级 88
viplevel int 产品级 角色当前VIP等级,各产品根据自身情况决定是否需要,不需要时传空即可 8
union_playe_type_id string 必填 工会玩法类型ID
union_playe_type_name string 必填 工会玩法类型名称
union_id string 必填 工会ID
union_name string 必填 工会名称 工会名称
union_level int 必填 工会当前等级 20
play_times long 产品级 参与次数,具体根据产品工会玩法情况自行确认,无可报空 20
propsid string 产品级 参与玩法获得道具ID,无可传空
propsname string 产品级 参与玩法获得道具名称,无可传空
propscount long 产品级 参与玩法获得道具数量,无可传空
extend1_long long 产品级 扩展参数1,long类型,不用传空即可
extend2_long long 产品级 扩展参数2,long类型,不用传空即可
extend3_long long 产品级 扩展参数3,long类型,不用传空即可
extend1_string string 产品级 扩展参数1,string类型,不用传空即可
extend2_string string 产品级 扩展参数2,string类型,不用传空即可
extend3_string string 产品级 扩展参数3,string类型,不用传空即可
service_code string 必填 平台对于游戏包及设备的特征串 详细介绍接入说明
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891

样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_union_player",
  3. "gameid": "2000003401",
  4. "openid": "0100010000000000000000000000000155968681",
  5. "eventtime": 1445844754000,
  6. "clientid": "10001",
  7. "roleid": "1000601027277819617",
  8. "level": 89,
  9. "viplevel": 8,
  10. "union_playe_type_id": "1001",
  11. "union_playe_type_name": "玩法类型名称",
  12. "union_id": "1",
  13. "union_name": "工会名称",
  14. "union_level": 20,
  15. "play_times": 20,
  16. "propsid": null,
  17. "propsname": null,
  18. "propscount": null,
  19. "extend1_long": null,
  20. "extend2_long": null,
  21. "extend3_long": null,
  22. "extend1_string": null,
  23. "extend2_string": null,
  24. "extend3_string": null,
  25. "service_code": "MjAwMDAwNDgzMTAwMDgwMDAwMDMxMDAwODAwMzEwMDA4MDAwMDAyMDF8LXw5RDhCMTU0Ni00OEFFLTRBQTEtOTEyMy02NjhGMUEyRDFENUF8LXxpUGhvbmUxMCw2fDEyLjEuMnwxMTI1eDI0MzZ8LXxhcHBsZXwtfDJ8LXw1NjF8MS4wLjN8LXwtfC18MS4wLjN8OTFEOEYyMTUtQzE2OC00NkU0LTg3QjctRTA5NzJBRjg1OUU0fC18LXwxfC18Mi43NkdCfDZ8LXwxNjc3NzIyOF8xfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDlEOEIxNTQ2LTQ4QUUtNEFBMS05MTIzLTY2OEYxQTJEMUQ1QXwtfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDIyMy4xNDYuODUuNHwtfC18LXwxfGlQaG9uZTEwLDZ8MTIuMS4yfDExMjV4MjQzNnwwfDQ2MDAwfDB8YXBwbGV8LXwtfDU2MXx8LXwt",
  26. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891"
  27. }

4.6 BI_market_store(交易行流水事件)

游戏品类:MMO品类
上报时机:根据产品工会玩法情况自行决定

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key BI_market_store
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
openid string 必填 平台分配的用户ID 0100010000000000000000000000000155968681
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
clientid string 必填 游戏区服ID 1001
roleid string 必填 角色ID 1000601027277819617
level int 必填 角色当前等级 88
viplevel int 产品级 角色当前VIP等级,各产品根据自身情况决定是否需要,不需要时传空即可 8
propsid string 必填 道具ID
propsname string 必填 道具名称
propsprice int 必填 道具单价
propscount int 必填 道具数量
trans_type string 必填 交易的类型:上架=1 购买=2
trans_ok string 必填 是否成功,不成功=1,成功=2
extend1_long long 产品级 扩展参数1,long类型,不用传空即可
extend2_long long 产品级 扩展参数2,long类型,不用传空即可
extend3_long long 产品级 扩展参数3,long类型,不用传空即可
extend1_string string 产品级 扩展参数1,string类型,不用传空即可
extend2_string string 产品级 扩展参数2,string类型,不用传空即可
extend3_string string 产品级 扩展参数3,string类型,不用传空即可
service_code string 必填 平台对于游戏包及设备的特征串 详细介绍接入说明
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891

样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_market_store",
  3. "gameid": "2000003401",
  4. "openid": "0100010000000000000000000000000155968681",
  5. "eventtime": 1445844754000,
  6. "clientid": "10001",
  7. "roleid": "1000601027277819617",
  8. "level": 89,
  9. "viplevel": 8,
  10. "propsid": "1001",
  11. "propsname": "道具名称",
  12. "propsprice": 100,
  13. "propscount": 20,
  14. "trans_type": "2",
  15. "trans_ok": "2",
  16. "extend1_long": null,
  17. "extend2_long": null,
  18. "extend3_long": null,
  19. "extend1_string": null,
  20. "extend2_string": null,
  21. "extend3_string": null,
  22. "service_code": "MjAwMDAwNDgzMTAwMDgwMDAwMDMxMDAwODAwMzEwMDA4MDAwMDAyMDF8LXw5RDhCMTU0Ni00OEFFLTRBQTEtOTEyMy02NjhGMUEyRDFENUF8LXxpUGhvbmUxMCw2fDEyLjEuMnwxMTI1eDI0MzZ8LXxhcHBsZXwtfDJ8LXw1NjF8MS4wLjN8LXwtfC18MS4wLjN8OTFEOEYyMTUtQzE2OC00NkU0LTg3QjctRTA5NzJBRjg1OUU0fC18LXwxfC18Mi43NkdCfDZ8LXwxNjc3NzIyOF8xfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDlEOEIxNTQ2LTQ4QUUtNEFBMS05MTIzLTY2OEYxQTJEMUQ1QXwtfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDIyMy4xNDYuODUuNHwtfC18LXwxfGlQaG9uZTEwLDZ8MTIuMS4yfDExMjV4MjQzNnwwfDQ2MDAwfDB8YXBwbGV8LXwtfDU2MXx8LXwt",
  23. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891"
  24. }

4.7 角色自定义事件

事件上报级别:产品级,各产品根据需求通过该事件补充基础事件无法满足的角色维度事件
上报时机:根据产品情况自行决定
其中...标识可以传自定义的参数key,参数类型仅限数字和字符串两种JSON标准的格式,自定义参数key的格式最大不应超过15个

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key,必须以BI_custom_role_开头,不可与其他事件的eventkey重复,长度限制在50个字符以内 BI_custom_role_gachas_get
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
openid string 必填 平台分配的用户ID 0100010000000000000000000000000155968681
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
clientid string 必填 游戏区服ID 1001
roleid string 必填 角色ID 1000601027277819617
level int 必填 角色当前等级 88
viplevel int 产品级 角色当前VIP等级,各产品根据自身情况决定是否需要,不需要时传空即可 8
service_code string 必填 平台对于游戏包及设备的特征串 详细介绍接入说明
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891
可以传自定义的参数key及值,参数类型仅限数字和字符串两种JSON标准的格式,自定义参数key的个数最大不应超过15个

样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_custom_role_gachas_get",
  3. "gameid": "2000003401",
  4. "openid": "0100010000000000000000000000000155968681",
  5. "eventtime": 1445844754000,
  6. "clientid": "10001",
  7. "roleid": "1000601027277819617",
  8. "level": 89,
  9. "viplevel": 8,
  10. "service_code": "MjAwMDAwNDgzMTAwMDgwMDAwMDMxMDAwODAwMzEwMDA4MDAwMDAyMDF8LXw5RDhCMTU0Ni00OEFFLTRBQTEtOTEyMy02NjhGMUEyRDFENUF8LXxpUGhvbmUxMCw2fDEyLjEuMnwxMTI1eDI0MzZ8LXxhcHBsZXwtfDJ8LXw1NjF8MS4wLjN8LXwtfC18MS4wLjN8OTFEOEYyMTUtQzE2OC00NkU0LTg3QjctRTA5NzJBRjg1OUU0fC18LXwxfC18Mi43NkdCfDZ8LXwxNjc3NzIyOF8xfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDlEOEIxNTQ2LTQ4QUUtNEFBMS05MTIzLTY2OEYxQTJEMUQ1QXwtfC18OUQ4QjE1NDYtNDhBRS00QUExLTkxMjMtNjY4RjFBMkQxRDVBfDIyMy4xNDYuODUuNHwtfC18LXwxfGlQaG9uZTEwLDZ8MTIuMS4yfDExMjV4MjQzNnwwfDQ2MDAwfDB8YXBwbGV8LXwtfDU2MXx8LXwt",
  11. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891",
  12. "gacha_lists":"11,222,2223",
  13. "gacha_id":"222",
  14. "gacha_type":"1"
  15. }

4.8 区服自定义事件

事件上报级别:产品级,各产品根据需求通过该事件补充基础事件无法满足的区服维度(非角色维度)的事件
上报时机:根据产品情况自行决定
其中...标识可以传自定义的参数key,参数类型仅限数字和字符串两种JSON标准的格式,自定义参数key的格式最大不应超过15个

参数名 参数类型 是否必填 描述 示例
eventkey string 必填 事件key,必须以BI_custom_server_开头,不可与其他事件的eventkey重复,长度限制在50个字符以内 BI_custom_server_gachas_get
gameid string 必填 产品在某个发行地区的ID,由平台分配 2000003401
eventtime long 必填 事件发生时间戳(毫秒) 1445844754000
clientid string 必填 游戏区服ID 1001
uniquekey string 必填 每条日志的唯一标识,建议使用uuid d8b7cd90-06a3-4df5-8543-c9df64b0a891
可以传自定义的参数key及值,参数类型仅限数字和字符串两种JSON标准的格式,自定义参数key的个数最大不应超过15个

样例(为展示方便,样例换行展示,实际中需要每条日志一行)

  1. {
  2. "eventkey": "BI_custom_server_gachas_get",
  3. "gameid": "2000003401",
  4. "eventtime": 1445844754000,
  5. "clientid": "10001",
  6. "uniquekey": "d8b7cd90-06a3-4df5-8543-c9df64b0a891",
  7. "gacha_lists":"11,222,2223",
  8. "gacha_id":"222",
  9. "gacha_type":"1"
  10. }