
激励视频是一种全屏播放的视频广告,一般展示场景是用户需要游戏复活、解锁游戏关卡、获得享受应用中的某些功能时由用户选择观看激励视频广告并获得相应激励。
注意事项
支持一键复制实现融合基础功能实现,工具地址。
详细接入可参照demo中的BUMDExpressRewardedVideoViewController类。
方法 | 说明 |
@property (nonatomic, weak, nullable) id<BUNativeExpressRewardedVideoAdDelegate> delegate; | 激励视频协议,聚合维度使用BUMNativeExpressRewardedVideoAdDelegate |
@property (nonatomic, copy, readonly) BUDictionary *mediaExt; | 媒体配置参数 |
@property (nonatomic, assign, readonly) BOOL materialMetaIsFromPreload; | 默认是否此字段的值在下载成功后才准确聚合维度不支持此接口 |
- (instancetype)initWithSlotID:(NSString *)slotID rewardedVideoModel:(BURewardedVideoModel *)model; | 创建广告对象参数 |
- (instancetype)initWithSlot:(BUAdSlot *)slot rewardedVideoModel:(BURewardedVideoModel *)model; | 创建广告slot参数 |
- (NSString *)getAdCreativeToken; | 物料ID聚合维度不支持 |
- (void)loadAdData; | 加载广告 |
- (BOOL)showAdFromRootViewController:(UIViewController *)rootViewController; | 广告展示回调 |
- (BOOL)showAdFromRootViewController:(UIViewController *)rootViewController ritScene:(BURitSceneType)ritSceneType ritSceneDescribe:(NSString *_Nullable)sceneDescirbe; | |
@property (nonatomic, strong, nullable, readonly) BUExpressRewardedVideoAdMediation *mediation; | 当使用聚合广告位时,存在该属性,可获取聚合维度相关功能 |
方法 | 说明 |
@property (nonatomic, assign, readonly) BOOL isReady; | 是否已经准备广告展示,理论上在广告加载回调后即为YES,但受一些因素的影响(例如广告失效),可能为NO。建议在广告展示前调用该方法进行是否可以展示 |
- (BUMRitInfo *)getShowEcpmInfo; | 返回显示广告对应的披露信息 |
@property (nonatomic, assign, readonly) BOOL isLoading; | 广告是否加载中 |
- (void)addParam:(id)param withKey:(NSString *)key; | 添加参数param 参数值key 参数key |
- (NSArray<BUMAdLoadInfo *> *)getAdLoadInfoList; | 一次waterfall中各adn代码位加载广告失败原因,建议调用时机:展示广告时/超时时/全部返回报错时;返回nil表示一次加载无代码位加载失败或其加载无响应 |
方法 | 方法 |
- (void)nativeExpressRewardedVideoAdDidLoad:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd; | 物料加载成功回调 |
- (void)nativeExpressRewardedVideoAd:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd didFailWithError:(NSError *_Nullable)error; | 加载失败回调 |
- (void)nativeExpressRewardedVideoAdCallback:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd withType:(BUNativeExpressRewardedVideoAdType)nativeExpressVideoType; | 聚合维度不支持此场景 |
- (void)nativeExpressRewardedVideoAdDidDownLoadVideo:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd; | 当缓存成功时调用此方法。为了更好的用户体验,建议在这个时候显示视频广告。调用[BUNativeExpressRewardedVideoAd] showAdFromRootViewController:] |
- (void)nativeExpressRewardedVideoAdViewRenderSuccess:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd; | 渲染成功回调 |
- (void)nativeExpressRewardedVideoAdViewRenderFail:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd error:(NSError *_Nullable)error; | 渲染失败回调 |
- (void)nativeExpressRewardedVideoAdWillVisible:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd; | 广告即将展示 |
- (void)nativeExpressRewardedVideoAdDidVisible:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd; | 广告已经展示 |
- (void)nativeExpressRewardedVideoAdWillClose:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd; | 广告即将关闭 |
- (void)nativeExpressRewardedVideoAdDidClose:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd; | 广告已经关闭 |
- (void)nativeExpressRewardedVideoAdDidClick:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd; | 广告点击回调 |
- (void)nativeExpressRewardedVideoAdDidClickSkip:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd; | 广告跳过回调 |
- (void)nativeExpressRewardedVideoAdDidPlayFinish:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd didFailWithError:(NSError *_Nullable)error; | 广告播放完成回调 |
- (void)nativeExpressRewardedVideoAdServerRewardDidSucceed:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd verify:(BOOL)verify; | 奖励验证回调 |
- (void)nativeExpressRewardedVideoAdServerRewardDidFail:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd error:(NSError *_Nullable)error; | 奖励验证失败回调error:失败原因 |
- (void)nativeExpressRewardedVideoAdDidCloseOtherController:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd interactionType:(BUInteractionType)interactionType; | 此方法在另一个控制器关闭时调用。 interactionType:在app中打开appstore或打开网页或查看视频广告详情页面聚合维度不支持此场景。 |
穿山甲激励广告支持「在广告中显示奖励内容」功能,根据开发者配置的奖励物品和数量,在激励视频广告播放过程中提示用户完成激励任务后将获取的奖励收益,以激发用户兴趣、观看更完整的视频广告,提升整体的CTR和收入。
若想使用此功能,需在创建激励视频代码位时配置开启“在广告中显示奖励内容”开关。开启后您设置的奖励物品名称、奖励数量会基于模版优选逻辑将有可能在广告播放过程中展示。开发者可以通过以下两种方案配置具体显示的奖励内容。
方案一:在穿山甲平台的代码位创编页面中里输入奖励名称和数量。
方案二:在请求广告构建BUNativeExpressRewardedVideoAd时,使用BURewardedVideoModel,传入奖励名称与奖励数量。
在构建BUNativeExpressRewardedVideoAd时,使用BURewardedVideoModel,传入奖励名称与奖励数量。
广告位维度服务端奖励验证,详细接入流程详见帮助中心-GroMore-平台使用指南-瀑布流管理-服务端激励回调。
代码位维度服务端奖励验证,详细接入流程详见帮助中心-开发测试-更多功能-激励视频交互方式简介&奖励方法说明。
详细接入可参照demo中的BUMDExpressRewardedVideoViewController类。
在线客服智能客服 7*24小时在线人工客服 工作日 10~12点/14~19点