激励视频是一种全屏播放的视频广告，一般展示场景是用户需要游戏复活、解锁游戏关卡、获得享受应用中的某些功能时由用户选择观看激励视频广告并获得相应激励。未经用户允许时(如未点击播放按钮)不能自动播放激励视频，用户可以在观看完整的视频后获取奖励。
支持的广告尺寸： 全屏横屏(宽高比16:9)、全屏竖屏(宽高比9:16)
使用初始化后的TTAdManager对象，创建广告请求对象TTAdNative
构建广告请求参数AdSlot
接口 | 是否必填 | 类型 | 含义 |
setCodeId() | 是 | String | 您在平台上申请的代码位Id，9开头9位数字 |
setAdLoadType() | 否 | TTAdLoadType | 用于标注此次的广告请求用途为预加载（当做缓存）还是实时加载，方便后续为开发者优化相关策略 |
setMediaExtra() | 否 | String | 用户透传信息，仅支持单个json对象格式，不可以嵌套json对象 |
调用TTAdNative.loadRewardVideoAd（adSlot, adLoadListener) 加载广告，在 onRewardVideoCached 方法中获取到TTRewardVideoAd对象后，调用showRewardVideoAd方法展示广告。
方法 | 说明 |
onError(int code, String message) | 若加载中出错，会回调此方法 |
onRewardVideoAdLoad(TTRewardVideoAd ad) | 广告基础信息加载完成，此方法是回调后是广告可调用展示的最早时机 |
onRewardVideoCached(TTRewardVideoAd ad) | 广告基础信息与素材缓存完成，此时调用广告展示流畅，是展示广告的最理想时机 |
方法 | 说明 |
showRewardVideoAd(Activity activity) | 展示广告 |
getExpirationTimestamp() | 获取广告过期时间戳，若超过这个时间点，此广告视为过期 |
setRewardAdInteractionListener(RewardAdInteractionListener listener) | 设置广告交互监听，监听广告的展示，跳过，奖励发放，退出等行为 |
setDownloadListener(TTAppDownloadListener listener) | 监听广告触发的应用下载进度与状态 |
在获取到TTRewardVideoAd对象之后，展示广告之前调用ad.setRewardAdInteractionListener设置广告交互监听器。可监听广告的展示，跳过，奖励发放，退出等行为，开发者可进行相应逻辑处理。
方法名 | 方法介绍 |
onAdShow() | 广告的展示回调 |
onAdVideoBarClick() | 广告的点击回调 |
onAdClose() | 广告的关闭回调 |
onVideoComplete() | 广告素材播放完成 |
onVideoError() | 广告素材展示时出错 |
onRewardArrived(boolean isRewardValid, int rewardType, Bundle extraInfo) | 奖励验证回调，开发者在需要在此回调中做奖励的发放 从extraInfo里取RewardName或者RewardAmount再进行处理 |
onSkippedVideo() | 跳过视频播放回调 |
在获取到TTRewardVideoAd对象之后，展示广告之前，调用setDownloadListener设置下载状态监听下载进度和状态；
穿山甲激励广告支持「在广告中显示奖励内容」功能，根据开发者配置的奖励物品和数量，在激励视频广告播放过程中提示用户完成激励任务后将获取的奖励收益，以激发用户兴趣、观看更完整的视频广告，提升整体的CTR和收入。
若想使用此功能，需在创建激励视频代码位时配置开启“在广告中显示奖励内容”开关。开启后您设置的奖励物品名称、奖励数量会基于模版优选逻辑将有可能在广告播放过程中展示。开发者可以通过以下两种方案配置具体显示的奖励内容。
方案一：在穿山甲平台-代码位创编页面输入奖励名称和数量。
方案二(优先级较高)：在请求广告时使用setRewardAmount与setRewardName方法传入奖励名称和数量，详见文档「接口改动」部分。
P1:方案一 P2:方案二
为满足开发者对激励视频奖励发放逻辑处理，穿山甲广告变现为开发者提供了客户端和服务端奖励下发回调校验功能，开发者可基于此功能对满足奖励发放条件的用户进行发放奖励。
纯视频激励视频：
一般视频时长为5~60s，可通过观看足够视频时长获取奖励，奖励回调下发时即成功领奖。
互动类激励视频：
一般视频时长为5s~60s，激励倒计时过程中会出现互动玩法。可通过互动完成相应任务（或关闭互动玩法并观看达到计时时长要求）从而获取奖励，奖励回调下发时即成功领奖。
开发者不管使用服务端验证还是客户端验证都可以通过奖励验证回调方法进行奖励发放。
穿山甲根据“奖励发放条件”，直接通过onRewardArrived回调给到开发者客户端是否发放奖励，对接相对简单。奖励验证回调涵盖目前所有激励视频播放异常的场景，包括非用户主动操作导致的视频无法完成播放。
使用示例
接口说明
参数 | 类型 | 说明 |
isRewardValid | boolean | 此次奖励是否有效 |
rewardType | int | 奖励类型：0基础奖励： |
extraInfo | Bundle | 使用key-value存储的其他信息： |
服务器回调是指用户在看完激励视频达到奖励下发条件时，穿山甲服务端会向开发者服务端发送一个验证申请，开发者服务端收到请求后判断是否给用户奖励，返回给穿山甲服务器true/false，最终客户端会通过onRewardArrived回调透传奖励下发结果，开发者根据回调进行奖励发放或者通过服务端接口验证结果进行奖励发放。使用说明详见激励视频交互方式简介&奖励方法说明
联系我们
在线客服智能客服 7*24小时在线
