# 一、上报KAFKA
具体可以跟数据平台部沟通,数据平台部会根据上报方服务器的云厂商类型和城市,提供对应的kafka地址和topic。
# 二、数据格式
{
"user_ip": "58.23.31.237",
"dev_os": "minigame_android",
"product_owner": "1",
"timezone": "8",
"role_level": "300",
"from_ch": "0",
"opt_obj": "2025-09-03 21:30:49",
"sdk_name": "ods_dhgs",
"ad_channel": "0",
"ad_subchannel": "0",
"zid": "0",
"sid": "1001",
"record_id": "10010000001960553",
"log_type": "custom",
"account_id": "2100187629",
"event_type": "douyin_task_onhook",
"role_id": "10010000000020174",
"user_id": "10010000000020174",
"product_id": "游戏的产品ID",
"record_time": "2025-09-03 09:34:46",
"dev_uuid": "uuid",
"source_name": "dh_ods",
"extend_param_json": "{\"send_time\":\"2025-09-03 21:30:49\",\"tmp_id\":\"xxx\",\"open_id\":\"xxxx\",\"data\":\"内容自己定义,格式可以是个json\",\"page\":\"非必填\",\"miniprogram_state\":\"非必填\",\"scene\":\"1\"}"
}
字段说明:
| 字段名 | 是否必填 | 字段说明 |
|---|---|---|
| user_ip | 否 | 玩家设备IP,没有可填空值 |
| dev_os | 是 | 设备系统类型。假如是微信平台,可以传:minigame_android、minigame_ios、minigame_devtools |
| product_owner | 是 | 写死填1 |
| timezone | 是 | 时区 |
| role_level | 否 | 角色等级。没有则填空 |
| from_ch | 是 | 主渠道号:微信小游戏=1398,抖音小游戏=3438 |
| opt_obj | 是 | 消息预期发送时间 |
| sdk_name | 是 | 填固定值:ods_dhgs |
| ad_channel | 是 | 一级渠道号 |
| ad_subchannel | 是 | 二级渠道号 |
| zid | 是 | 区ID |
| sid | 是 | 服务器ID |
| record_id | 是 | 数据记录的唯一ID标识。可以使用上报数据的哈希值,或格式自己定义 |
| log_type | 是 | 写死固定值:custom |
| account_id | 是 | 电魂账号ID |
| event_type | 是 | 格式示例:msg_subscribe_事件名称,具体事件名称自己定义。 |
| role_id | 是 | 玩家角色ID |
| user_id | 是 | 游戏内用于唯一标识一个玩家的ID,一个user_id可能对应多个role_id(角色ID),若游戏无此概念,此处可以填account_id相同值 |
| product_id | 是 | 游戏的产品ID |
| record_time | 是 | 日志上报的时间,格式:2025-09-03 09:34:46 |
| dev_uuid | 是 | 设备唯一标识ID |
| source_name | 是 | 固定值:dh_ods |
| tmp_id | 是 | 订阅消息模板ID。字段放在 extend_param_json 字段里 |
| open_id | 是 | 小游戏openId 字段放在 extend_param_json 字段里 |
| data | 非必填 | 模板内容,非必要信息。微信小游戏格式形如 {"key1": { "value": any}, "key2": { "value": any}} 字段放在 extend_param_json 字段里 |
| page | 非必填 | 点击模板卡片后的跳转页面,仅限本小程序内的页面。支持带参数,(示例 index?foo=bar)。该字段不填则模板无跳转。 字段放在 extend_param_json 字段里 |
| miniprogram_state | 非必填 | 跳转小程序类型:developer 为开发版;trial 为体验版;formal 为正式版;默认为正式版 字段放在 extend_param_json 字段里 |
| scene | 是 | 1:一次性; 2:系统性 字段放在 extend_param_json 字段里 |
如有其他额外需要上报的字段,都可以放在 extend_param_json 字段里