简介

激励视频是一种全屏播放的视频广告，用户可以在观看完整的视频后获取奖励,视频广告播放结束后会显示结束页面，引导用户进行后续动作。目前激励视频广告的表现形式为：视频播放完展示Endcard页面、视频播放完展示互动页面或者直接出现互动广告。

激励视频再看一个功能，用户在看完一个激励视频后通过进一步广告互动获取更多APP内激励，有利于用户体验与APP活跃市场，同时开发者也可借助该功能提升激励视频曝光量与收入，详情请参考激励视频再看一个 广告介绍。

支持的广告尺寸： 全屏横屏(宽高比16:9)、全屏竖屏(宽高比9:16)

权限

模板渲染激励视频： 默认开放

SDK渲染激励视频： 已回收，不再提供创建

激励视频再看一个：需要白名单权限，请联系BD开启，要求SDK版本 >=4300

激励视频进阶奖励：SDK版本 >=4400

代码位ID创建参数说明：

• 开发者根据展示场景勾选视频播放方向：横版or竖版
• 奖励名称和奖励数量依据自身项目需求设置即可，例如：奖励名称为金币，奖励数量：1000
• 奖励发放设置：
• 当选择无需服务器判断时，开发者可以根据客户端nativeExpressRewardedVideoAdServerRewardDidSucceed回调进行奖励的发放。
• 当选择需要服务器判断时，开发者需要按照以下要求进行接口开发，并在平台上填写回调URL。服务器回调是指在用户在看完激励视频达到奖励条件时，穿山甲服务端会向开发者服务端发送一个验证申请，开发者服务端收到请求后判断是否给用户奖励，返回给穿山甲服务器true/false，最终客户端会给出nativeExpressRewardedVideoAdServerRewardDidSucceed回调，开发者根据回调进行奖励发放，或者通过服务端接口验证结果进行奖励发放。

奖励发放机制

奖励发放逻辑可参考此文档： Link

服务端回调说明

服务器到服务器回调让您判定是否提供奖励给观看广告的用户。当用户成功看完广告时，会向您在穿山甲平台中配置的验证接口发送验证请求，由开发者来判断此次观看是否给用户发放奖励。

重点说明： 穿山甲服务端只是透传验证请求，不会在中间过程添加校验逻辑。为了保障开发者利益和用户体验，开发者可以在验证环节增加自己的校验逻辑。

回调方式说明

穿山甲服务器会以 GET 方式请求第三方服务的回调链接，并拼接以下参数回传：

签名生成方式：

appSecurityKey: 您在穿山甲媒体平台新建奖励视频代码位获取到的密钥transId：交易id: sign = sha256(appSecurityKey:transId)

Python 示例：

返回约定：

返回 json 数据，字段如下：

回调URL格式事例如下：

注意：

服务器回调模式不是必须的，服务器模式只是增加了一次第三方服务器验证判断，具体的奖励的发放是由客户端完成。

模版激励视频广告

使用说明

模版激励视频使用BUNativeExpressRewardedVideoAd对象调用loadAdData方法请求广告，使用BUNativeExpressRewardedVideoAd对象调用showAdFromRootViewController:展示广告，通过设置BUNativeExpressRewardedVideoAdDelegate代理，获取广告、展示、点击、关闭等回调。

创建广告位对象、请求广告

BUNativeExpressRewardedVideoAd

请求广告时需要传入广告位对象，广告位对象创建时必须传入广告位ID

必传参数：

可选传入参数：

使用BUNativeExpressRewardedVideoAd创建对象，使用BUNativeExpressRewardedVideoAd调用loadAdDat请求广告

接收广告加载结果

BUNativeExpressRewardedVideoAdDelegate

BUNativeExpressRewardedVideoAdDelegate回调说明

nativeExpressRewardedVideoAdServerRewardDidSucceed 回调说明：

1. 不使用户服务端奖励验证的情况下nativeExpressRewardedVideoAdServerRewardDidSucceed回调只校验视频播放状态或者进度，视频播放90%或者因播放器异常导致出现播放失败，那么穿山甲都会回调nativeExpressRewardedVideoAdServerRewardDidSucceed，并且返回结果为true。
2. 使用服务端奖励验证的情况下nativeExpressRewardedVideoAdServerRewardDidSucceed回调返回的则是开发者服务端验证的结果。

综上： nativeExpressRewardedVideoAdServerRewardDidSucceed 回调只是视频播放状态的一个结果或者是开发者返回的结果，不代表此次播放是否计费等广告业务指标。

通过设置BUNativeExpressRewardedVideoAdDelegate代理，获取广告的点击、关闭、播放完成等回调。其他代理方法可参见BUDExpressRewardedVideoViewController类#pragma mark - BUNativeExpressRewardedVideoAdDelegate

4400版本新增进阶奖励回调参数

// 区分此次奖励的类型，默认为BURewardType_Default

@property (nonatomic, assign) BURewardType rewardType;

typedef NS_ENUM(NSInteger, BURewardType) {    

BURewardType_Default            = 0,       // 基础奖励 (满足观看时长、互动抵时长、playable试完等)    

BURewardType_Interact           = 1,       // 进阶奖励-互动    

BURewardType_VideoComplete      = 2,       // 进阶奖励-超过30s的视频播放完成

};

number of rewards of propose, 0.0 ~ 1.0 (BURewardType_Default: 1). // 建议奖励数量，进阶奖励功能可选

@property (nonatomic, assign) float rewardPropose;

若rewardedVideoAd.rewardedVideoModel.rewardType不为BURewardType_Default时(暂支持BURewardType_Interact、BURewardType_VideoComplete)，即可发奖励，奖励数量可以参考rewardPropose给出的建议。

展示广告

激励视频广告需要让用户主动选择去观看，给用户选择，不能强制用户观看激励视频广告。广告播放完成需要给用户发放相应的奖励。调用showAdFromRootViewController:方法展示激励视频广告，此处需要传入当前展示的页面。一定要设置rootViewController，即展示广告和跳转落地页需要的viewController

展示激励视频广告

展示时机

在收到nativeExpressRewardedVideoAdDidDownLoadVideo回调后再允许用户观看广告，可保证播放流畅和展示流畅，用户体验更好。

广告展示后重新加载广告

同一次请求的广告最多只能计一次展示，重复的展示会被系统过滤。因此建议开发者在用户观看完广告后在nativeExpressRewardedVideoAdDidClose回调里将原来的广告对象置为nil 保证广告对象为新的请求对象

注意事项

1. 必须要设置rootViewController，用来处理广告跳转。SDK里所有的跳转均采用present的方式，请确保传入的rootViewController不能为空且没有present其他的控制器，否则会出现presentedViewController已经存在而导致present失败。
2. 如选择服务器回调方式，请确保userId为NSString类型且不为空，并保证回调URL 格式为

4. nativeExpressRewardedVideoAdViewRenderSuccess渲染成功回调在广告展示后
5. 为保证播放流畅和展示流畅，用户体验更好，在收到nativeExpressRewardedVideoAdDidDownLoadVideo回调后进行广告的展示
6. extra透传参数应为json序列化后的字符串，确保不为空
7. 判断广告是否有效直接使用self.rewardedAd判断即可。目前isAdValid字段已废弃，请不要使用此字段判断广告是否有效
8. 个性化模板广告为了优化展示速度,会使用本地模板,请求时会拦截相关数据.如果接入方正在使用H5的页面发送请求,会造成请求body清空,其他逻辑不变.如果使用body传参请更换其他方式.例如:jsBridge方式。
9. 广告的关闭操作，必须用户主动触发，客户端不能进行代码层面的强制关闭操作

资源

详细接入可参照Demo中的BUDExpressRewardedVideoViewController类，广告加载请求部分可参照loadRewardVideoAdWithSlotID方法，广告展示部分可参照showRewardVideoAd方法

SDK渲染激励视频广告

使用说明

SDK渲染激励视频使用BURewardedVideoAd对象调用loadAdData方法请求广告，使用BURewardedVideoAd对象调用showAdFromRootViewController:展示广告，通过设置BURewardedVideoAdDelegate代理，获取广告、展示、点击、关闭等回调。

创建广告位对象、请求广告

BURewardedVideoAd

请求广告时需要传入广告位对象，广告位对象创建时必须传入广告位ID

每次需要生成新的BURewardedVideoAd对象调用loadAdData方法请求最新激励视频，请勿重复使用本地缓存激励视频多次展示

必传参数：

可选传入参数：

使用BURewardedVideoAd创建对象，使用BURewardedVideoAd调用loadAdData请求广告

接收广告加载结果

BURewardedVideoAdDelegate

BURewardedVideoAdDelegate回调说明

通过设置BURewardedVideoAdDelegate代理，获取广告的点击、关闭、播放完成等回调。其他代理方法可参见BUDRewardedVideoAdViewController类#pragma mark - BURewardedVideoAdDelegate

展示广告

激励视频广告需要让用户主动选择去观看，给用户选择，不能强制用户观看激励视频广告。广告播放完成需要给用户发放相应的奖励。

调用showAdFromRootViewController: 方法展示激励视频广告，此处需要传入当前展示的页面。一定要设置rootViewController，即展示广告和跳转落地页需要的viewController

展示激励视频广告

展示时机

在收到rewardedVideoAdVideoDidLoad回调后再允许用户观看广告，可保证播放流畅和展示流畅，用户体验更好。

广告展示后重新加载广告

同一次请求的广告最多只能计一次展示，重复的展示会被系统过滤。因此建议开发者在用户观看完广告后在rewardedVideoAdDidClose回调里将原来的广告对象置为nil 保证广告对象为新的请求对象

注意事项

1. 必须要设置rootViewController，用来处理广告跳转。SDK里所有的跳转均采用present的方式，请确保传入的rootViewController不能为空且没有present其他的控制器，否则会出现presentedViewController已经存在而导致present失败。
2. 如选择服务器回调方式，请确保userId为NSString类型且不为空，并保证回调URL格式为

3. 为保证播放流畅和展示流畅，用户体验更好，在收到rewardedVideoAdVideoDidLoad回调后进行广告的展示
4. extra透传参数应为json序列化后的字符串，确保不为空
5. 判断广告是否有效直接使用self.rewardedAd判断即可。目前isAdValid字段已废弃，请不要使用此字段判断广告是否有效
6. 广告的关闭操作必须用户主动触发，客户端不能进行代码层面的强制关闭操作

资源

详细接入可参照Demo中的BUDRewardedVideoAdViewController类，广告加载请求部分可参照loadRewardVideoAdWithSlotID:方法，广告展示部分可参照showRewardVideoAd方法