自定义插屏广告适配器

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

1. 推荐的文件结构

Interstitial/
├── DemoCustomInterstitialAdapter.h          # 插屏适配器头文件
├── DemoCustomInterstitialAdapter.m          # 插屏适配器实现文件
├── DemoCustomInterstitialDelegate.h         # 插屏代理头文件
└── DemoCustomInterstitialDelegate.m         # 插屏代理实现文件

2. 需要重写的方法

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

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

3. 回调事件说明

插屏广告适配器支持以下回调方法，这些方法继承自 ATBaseTrackProtocol 和 ATInterstitialTrackProtocol 协议：

3.1 基础广告事件回调

3.2 插屏广告专用事件回调

4. 实现步骤

4.1 实现DemoCustomInterstitialDelegate.h

1. 导入头文件#import <AnyThinkSDK.h>
2. 添加属性：@property (nonatomic, strong) ATInterstitialAdStatusBridge * adStatusBridge;
3. 遵循您接入的广告平台的插屏广告回调协议，例如本例中是MSInterstitialDelegate
   示例如下:

objc 复制代码

#import <AnyThinkSDK/AnyThinkSDK.h>
#import <Foundation/Foundation.h>
#import "DemoCustomAdapterCommonHeader.h"

@interface DemoCustomInterstitialDelegate : NSObject<MSInterstitialDelegate>

@property (nonatomic, strong) ATInterstitialAdStatusBridge * adStatusBridge;

@end

4.2 实现DemoCustomInterstitialDelegate.m

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

objc 复制代码

/**
   平台广告展示准备就绪，可以进行展示 在此回调中调用show接口展示广告
 */
- (void)msInterstitialAdReadySuccess:(MSInterstitialAd *)msInterstitialAd { //这是第三方 SDK 的协议方法，广告加载成功时调用
    [self.adStatusBridge atOnInterstitialAdLoadedExtra:@{}];
}

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

objc 复制代码

/**
 *  广告预加载失败回调
 *  详解:当接收服务器返回的广告数据失败后调用该函数
 */
- (void)msInterstitialError:(MSInterstitialAd *)msInterstitialAd error:(NSError *)error {//这是第三方 SDK 的协议方法，广告加载失败时调用
    //通知我们加载失败
    [self.adStatusBridge atOnAdLoadFailed:error adExtra:nil];
}

4. 实现其他广告事件并通知我们，例如:

objc 复制代码

/**
 *  插屏广告点击回调
 */
- (void)msInterstitialClicked:(MSInterstitialAd *)msInterstitialAd {
    [self.adStatusBridge atOnAdClick:nil];
}

/**
 *  插屏广告视图展示成功回调
 *  详解: 插屏广告展示成功回调该函数
 */
- (void)msInterstitialShow:(MSInterstitialAd *)msInterstitialAd {
    [self.adStatusBridge atOnAdShow:nil];
}

/**
 *  插屏广告展示结束回调
 *  详解: 插屏广告展示结束回调该函数
 */
- (void)msInterstitialClosed:(MSInterstitialAd *)msInterstitialAd {
    [self.adStatusBridge atOnAdClosed:nil];
}

/**
   平台广告展示失败
   详解：可能广告素材异常或三方异常导致无法广告曝光
 */
- (void)msInterstitialAdShowFail:(MSInterstitialAd *)msInterstitialAd error:(NSError *)error {
    [self.adStatusBridge atOnAdShowFailed:error extra:nil];
}

/**
 *  全屏广告页被关闭
 */
- (void)msInterstitialDetailClosed:(MSInterstitialAd *)msInterstitialAd {
    [self.adStatusBridge atOnAdDetailClosed:nil];
}

4.3 实现DemoCustomInterstitialAdapter.h

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

4.4 实现DemoCustomInterstitialAdapter.m

1. 添加以下属性:

objc 复制代码

@interface DemoCustomInterstitialAdapter()

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

// 第三方SDK 的插屏广告对象
@property (nonatomic, strong) MSInterstitialAd *interstitialAd;

@end

2. 初始化interstitialDelegate属性

objc 复制代码

#pragma mark - lazy
- (DemoCustomInterstitialDelegate *)interstitialDelegate{
    if (_interstitialDelegate == nil) {
        _interstitialDelegate = [[DemoCustomInterstitialDelegate alloc] init];
        _interstitialDelegate.adStatusBridge = self.adStatusBridge;
    }
    return _interstitialDelegate;
}

3. 实现广告加载方法:

objc 复制代码

#pragma mark - Ad load
- (void)loadADWithArgument:(ATAdMediationArgument *)argument {
    //通过argument对象获取必要的加载信息，创建好必要的参数，准备传入给第三方的插屏加载方法，开始加载广告
    self.interstitialAd = [[MSInterstitialAd alloc] init];
    //注意设置代理给DemoCustomInterstitialDelegate
    self.interstitialAd.delegate = self.interstitialDelegate;
    
    MSInterstitialAdConfigParams *adParam = [[MSInterstitialAdConfigParams alloc]init];
    adParam.videoMuted = [argument.localInfoDic[@"video_muted"] intValue] == 0 ? NO : YES;
    adParam.isNeedCloseAdAfterClick = [argument.localInfoDic[@"click_close"] intValue] == 0 ? NO : YES;
     
    [self.interstitialAd loadAdWithPid:argument.serverContentDic[@"slot_id"] adConfigParams:adParam];
}

4. 实现广告展示方法:

objc 复制代码

#pragma mark - Ad show
- (void)showInterstitialInViewController:(UIViewController *)viewController {
    [self.interstitialAd showAdFromRootViewController:viewController];
}

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

objc 复制代码

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