自定义激励视频广告适配器

💡Tips: 类名可以自定义，但需要与后台配置的自定义广告平台类名保持一致，例如后台添加的适配器类名为：DemoCustomRewardVideoAdapter，则需对应创建DemoCustomRewardVideoAdapter.m文件

1. 推荐的文件结构

RewardVideo/
├── DemoCustomRewardVideoAdapter.h          # 激励视频适配器头文件
├── DemoCustomRewardVideoAdapter.m          # 激励视频适配器实现文件
├── DemoCustomRewardVideoDelegate.h         # 激励视频代理头文件
└── DemoCustomRewardVideoDelegate.m         # 激励视频代理实现文件

温馨提示:类名可以自定义，但需要与后台配置的自定义广告平台类名匹配，例如后台添加的适配器类名为：DemoCustomRewardVideoAdapter，则应对应创建DemoCustomRewardVideoAdapter.m文件

2. 必要重写的方法

您需要继承 DemoCustomBaseAdapter 并重写相关方法：

• 开发者调用广告加载 API 时，会调用到自定义 Adapter 的 loadADWithArgument: 方法
• 开发者调用广告准备状态检查 API 时，会调用到自定义 Adapter 的 adReadyRewardedWithInfo: 方法
• 开发者调用广告展示 API 时，会调用到自定义 Adapter 的showRewardedVideoInViewController: 方法

3. 回调方法说明

激励视频广告适配器支持以下回调方法，这些方法继承自 ATBaseTrackProtocol 和 ATRewardedTrackProtocol 协议：

3.1 基础广告事件回调

3.2 激励视频广告专用事件回调

4. 实现步骤

4.1 实现DemoCustomRewardVideoDelegate.h

步骤:

1. 导入了头文件#import <AnyThinkSDK.h>
2. 添加属性：@property (nonatomic, strong) ATRewardedAdStatusBridge * adStatusBridge;
3. 遵循您的第三方激励视频广告回调协议

最终效果如下:

objc 复制代码

//导入头文件
#import <AnyThinkSDK/AnyThinkSDK.h>
#import <Foundation/Foundation.h>

@interface DemoCustomRewardVideoDelegate : NSObject<YourCustomRewardVideoAdDelegate>

@property (nonatomic, strong) ATRewardedAdStatusBridge * adStatusBridge;

@end

4.2 实现DemoCustomRewardVideoDelegate.m

步骤:

1. 实现您的第三方 SDK 的协议方法，例如广告加载成功，广告点击，广告关闭等。
2. 在第三方SDK的广告加载成功事件中，调用通知我们广告加载成功，例如:

objc 复制代码

/**
 视频数据下载成功回调，已经下载过的视频会直接回调,在该回调中调用show接口
 @param msRewardVideoAd MSRewardVideoAd 实例
 */
- (void)msRewardVideoCached:(MSRewardVideoAd *)msRewardVideoAd { //这是第三方 SDK 的协议方法，广告加载成功时调用
    [self.adStatusBridge atOnRewardedAdLoadedExtra:{}];
}

3. 在第三方SDK的广告加载失败事件中，调用通知我们广告加载失败，例如:

objc 复制代码

/**
 视频广告各种错误信息回调
 回调说明：如收到该回调说明本次请求已失败
 @param msRewardVideoAd MSRewardVideoAd 实例
 @param error 具体错误信息
 */
- (void)msRewardVideoError:(MSRewardVideoAd *)msRewardVideoAd error:(NSError *)error {//这是第三方 SDK 的协议方法，广告加载失败时调用
    //通知我们加载失败
    [self.adStatusBridge atOnAdLoadFailed:error adExtra:nil];
}

4. 参考我们SDKATRewardedVideoTrackProtocol协议与ATBaseTrackProtocol协议，实现其他广告事件并通知我们，例如:

objc 复制代码

/**
 视频广告信息点击回调
 @param msRewardVideoAd MSRewardVideoAd 实例
 */
- (void)msRewardVideoClicked:(MSRewardVideoAd *)msRewardVideoAd {
    [self.adStatusBridge atOnAdClick:nil];
}

/**
 视频广告曝光回调
 @param msRewardVideoAd MSRewardVideoAd 实例
 */
- (void)msRewardVideoShow:(MSRewardVideoAd *)msRewardVideoAd {
    // 广告展示成功回调
    [self.adStatusBridge atOnAdShow:nil];
}

/**
 视频播放页关闭回调
 @param msRewardVideoAd MSRewardVideoAd 实例
 */
- (void)msRewardVideoClosed:(MSRewardVideoAd *)msRewardVideoAd {
    [self.adStatusBridge atOnAdClosed:nil];
}

/**
 视频广告开始播放回调
 @param msRewardVideoAd MSRewardVideoAd 实例
 */
- (void)msRewardVideoStartPlaying:(MSRewardVideoAd *)msRewardVideoAd {
    // 视频开始播放回调
    [self.adStatusBridge atOnAdVideoStart:nil];
}

/**
 视频广告视频播放完成
 @param msRewardVideoAd MSRewardVideoAd 实例
 */
- (void)msRewardVideoFinish:(MSRewardVideoAd *)msRewardVideoAd {
    // 视频播放完成回调
    [self.adStatusBridge atOnAdVideoEnd:nil];
}

/**
 视频广告播放达到激励条件回调
 @param msRewardVideoAd MSRewardVideoAd 实例
 @param adInfo 激励信息
 */
- (void)msRewardVideoReward:(MSRewardVideoAd *)msRewardVideoAd extInfo:(NSDictionary *)adInfo {
    if ([[adInfo valueForKey:@"rewardVerify"] intValue] == 1) {
        [self.adStatusBridge atOnRewardedVideoAdRewarded];
    }
}

/**
 激励视频渲染失败
 */
- (void)msRewardVideoRenderFail:(MSRewardVideoAd *)msRewardVideoAd error:(NSError *)error {
    [self.adStatusBridge atOnAdShowFailed:error extra:nil];
}

/**
 视频广告播放异常回调，当广告无效时或播放途中出现错误时调用
 @param msRewardVideoAd MSRewardVideoAd 实例
 @param error 播放错误信息
 */
- (void)msRewardVideoPlayingError:(MSRewardVideoAd *)msRewardVideoAd error:(NSError *)error {
    [self.adStatusBridge atOnAdDidFailToPlayVideo:error extra:nil];
}

4.3 实现DemoCustomRewardVideoAdapter.h

步骤:

1. 继承 DemoCustomBaseAdapter
2. 导入了头文件#import <AnyThinkSDK.h>
3. 遵循ATBaseRewardedAdapterProtocol协议

4.4 实现DemoCustomRewardVideoAdapter.m

步骤:

1. 添加以下属性:

objc 复制代码

@interface DemoCustomRewardVideoAdapter()

// 本文档4.1中实现的
@property (nonatomic, strong) DemoCustomRewardVideoDelegate *rewardedVideoDelegate;

// 第三方SDK 的激励视频广告对象
@property (nonatomic, strong) MSRewardVideoAd *rewardAd;

@end

2. 初始化rewardedVideoDelegate属性

objc 复制代码

#pragma mark - lazy
- (DemoCustomRewardVideoDelegate *)rewardedVideoDelegate{
    if (_rewardedVideoDelegate == nil) {
        _rewardedVideoDelegate = [[DemoCustomRewardVideoDelegate alloc] init];
        _rewardedVideoDelegate.adStatusBridge = self.adStatusBridge;
    }
    return _rewardedVideoDelegate;
}

3. 实现广告加载方法:

objc 复制代码

#pragma mark - Ad load
- (void)loadADWithArgument:(ATAdMediationArgument *)argument {
    //通过argument对象获取必要的加载信息，创建好必要的参数，准备传入给第三方的激励视频加载方法，开始加载广告
    self.rewardAd = [[MSRewardVideoAd alloc] init];
    //注意设置代理给DemoCustomRewardVideoDelegate
    self.rewardAd.delegate = self.rewardedVideoDelegate;
    
    MSRewardAdConfigParams *adParam = [[MSRewardAdConfigParams alloc]init];
    adParam.userId = argument.localInfoDic[kATAdLoadingExtraUserIDKey];
    adParam.videoMuted = [argument.localInfoDic[@"video_muted"] intValue] == 0 ? NO : YES;
 
    [self.rewardAd loadRewardVideoAdWithPid:argument.serverContentDic[@"slot_id"] adConfigParams:adParam];
}

4. 实现广告展示方法:

objc 复制代码

#pragma mark - Ad show
- (void)showRewardedVideoInViewController:(UIViewController *)viewController {
    [self.rewardAd showRewardVideoAdFromRootViewController:viewController];
}

5. 实现广告准备状态检查方法:

objc 复制代码

#pragma mark - Ad ready
- (BOOL)adReadyRewardedWithInfo:(NSDictionary *)info {
    return self.rewardAd.isAdValid;
}