接口说明
- 请使用小程序/小游戏 appid 参与签名。
- 此接口与 OSDK trackEvent 接口等效。
POST /api/v3/multidynamicevent/s2s上报时机
请在事件触发时，从游戏服务端调用此接口进行批量事件数据上报。
不可通过服务端上报的事件
playerlogin、rewardedvideoadshow、rewardedvideoadclose 广告归因事件。
特殊说明
游戏服务端调用此接口上报事件后，Wefund 会自动将事件属性与游戏客户端通过 OSDK 上报 playerlogin 归因事件的前端自采属性进行拼接后再落库（通过 wx_openid 实现关联），确保游戏服务端与客户端上报的事件的前端自采属性（比如 deviceid、screenwidth、screenheight 等）一致。因此必须确保在客户端上报 playerlogin 事件后，才在服务端上报玩家后续在游戏中的其他事件。
请求参数
参数名称 | 参数类型 | 是否必须 | 位置 | 参数描述 |
payload | array | √ | body | 自定义事件数组，数组元素为自定义事件上报的对象，参数格式请参考【自定义事件上报】接口 |
请求示例
{
"payload": [
{
"#account_id": "openid_example",
"#type": "track",
"#uuid": "550e8400-e29b-41d4-a716-446655440000",
"#time": "2025-11-25 16:18:41.88",
"#event_name": "level_finish",
"eventname": "trace_appid_example",
"properties": {
"vgameappid": "appid_example",
"dteventtime": "2025-11-25 16:18:41",
"timestamp": "1732522721000",
"eventid": "550e8400-e29b-41d4-a716-446655440000",
"envversion": "server_prod",
"sdkversion": "multidynamicevent.s2s.v3",
"vroleid": "role_123456",
"vrolename": "游戏玩家",
"wx_openid": "openid_example",
"unionid": "unionid_123456789",
"eventname": "level_finish",
"vclientip": "x.x.x.x"
}
}
]
}响应结果
// 成功
{
"code": 0,
"message": "批量事件处理成功",
"data": {
"total": 1, // 总条数
"success_count": 1, // 成功条数
"failed_count": 0, // 失败条数
"results": [
{
"index": 0, // 单条索引
"code": 0, // 单条状态码
"message": "success"
}
]
}
}错误码
code | 说明 |
450210 | 批量请求为空 |
450212 | 批处理中某条数据的 eventname 字段缺失（具体第几条错误提示会返回，该情况下，所有数据都不会落库，需要开发者更正数据结构再重试） |
450213 | 批处理中某条 properties 字段缺失或格式错误（具体第几条错误提示会返回，该情况下，所有数据都不会落库，需要开发者更正数据结构再重试） |
450214 | 批处理中某条 account_id 字段缺失或类型错误（具体第几条错误提示会返回，该情况下，所有数据都不会落库，需要开发者更正数据结构再重试） |
450215 | 批处理中某条 vgameappid 字段缺失或类型错误（具体第几条错误提示会返回，该情况下，所有数据都不会落库，需要开发者更正数据结构再重试） |
550203 | 后端数仓入库失败，请重试 |
420207 | 批量请求格式错误 |
420208 | 批量请求超出限制,上限100条 |
520208 | 批量处理部分失败 |
520209 | 批量处理全部失败 |
重试请求补录数据
当接口请求超时、错误码 5xxxxx 时（code >= 500000）或HTTP状态码为50x时，需要重试请求补录数据。请游戏后台保存全量订单数据，便于后续进行补录等操作。
重试请求频率间隔
上报失败时间 T0，最大重试 4 次
第 1 次重试时间：T0 + 2s
第 2 次重试时间：T0 + 6s
第 3 次重试时间：T0 + 14s
第 4 次重试时间：T0 + 30s
