跳到主要内容

激励视频服务器奖励验证

一、服务器奖励介绍​

  • 服务器奖励（S2S)：在用户观看完视频后，TradPlus服务端会向您的服务器回调奖励信息。

  • 为保证服务器激励的准确性，建议开发者优先使用三方广告平台的服务器激励回调。对TradPlus Adx和交叉推广，可直接使用TradPlus的服务器激励回调。

二、使用三方广告平台服务器奖励​

  • 1、开发者需要到三方广告平台的后台设置开发者自己服务器的回调URL地址，
  • 2、开发者在代码中通过Tradplus SDK的API传入user_id （用户唯一ID）、custom_data （用户自定义数据). 这些参数最终将通过回调URL通知给开发者
  • 3、当用户看完激励视频时，三方广告平台将通过设置的回调URL地址通知开发者，由开发者自行判断并下发奖励

支持透传的平台列表​

  • user_id（用户唯一ID）可以使用账户系统或者该APP打开后，自动生成一个UUID，来标识该用户的唯一标识。
  • custom_data（用户自定义数据）要根据三方要求传递信息。（不同广告平台会有不同的要求。）
广告平台
说明
CSJ需要后台登录
Sigmobhttps://doc.sigmob.com/Sigmob%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97/SDK%E9%9B%86%E6%88%90%E8%AF%B4%E6%98%8E/HarmonyOS/%E5%B9%BF%E5%91%8A%E7%B1%BB%E5%9E%8B/%E6%BF%80%E5%8A%B1%E8%A7%86%E9%A2%91/#%E6%9C%8D%E5%8A%A1%E7%AB%AF%E5%9B%9E%E8%B0%83%E8%AF%B4%E6%98%8E
华为https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ads-publisher-service-reward-V5#section105579111522
快手需要后台登录

三、使用 TradPlus 服务器奖励​

使用流程​

  • 1、开发者需要在 TradPlus 后台的激励视频广告位上选择服务端奖励回调，并设置回调URL地址
  • 2、开发者需要在代码中通过TradPlus SDK的API传入UserID（用户唯一ID）、CustomData（用户自定义数据). 这些参数最终将通过回调URL通知开发者
  • 3、当用户看完激励视频时，TradPlus服务器将通过设置的回调URL地址通知开发者，由开发者自行判断并下发奖励

服务器接入指南​

  • 1、开发者需要在 TradPlus 后台的激励视频广告位中打开服务器奖励，并设置开发者服务器奖励的回调URL，示例如下：

  • 2、开发者的回调URL示例如下：
https://www.tp.com/onrewarded
  • 3、TradPlus 服务器 会以 GET 方式请求开发者的回调URL，并拼接以下参数回传：
adsource_id={adsource_id}&app_id={app_id}&extra={extra}&ilrd={ilrd}&network_id={network_id}&reward_name={reward_name}&reward_number={reward_number}&scene_id={scene_id}&sign={sign}&trans_id={trans_id}&unit_id={unit_id}&user_id={user_id}
参数说明
{adsource_id}三方广告网络的广告位ID
{app_id}TradPlus 应用ID
{extra}用户自定义业务参数
{ilrd}TradPlus SDK 回调的展示级别数据
{network_id}TradPlus 三方广告网络ID
{reward_name}奖励名称
{reward_number}奖励数量
{scene_id}TradPlus 广告场景ID
{sign}签名信息
{trans_id}TradPlus 生成的唯一交易 ID
{unit_id}TradPlus 广告位id
{user_id}用户id
  • 4、sign 签名规则说明

开发者在收到 TradPlus 的服务器奖励回调时，可以通过sign对回调参数进行校验。

TradPlus 服务器按以下规则生成sign签名

sign = Sha256(SecretKey:TransId)
参数说明示例
SecretKeyTradPlus 激励视频广告位生成的安全密钥D46C4341E83F33DB0DF2BC42816F21B7
TransIdTradPlus 生成的唯一交易IDa78f36ed-95e5-4049-9647-dfc87e6df0e1
sign = Sha256(D46C4341E83F33DB0DF2BC42816F21B7:a78f36ed-95e5-4049-9647-dfc87e6df0e1) = db10d4a82a32597a101841988bbee1bf5f3ebca9a512456817e301d89c721270
  • 5、开发者收到 TradPlus 的服务器奖励回调后，需给 TradPlus 服务器返回 约定参数
参数类型说明
isValidboolean校验结果
codeint状态码
messagestring错误信息

注意： 默认返回的是一个json字符串

示例：

{
    "isValid": true,
    "code": 0,
    "message": "ok"
}
  • 6、TradPlus 服务器发起服务器激励回调后2秒内无响应则视为超时, TradPlus 默认重试3次，如果还超时，则不再向开发者回调URL发起激励回调。

四、TradPlus SDK接入​

需在请求广告前调用API 设置。user_id（用户唯一ID）、custom_data（用户自定义数据)。

必须在请求广告前调用 

this.tpReward?.setServerSideVerificationOptions(userID: string, customData?: string)

五.ILRD参数说明​

回调信息说明