接口说明
- 请使用小程序/小游戏 appid 参与签名。
- 此接口与 OSDK trackEvent 接口等效。
POST /api/v3/dynamicevent/s2s上报时机
请在事件触发时，从游戏服务端调用此接口进行事件数据上报。
不可通过服务端上报的事件
playerlogin、rewardedvideoadshow、rewardedvideoadclose 广告归因事件。
特殊说明
游戏服务端调用此接口上报事件后，Wefund 会自动将事件属性与游戏客户端通过 OSDK 上报 playerlogin 归因事件的前端自采属性进行拼接后再落库（通过 wx_openid 实现关联），确保游戏服务端与客户端上报的事件的前端自采属性（比如 deviceid、screenwidth、screenheight 等）一致。因此必须确保在客户端上报 playerlogin 事件后，才在服务端上报玩家后续在游戏中的其他事件。
请求参数
下面个别参数名称带#号的，只是参数命名的一部分，不代表其他意思。
参数名称 | 参数类型 | 是否必须 | 位置 | 参数描述 | |
#account_id | string | √ | body | 玩家 openid | |
#type | string | √ | body | 值为：track | |
#uuid | string | √ | body | 每条事件上报记录的唯一 id，格式为 uuid | |
#time | string | √ | body | 事件时间，格式：2025-11-25 16:18:41.88 | |
#event_name | string | √ | body | 事件名称，以字母开头，只能包含：字母（区分大小写）、数字和下划线“_”，长度最大 50 个字符 | |
eventname | string | √ | body | 值为：trace_${小游戏 app_id} | |
properties | object | √ | body | 事件属性对象 | |
vgameappid | string | √ | body | 小游戏 app_id | |
dteventtime | string | √ | body | 事件时间，格式：2025-11-25 16:18:41 | |
timestamp | string | √ | body | 事件时间戳，13 位毫秒 | |
eventid | string | √ | body | 该值必须与 #uuid 相同 | |
envversion | string | √ | body | 测试环境：server_test 正式线上环境：server_prod | |
sdkversion | string | √ | body | 自定义事件上报接口：dynamicevent.s2s.v3 批量自定义事件上报接口：multidynamicevent.s2s.v3 | |
vroleid | string | √ | body | 玩家用户标识；玩家 ID / 角色ID，特别同个用户多区服、多角色的。没有则传空字符串 | |
vrolename | string | √ | body | 玩家昵称、角色名称。没有则传空字符串 | |
wx_openid | string | √ | body | 玩家 openid，微信/抖音小游戏下的 openid | |
unionid | string | √ | body | 微信/抖音小游戏绑定在同一开放平台下的 unionid（获取不到请联系「苏」绑定账号） | |
eventname | string | √ | body | 该值必须与 #event_name 相同 | |
vclientip | string | √ | body | 小游戏用户客户端 IP 或 IPV6（两个 IP 字段至少报一个）。格式举例（只写一个 IP）：218.1.145.212 | |
vclientipv6 | string | √ | body | ||
其他自定义属性（请根据事件埋点 Excel 中自定义属性自行添加） | - | - | body | - | |
响应结果
// 成功
{
"code": 0,
"message": "success"
}错误码
code | 说明 |
450202 | eventname 字段缺失 |
450203 | properties 字段缺失或格式错误 |
450204 | account_id 字段缺失或类型错误 |
450205 | vgameappid 字段缺失或类型错误 |
450206 | 缺少必要字段 |
450207 | 请求格式错误 |
550203 | 后端数仓入库失败，请重试 |
重试请求补录数据
当接口请求超时、错误码 5xxxxx 时（code >= 500000）或 HTTP 状态码为 50x 时，需要重试请求补录数据。
重试请求频率间隔
上报失败时间 T0，最大重试 4 次
第 1 次重试时间：T0 + 2s
第 2 次重试时间：T0 + 6s
第 3 次重试时间：T0 + 14s
第 4 次重试时间：T0 + 30s
