激励视频服务端回调说明

回调请求说明

• MediaPrime服务器会以 GET 方式 请求开发者的回调链接，并拼接以下参数回传：
  user_id=%s&trans_id=%s&reward_name=%s&reward_amount=%d&extra=%s&sign=%s

请求字段定义

字段名称	字段定义	字段类型	备注
user_id	tagid	string	调用 SDK 透传
trans_id	交易id	string	完成观看的唯一交易 ID
reward_amount	奖励数量	int	媒体平台创建广告位时配置的值
reward_name	奖励名称	string	媒体平台创建代码位时配置的名称
extra	Extra	string	调用 SDK 传入并透传，如不需要则为空
sign	签名	string	签名验证字段

回调链接示例

https://xxxx.com/xxx/xxx

此回调链接需要媒体配置在MediaPrime系统的激励视频广告位中。 回调请求示例为https://xxxx.com/xxx/xxx?user_id=123&trans_id=abc...

---

签名生成方式

1. appSecurityKey: 在MediaPrime媒体平台新建激励视频广告位时获取的密钥
2. transId: 交易 id
3. 签名公式:
   sign = sha256(appSecurityKey:transId)

---

约定返回参数

响应要求

• 回调URL需响应 JSON字符串，默认返回示例：

  {"isValid": true}
  
  

响应字段定义

字段名称	字段定义	字段类型	备注
isValid	校验结果	bool	判定结果，是否发放奖励

注意事项

1. 签名验证

   • 若签名验证失败，需返回 {"isValid": false}。

2. 安全要求

   • 生产环境必须使用 HTTPS 回调链接。

3. 日志记录

   • 建议开发者记录完整的回调请求和响应日志，便于排查问题。