# 一、上报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 字段里

Last Updated: 2026/10/13 14:39:44