激励视频服务端激励(S2S)说明

服务端激励介绍

服务端到服务端(S2S)回调:帮助开发者判定是否提供奖励给观看广告的用户。当用户成功看完广告时,会向开发者在对应广告平台中配置的验证接口发送验证请求,由开发者来判断此次观看是否给用户发放奖励。
重点说明:

  1. 目前ADmobile不支持服务器激励,使用的均为广告平台的服务器激励。
  2. 本文档所提功能是基于ADmobile ADSuyi SDK v3.1.5 及以上版本。

2. 服务器激励使用流程

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

支持服务器激励的广告平台如下:(可点击跳转到广告平台关于服务器激励的文档说明,不能跳转的请直接登录广告平台后台进行回调URL的设置)

2.1 Android

广告平台 参考网址 备注
Mintegral http://cdn-adn.rayjump.com/cdn-adn/v2/markdown_v2/index.html?file=sdk-m_sdk-android&lang=cn
穿山甲(Pangle) https://www.pangle.cn/union/media/union/download/detail?id=4&docId=5de8d9b725b16b00113af0e5&osType=android#5d15f2
Huawei - 请登录Huawei后台设置回调URL
优量汇 https://developers.adnet.qq.com/doc/android/union/union_reward_video 请登录优量汇 后台设置回调URL

2.2 iOS

广告平台 参考网址 备注
Mintegral http://cdn-adn.rayjump.com/cdn-adn/v2/markdown_v2/index.html?file=sdk-m_sdk-android&lang=cn
穿山甲(Pangle) https://www.pangle.cn/union/media/union/download/detail?id=4&docId=5de8d9b725b16b00113af0e5&osType=android#5d15f2
Huawei - 请登录Huawei后台设置回调URL
优量汇 https://developers.adnet.qq.com/doc/android/union/union_reward_video 请登录优量汇 后台设置回调URL
Vungle https://support.vungle.com/hc/en-us/articles/204374244-Setting-Up-Rewarded-Ads#server-to-server-s2s-callbacks-0-0

3. Admobile Suyi SDK接入

3.1 Suyi Android SDK代码示例

// 创建激励视频广告实例
rewardVodAd = new ADSuyiRewardVodAd(this);//创建激励参数对象
ADSuyiRewardExtra adSuyiRewardExtra = new ADSuyiRewardExtra("userId");
//穿山甲、优量汇渠道支持
adSuyiRewardExtra.setCustomData("额外参数");
adSuyiRewardExtra.setRewardName("激励名称");
//奖励积分数(int)  仅穿山甲渠道支持
adSuyiRewardExtra.setRewardAmount(1);//设置激励参数
rewardVodAd.setLocalExtraParams(new ADSuyiExtraParams.Builder().rewardExtra(adSuyiRewardExtra).build());

3.2 Suyi iOS SDK代码示例

/**
 用户id (用户在App内的userID,用于激励视频服务器验证,如无需服务器验证可不传)
 */
@property (nonatomic, copy, nullable) NSString *userId;
​
/**
 奖励名称 (用于激励视频服务器验证参数,可选)
 */
@property (nonatomic, copy, nullable) NSString *rewardName;
​
/**
 奖励数量 (用于激励视频服务器验证参数,可选)
 */
@property (nonatomic, assign,nullable) NSNumber *rewardAmount;
​
/**
 其他信息 (服务器端验证回调中包含的可选自定义奖励字符串,可选)
 */
@property (nonatomic, copy, nullable) NSString *extraInfo;

由于部分平台不支持服务端验证,可根据以下方法判断是否支持服务端验证:

/**
 激励视频广告是否支持服务端验证
 */
- (BOOL)rewardvodAdCanServerVerrify;

新增激励验证回调:

/**
 视频广告视频达到奖励条件 (开启服务器验证后请使用服务端验证判断是否达到条件,无需使用本回调做激励达成判断,如果聚合包含不支持服务器验证平台,可根据是否支持来使用本回调做本地激励奖励)

 @param rewardvodAd 广告实例
 */
- (void)adsy_rewardvodAdDidRewardEffective:(ADSuyiSDKRewardvodAd *)rewardvodAd;
​
/**
 视频广告激励服务验证成功(需等待服务器返回结果后判断是否激励生效)

 @param rewardvodAd 广告实例
 */
- (void)adsy_rewardvodAdServerDidSucceed:(ADSuyiSDKRewardvodAd *)rewardvodAd;
​
/**
 视频广告完成激励服务验证失败

 @param rewardvodAd 广告实例
 @param errorModel 认证失败错误信息
 */
- (void)adsy_rewardvodAdServerDidFailed:(ADSuyiSDKRewardvodAd *)rewardvodAd errorModel:(ADSuyiAdapterErrorDefine *)errorModel;

results matching ""

    No results matching ""