自定义横幅广告适配器

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

1. 推荐的文件结构

Banner/
├── DemoCustomBannerAdapter.h          # 横幅广告适配器头文件
├── DemoCustomBannerAdapter.m          # 横幅广告适配器实现文件
├── DemoCustomBannerDelegate.h         # 横幅广告代理头文件
└── DemoCustomBannerDelegate.m         # 横幅广告代理实现文件

2. 必要重写的方法

• 您需要继承 DemoCustomBaseAdapter 并重写相关方法：
• 开发者调用广告加载 API 时，会调用到自定义 Adapter 的 loadADWithArgument: 方法

3. 回调方法说明

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

3.1 基础广告事件回调

3.2 横幅广告专用事件回调

4. 实现步骤

4.1 实现DemoCustomBannerDelegate.h

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

示例如下:

objc 复制代码

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

@interface DemoCustomBannerDelegate : NSObject<YourBannerViewDelegate>

@property (nonatomic, strong) ATBannerAdStatusBridge * adStatusBridge;

@end

4.2 实现DemoCustomBannerDelegate.m

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

objc 复制代码

/**
   平台广告准备就绪，可以进行展示
 */
- (void)yourBannerAdReadySuccess:(YourBannerView *)bannerAd { //这是第三方 SDK 的协议方法，广告加载成功时调用
    //将第三方广告 SDK 回调中附带的横幅广告对象传递给我们聚合 SDK
    [self.adStatusBridge atOnBannerAdLoadedWithView:bannerAd adExtra:@{}];
}

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

objc 复制代码

/**
 * 请求广告失败后调用
 */
- (void)yourBannerError:(YourBannerView *)bannerAd error:(NSError *)error {//这是第三方 SDK 的协议方法，广告加载失败时调用
    //通知我们加载失败
    [self.adStatusBridge atOnAdLoadFailed:error adExtra:nil];
}

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

objc 复制代码

/**
 *  banner条点击回调
 */
- (void)yourBannerClicked:(YourBannerView *)bannerAd {
    [self.adStatusBridge atOnAdClick:nil];
}

4.3 实现DemoCustomBannerAdapter.h

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

4.4 实现DemoCustomBannerAdapter.m

1. 添加以下属性:

objc 复制代码

@interface DemoCustomBannerAdapter()

// 本文档步骤一中实现的
@property (nonatomic, strong) DemoCustomBannerDelegate * bannerDelegate;

// 第三方SDK 的banner广告对象
@property (nonatomic, strong) YourBannerView *bannerView;

@end

2. 初始化bannerDelegate属性

objc 复制代码

#pragma mark - lazy
- (DemoCustomBannerDelegate *)bannerDelegate{
    if (_bannerDelegate == nil) {
        _bannerDelegate = [[DemoCustomBannerDelegate alloc] init];
        _bannerDelegate.adStatusBridge = self.adStatusBridge;
    }
    return _bannerDelegate;
}

3. 实现广告加载方法:

objc 复制代码

#pragma mark - Ad load
- (void)loadADWithArgument:(ATAdMediationArgument *)argument {
    dispatch_async(dispatch_get_main_queue(), ^{ //通常需要在主线程执行
        //通过argument对象获取必要的加载信息，如尺寸等，创建好必要的参数，准备传入给第三方的横幅加载方法，开始加载广告
        CGSize bannerSize = CGSizeMake(320, 50);
        if (!CGSizeEqualToSize(argument.bannerSize, CGSizeZero)) {
            bannerSize = argument.bannerSize;
        }
        
        self.bannerView = [[YourBannerView alloc] initWithFrame:CGRectMake(0, 0, bannerSize.width, bannerSize.height)];
        //注意设置代理给DemoCustomBannerDelegate
        self.bannerView.delegate = self.bannerDelegate;
        
        YourBannerAdConfigParams *adParam = [[YourBannerAdConfigParams alloc]init];
        adParam.showCloseBtn = NO;
        adParam.interval = 0;
        //调用第三方广告 SDK 的加载方法
        [self.bannerView loadAdAndShowWithPid:argument.serverContentDic[@"slot_id"] presentVC:argument.viewController adParams:adParam];
    });
}