激励视频广告

1. 主要API

1.1 ApexAdxAdRequest

属性名	类型	属性介绍
userId	NSString	【可选】，媒体用户ID。
pid	NSString	【必传】，广告位ID。
options	NSDictionary<NSString *, NSString *>	【可选】，服务端激励回传时，扩展参数。

1.2 ApexAdxRewardedAd

方法名	方法介绍
- (instancetype)initWithRequest:(ApexAdxAdRequest *)request	初始化reward ad对象。参数说明：request 广告请求对象。
- (BOOL)isAdReady	返回广告是否可展示。
- (void)fetchRewardedAd	发起拉取广告请求，只拉取不展示。
- (void)showFromRootViewController:(UIViewController *)rootViewController options:(NSDictionary<NSString *, NSString *> * _Nullable)options	展示广告。参数说明：rootViewController 显示广告的容器。options 激励视频广告获得奖励时，服务器回调的扩展参数。

1.3 ApexAdxRewardedAdDelegate

方法名	方法介绍
-(void)rewardedAdDidLoad:(NSString *)pid	广告加载成功回调。参数说明：pid 广告位id。
-(void)rewardedAdDidFailToLoad:(NSString *)pid error:(NSError *)error	广告加载失败回调。参数说明：pid 广告位id。error 具体错误信息。
-(void)rewardedAdDidStartPlaying	广告曝光回调。
-(void)rewardedAdDidPlayFinish	广告播放完成回调。
-(void)rewardedAdDidReward:(NSString *_Nonnull)transId	获得奖励。参数说明：transId 流水号。
-(void)rewardedAdDidClick	广告点击回调。
-(void)rewardedAdDidClose	广告关闭回调。
-(void)rewardedAdDidSkip	广告跳过回调。
-(void)rewardedAdDidFailToPlay:(NSString *)pid error:(NSError *)error	广告播放失败回调。参数说明：pid 广告位id。error 具体错误信息。

2. 接入代码示例

2.1 广告加载

@property (nonatomic, strong) ApexAdxRewardedAd *rewardVideoAd;

ApexAdxAdRequest *request = [ApexAdxAdRequest request];
request.userId = @"用户id";
request.pid = @"广告位id";
request.options = @{@"key1":@"value1"};
self.rewardVideoAd = [[ApexAdxRewardedAd alloc] initWithRequest:request];
self.rewardVideoAd.delegate = self;
[self.rewardVideoAd fetchRewardedAd];

2.2 广告展示

// 在激励视频广告加载成功回调里执行show，需要先判断广告状态是否ready
if (self.rewardVideoAd.isAdReady) {
    [self.rewardVideoAd showFromRootViewController:self options:nil];
}