方法

说明

@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或打开网页或查看视频广告详情页面聚合维度不支持此场景。

对比项

客户端奖励名称/数量设置

服务端奖励验证配置

配置位置

客户端代码（请求激励广告时设置rewardName或rewardAmount或穿山甲后台代码位创编页面配置

穿山甲平台广告位开启“服务端激励回调”并配置 URL 和密钥

作用对象

穿山甲用户界面展示（如挽留弹窗、奖励提示），激发用户兴趣，提高广告完整观看率及收益，受模版限制不是一定会展示

服务端奖励发放的合法性校验：当用户观看完激励视频并达到奖励条件时，服务端会将奖励名称和数量通过回调 URL 传递给开发者服务端，开发者服务端返回判断结果后，客户端会通过nativeExpressRewardedVideoAdServerRewardDidSucceed回调获取奖励名称和数量，用于实际奖励发放。

数据流向

客户端→穿山甲 SDK→广告展示页面

穿山甲服务端→开发者服务端→客户端回调

依赖条件

需开启“在广告中显示奖励内容”开关

需开启“需要服务器判断”并配置回调接口

优先级规则

接口传入 > 平台配置

服务端返回结果决定最终奖励是否发放

对比项

广告位维度【强烈推荐】

代码位维度

配置位置

GroMore 平台的广告位层级（广告位 ID 以 1 开头），需在广告位编辑页面勾选「服务端激励回调」并填入回调 URL

具体 ADN（如穿山甲）的代码位层级（代码位 ID 以 9 开头），需在对应 ADN 平台的代码位设置中开启「服务端激励回调」并配置 URL，详细配置请移步聚合ADN说明：

穿山甲、广点通、百度、快手、sigmob

验证逻辑

GroMore 服务端接收 ADN 的奖励事件后，统一向开发者服务端发起回调，开发者返回验证结果后，GroMore 再将结果透传给客户端（如 onRewardArrived 回调）

ADN 服务端直接与开发者服务端交互，验证结果由 ADN 客户端回调返回（如穿山甲的 nativeExpressRewardedVideoAdServerRewardDidSucceed）

回调链路

所有 ADN 的奖励验证通过 GroMore 中转，支持多 ADN 统一管理，回调链路涉及多个广告网络，开发者在 GroMore 广告位设置回调后，GroMore 服务端会向开发者服务端发送验证请求

各 ADN 独立处理验证流程，不经过 GroMore 中转，直接通过自身服务端向开发者服务端发送验证请求，开发者判断后返回结果，穿山甲客户端再回调给开发者

参数传递

包含更多扩展参数，如 ecpm、广告位 id、adn 的代码位 id 等

包含 sign、user_id、trans_id、reward_amount、reward_name、extra 等基本参数，不包含 ecpm 参数

注意事项

开启聚合维度服务端验证功能后，不要在第三方 ADN 重复配置这些代码位的服务端验证

开启聚合维度服务端验证功能后，不要在第三方 ADN 重复配置这些代码位的服务端验证