Skip to main content

激励视频服务器奖励验证

一. 服务器奖励介绍#

服务器奖励(S2S):在用户观看完视频后,TradPlus服务端会向您的服务器回调奖励信息。TradPlus Android SDK >= 7.9 和 iOS SDK >=7.5支持。

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

二. 使用三方广告平台服务器奖励#

1、开发者需要到三方广告平台的后台设置开发者自己服务器的回调URL地址,

2、开发者在代码中通过Tradplus SDK的API传入UserID (用户唯一ID)、CustomData (用户自定义数据). 这些参数最终将通过回调URL通知给开发者

3、当用户看完激励视频时,三方广告平台将通过设置的回调URL地址通知开发者,由开发者自行判断并下发奖励

支持透传的平台列表#

  • 穿山甲,Pangle v6.9.0版本,开始支持设置 CustomData
  • Mintegral v7.1.0版本,开始支持设置 CustomData
平台支持参数三方相关文档
MetaUserID;CustomDatahttps://developers.facebook.com/docs/audience-network/guides/setting-up/ad-setup/ios/rewarded-video?locale=zh_CN#--------
AdmobUserID;CustomDatahttps://developers.google.com/admob/ios/ssv#manual_verification_of_rewarded_ssv
AdColonyUserIDhttps://github.com/AdColony/AdColony-iOS-SDK/wiki/Showing-Rewarded-Interstitial-Ads#server-side-rewards
AppLovinUserIDhttps://dash.applovin.com/documentation/mediation/s2s-rewarded-callback-api
MintegralUserID; CustomData ( v7.1.0+ )http://cdn-adn.rayjump.com/cdn-adn/v2/markdown_v2/index.html?file=sdk-m_sdk-ios&lang=cn
UnityUserIDhttps://docs.unity.com/ads/zh-cn/manual/ImplementingS2SRedeemCallbacks
SigmobUserIDhttps://doc.sigmob.com/#/ToBid%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97/%E9%AB%98%E7%BA%A7%E5%8A%9F%E8%83%BD%E8%AF%B4%E6%98%8E/%E6%BF%80%E5%8A%B1%E8%A7%86%E9%A2%91%E6%9C%8D%E5%8A%A1%E7%AB%AF%E9%AA%8C%E8%AF%81/?id=_1%E6%BF%80%E5%8A%B1%E8%A7%86%E9%A2%91%E6%9C%8D%E5%8A%A1%E7%AB%AF%E9%AA%8C%E8%AF%81%E4%BB%8B%E7%BB%8D
IronSourceUserIDhttps://developers.is.com/ironsource-mobile/ios/advanced-settings-2/
LiftoffUserIDhttps://support.vungle.com/hc/en-us/articles/204374244-Setting-Up-Rewarded-Ads#server-to-server-s2s-callbacks-0-0
穿山甲UserID; customData ( v6.9.0+ )https://www.csjplatform.com/supportcenter/5416#qk87ovtgvmo0
PangleUserID; customData ( v6.9.0+ )https://www.pangleglobal.com/zh/integration/ios-rewarded-video-ads
腾讯UserID;CustomDatahttps://developers.adnet.qq.com/doc/ios/union/union_reward_video
快手UserID;CustomDatahttps://static.yximgs.com/udata/pkg/KSAdSDKTarGz/doc/ksadsdk-iOS-readme-ad-3.3.18.pdf
百度UserID;CustomDatahttps://union.baidu.com/miniappblog/2020/08/11/iOSSDK/#服务端奖励验证

三. 使用 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?adsource_id={adsource_id}&sign={sign}&trans_id={trans_id}
  • 3、请参考以下列表,并将需要的宏拼接在回调URL中,TradPlus 服务器会用对应值替换这些宏,并以 GET 方式回调给开发者服务器:
参数说明
{adsource_id}三方广告网络的广告位ID
{app_id}TradPlus 应用ID
{extra}用户自定义业务参数
{network_id}TradPlus 三方广告网络ID
{scene_id}TradPlus 广告场景ID
{sign}签名信息
{trans_id}TradPlus 生成的唯一交易 ID
{unit_id}TradPlus 广告位id
{user_id}用户id
{platform}应用的系统平台(1 Android, 2 iOS
{ts}回调的时间戳
{package_name}应用包名
{device_ifa}设备号(Android: gaid, iOS: idfa)
{device_idfv}iOS idfv
{ip}用户设备 IP
{iso_code}国家编码
{bucket_id}A/B测试组 ID
{segment_id}流量分组 ID
{channel}渠道
{subchannel}子渠道
{ilrd}TradPlus SDK 回调的展示级别数据
{reward_name}奖励名称
{reward_amount}奖励数量
  1. 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
  1. 开发者收到 TradPlus 的服务器奖励回调后,需给 TradPlus 服务器返回 约定参数
参数类型说明
isValidboolean校验结果
codeint状态码
messagestring错误信息

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

示例:

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

四. TradPlus SDK 代码示例#

需在请求广告前调用API 设置。UserID(用户唯一ID)、CustomData(用户自定义数据)。

iOS 接入#

self.rewardedVideoAd = [[TradPlusAdRewarded alloc] init];
self.rewardedVideoAd.delegate = self;
[self.rewardedVideoAd setAdUnitID:@"广告位ID"];
//设置服务器奖励参数
[self.rewardedVideoAd setServerSideVerificationOptionsWithUserID:@"UserID" customData:@"customData"];
//加载广告
[self.rewardedVideoAd loadAd];

Unity3D 接入#

Dictionary rewardedmap = new Dictionary();
rewardedmap.Add("user_id",value);
rewardedmap.Add("custom_data", value);
TradPlus.SetCustomParams("AdUnitId",rewardedmap);
TradPlus.RequestRewardedVideo("AdUnitId");

五.ILRD参数说明#

参数说明 参考 回调信息说明列表