外观
基础事件上报
1076 字约 4 分钟
2026-08-24
埋点设计文档与事件 Demo
相关信息
该版本的上报接口删除了 appid 字段，改用 appKey 来管理和识别项目数据，增强了数据来源的安全性校验。
在开始对接前，需要先阅读数据上报规则，在熟悉彩虹的数据格式与数据规则后，再阅读本指南进行对接。
appKey 获取方式：
- 彩虹系统：
http://www.datapool-ymjh.cn/ - 进入彩虹系统 -> 系统管理 -> 系统接入，找到对应的项目并复制 AppKey。
上报地址：
- 验证地址：
https://jdlogs.datapool-ymjh.cn/v2/real_time/debug（数据不入库，只验证数据是否在埋点内） - 正式地址：
https://jdlogs.datapool-ymjh.cn/v2/sync_json - 请求方式：POST
- 请求数据类型：application/json
提示
字体颜色红色必传，橙色为基础的字段，没有可以为空值，自定义字段不带 $。
以下为基础事件的 JSON 上报 Demo。
1. 注册（register）
{
"appKey":"xxxxxxxxxxxxxxxxxxxx",
"data":[
{
"$account_id":"oONoI5WzrUWCJ94S3IqzTKbRxWQw",
"$distinct_id":"e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$type":"track",
"$event_time": "2023-05-27 09:36:40",
"$event_name": "register",
"properties":{
"$lib": "wx-minigame",
"$lib_version": "1.0",
"$channel": "1091",
"$scene": "1037",
"$ad_type": "1",
"$role_id": "32985218108",
"$server_id": "326",
"$role_name": "特工218108",
"$role_level": 76,
"$os_version": "Android 11",
"$device_id": "e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$device_model": "M2012K11AC",
"$lib_version": "1.0.0",
"$os": "android",
"$app_version": "1.7.1"
}
}
]
}2. 角色创建（role_create）
{
"appKey":"xxxxxxxxxxxxxxxxxxxx",
"data":[
{
"$account_id":"oONoI5WzrUWCJ94S3IqzTKbRxWQw",
"$distinct_id":"e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$type":"track",
"$event_time": "2023-05-27 09:36:40",
"$event_name": "role_create",
"properties":{
"$lib": "wx-minigame",
"$lib_version": "1.0",
"$channel": "1091",
"$scene": "1037",
"$ad_type": "1",
"$role_id": "32985218108",
"$server_id": "326",
"$role_name": "特工218108",
"$role_level": 76,
"$os_version": "Android 11",
"$device_id": "e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$device_model": "M2012K11AC",
"$lib_version": "1.0.0",
"$os": "android",
"$app_version": "1.7.1"
}
}
]
}3. 账号登录（login）
{
"appKey":"xxxxxxxxxxxxxxxxxxxx",
"data":[
{
"$account_id":"oONoI5WzrUWCJ94S3IqzTKbRxWQw",
"$distinct_id":"e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$type":"track",
"$event_time": "2023-05-27 09:36:40",
"$event_name": "login",
"properties":{
"$lib": "wx-minigame",
"$lib_version": "1.0",
"$channel": "1091",
"$scene": "1037",
"$ad_type": "1",
"$role_id": "32985218108",
"$server_id": "326",
"$role_name": "特工218108",
"$role_level": 76,
"$os_version": "Android 11",
"$device_id": "e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$device_model": "M2012K11AC",
"$lib_version": "1.0.0",
"$os": "android",
"$app_version": "1.7.1"
}
}
]
}4. 角色登录（role_login）
{
"appKey":"xxxxxxxxxxxxxxxxxxxx",
"data":[
{
"$account_id":"oONoI5WzrUWCJ94S3IqzTKbRxWQw",
"$distinct_id":"e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$type":"track",
"$event_time": "2023-05-27 09:36:40",
"$event_name": "role_login",
"properties":{
"$lib": "wx-minigame",
"$lib_version": "1.0",
"$channel": "1091",
"$scene": "1037",
"$ad_type": "1",
"$role_id": "32985218108",
"$server_id": "326",
"$role_name": "特工218108",
"$role_level": 76,
"$os_version": "Android 11",
"$device_id": "e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$device_model": "M2012K11AC",
"$lib_version": "1.0.0",
"$os": "android",
"$app_version": "1.7.1"
}
}
]
}5. 账号登出（logout）
{
"appKey":"xxxxxxxxxxxxxxxxxxxx",
"data":[
{
"$account_id":"oONoI5WzrUWCJ94S3IqzTKbRxWQw",
"$distinct_id":"e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$type":"track",
"$event_time": "2023-05-27 09:36:40",
"$event_name": "logout",
"properties":{
"$lib": "wx-minigame",
"$lib_version": "1.0",
"$channel": "1091",
"$scene": "1037",
"$ad_type": "1",
"$role_id": "32985218108",
"$server_id": "326",
"$role_name": "特工218108",
"$role_level": 76,
"$os_version": "Android 11",
"$device_id": "e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$device_model": "M2012K11AC",
"$lib_version": "1.0.0",
"$os": "android",
"$app_version": "1.7.1",
"online_duration": 2000
}
}
]
}6. 角色登出（role_logout）
{
"appKey":"xxxxxxxxxxxxxxxxxxxx",
"data":[
{
"$account_id":"oONoI5WzrUWCJ94S3IqzTKbRxWQw",
"$distinct_id":"e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$type":"track",
"$event_time": "2023-05-27 09:36:40",
"$event_name": "role_logout",
"properties":{
"$lib": "wx-minigame",
"$lib_version": "1.0",
"$channel": "1091",
"$scene": "1037",
"$ad_type": "1",
"$role_id": "32985218108",
"$server_id": "326",
"$role_name": "特工218108",
"$role_level": 76,
"$os_version": "Android 11",
"$device_id": "e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$device_model": "M2012K11AC",
"$lib_version": "1.0.0",
"$os": "android",
"$app_version": "1.7.1",
"online_duration": 2000
}
}
]
}7. 设备启动（device_start）
{
"appKey":"xxxxxxxxxxxxxxxxxxxx",
"data":[
{
"$account_id":"oONoI5WzrUWCJ94S3IqzTKbRxWQw",
"$distinct_id":"e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$type":"track",
"$event_time": "2023-05-27 09:36:40",
"$event_name": "device_start",
"properties":{
"$lib": "wx-minigame",
"$lib_version": "1.0",
"$channel": "1091",
"$scene": "1037",
"$ad_type": "1",
"$role_id": "32985218108",
"$server_id": "326",
"$role_name": "特工218108",
"$role_level": 76,
"$os_version": "Android 11",
"$device_id": "e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$device_model": "M2012K11AC",
"$lib_version": "1.0.0",
"$os": "android",
"$app_version": "1.7.1"
}
}
]
}8. 订单完成（order_finish）
{
"appKey":"xxxxxxxxxxxxxxxxxxxx",
"data":[
{
"$account_id":"oONoI5WzrUWCJ94S3IqzTKbRxWQw",
"$distinct_id":"e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$type":"track",
"$event_time": "2023-05-27 09:36:40",
"$event_name": "order_finish",
"properties":{
"$lib": "wx-minigame",
"$lib_version": "1.0",
"$channel": "1091",
"$scene": "1037",
"$ad_type": "1",
"$role_id": "32985218108",
"$server_id": "326",
"$role_name": "特工218108",
"$role_level": 76,
"$os_version": "Android 11",
"$device_id": "e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$device_model": "M2012K11AC",
"$lib_version": "1.0.0",
"$os": "android",
"$app_version": "1.7.1",
"pay_method": "weixin",
"pay_amount": 168,
"product_price": 168,
"is_first_pay": 0,
"order_id": "20230527093627HRIEHLEJDHR",
"product_id": "500168",
"product_name": "欢乐168大礼包"
}
}
]
}9. 任务流水（task_flow）
{
"appKey":"xxxxxxxxxxxxxxxxxxxx",
"data":[
{
"$account_id":"oONoI5WzrUWCJ94S3IqzTKbRxWQw",
"$distinct_id":"e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$type":"track",
"$event_time": "2023-05-27 09:36:40",
"$event_name": "task_flow",
"properties":{
"$lib": "wx-minigame",
"$lib_version": "1.0",
"$channel": "1091",
"$scene": "1037",
"$ad_type": "1",
"$role_id": "32985218108",
"$server_id": "326",
"$role_name": "特工218108",
"$role_level": 76,
"$os_version": "Android 11",
"$device_id": "e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$device_model": "M2012K11AC",
"$lib_version": "1.0.0",
"$os": "android",
"$app_version": "1.7.1",
"task_type": "新手嘉年华",
"task_id": "204",
"task_status": "3",
"task_name": "累计登陆3天"
}
}
]
}10. 道具、货币变化（item_flow）
{
"appKey":"xxxxxxxxxxxxxxxxxxxx",
"data":[
{
"$account_id":"oONoI5WzrUWCJ94S3IqzTKbRxWQw",
"$distinct_id":"e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$type":"track",
"$event_time": "2023-05-27 09:36:40",
"$event_name": "item_flow",
"properties":{
"$lib": "wx-minigame",
"$lib_version": "1.0",
"$channel": "1091",
"$scene": "1037",
"$ad_type": "1",
"$role_id": "32985218108",
"$server_id": "326",
"$role_name": "特工218108",
"$role_level": 76,
"$os_version": "Android 11",
"$device_id": "e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$device_model": "M2012K11AC",
"$lib_version": "1.0.0",
"$os": "android",
"$app_version": "1.7.1",
"item_name": "钻石",
"item_id": "10002",
"item_type": "7",
"change_type": "3",
"change_reason": "充值",
"change_num": 2000,
"change_before": 200,
"change_after": 2200
}
}
]
}11. 升级日志（level_up）
{
"appKey":"xxxxxxxxxxxxxxxxxxxx",
"data":[
{
"$account_id":"oONoI5WzrUWCJ94S3IqzTKbRxWQw",
"$distinct_id":"e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$type":"track",
"$event_time": "2023-05-27 09:36:40",
"$event_name": "level_up",
"properties":{
"$lib": "wx-minigame",
"$lib_version": "1.0",
"$channel": "1091",
"$scene": "1037",
"$ad_type": "1",
"$role_id": "32985218108",
"$server_id": "326",
"$role_name": "特工218108",
"$role_level": 76,
"$os_version": "Android 11",
"$device_id": "e67c91e4-0e8e-4701-9019-d2fdffc27211",
"$device_model": "M2012K11AC",
"$lib_version": "1.0.0",
"$os": "android",
"$app_version": "1.7.1"
}
}
]
}PostMan 文件（导入）
可导入以下 PostMan 集合文件，用于调试上报接口：