自定义插屏广告

您已经在TopOn后台添加并配置了自定义广告平台。若您尚未进行相关操作，请前往此处。

以下案例为非竞价广告实现，自定义广告平台实现竞价，请参考此处。

1. 创建Adapter类

根据您在TopOn后台添加的类名，创建InterstitialAdapter类（本例中以CustomInterstitialAdapter命名）。

// CustomInterstitialAdapter.h

#import <Foundation/Foundation.h>

NS_ASSUME_NONNULL_BEGIN

@interface CustomInterstitialAdapter : NSObject

@end

NS_ASSUME_NONNULL_END

// CustomInterstitialAdapter.m

#import "CustomInterstitialAdapter.h"

@interface CustomInterstitialAdapter ()
 
@end

@implementation CustomInterstitialAdapter

@end

 

2. 遵循并实现ATAdAdapter协议

将上一步创建的CustomInterstitialAdapter类遵循ATAdAdapter协议并实现其中必选方法。

查看更多ATAdAdapter协议的信息，请点击这里。

#import "CustomInterstitialAdapter.h"
#import <AnyThinkSDK/AnyThinkSDK.h>
#import <AnyThinkInterstitial/ATInterstitial.h>

@interface CustomInterstitialAdapter() <ATAdAdapter>

@end

@implementation CustomInterstitialAdapter

/// 必须实现，用于初始化自定义adapter，非竞价广告进入，竞价广告请参考文档。
/// - Parameters:
///   - serverInfo: 服务端配置的参数字典
///   - localInfo: 本次加载传入的参数字典
- (instancetype)initWithNetworkCustomInfo:(NSDictionary*)serverInfo localInfo:(NSDictionary*)localInfo {
    self = [super init];
    if (self != nil) {
        // 在这里添加您的广告SDK初始化方法
    }
    return self;
}


/// 必须实现，自定义广告平台加载广告的逻辑
/// - Parameters:实现自定义广告平台加载广告的逻辑
///   - serverInfo: 服务端配置的参数字典
///   - localInfo: 本次加载传入的参数字典
///   - completion: 完成回调
- (void)loadADWithInfo:(NSDictionary*)serverInfo localInfo:(NSDictionary*)localInfo completion:(void (^)(NSArray<NSDictionary *> *, NSError *))completion {
    
    // 加载广告
}


/// 必须实现，用于判断自定义广告平台的广告是否已经是准备完成的状态(或处于广告有效期内)
/// - Parameters:
///   - customObject: 自定义广告对象
///   - info: 服务端配置的参数字典
+ (BOOL)adReadyWithCustomObject:(id)customObject info:(NSDictionary*)info {
    
    BOOL flag =  //广告是否准备就绪逻辑
    
    return flag;
}

/// 实现展示自定义广告平台插屏的逻辑
/// - Parameters:
///   - interstitial: 插屏广告对象
///   - viewController: 当前视图控制器
///   - delegate: 广告对象代理
+ (void)showInterstitial:(ATInterstitial *)interstitial inViewController:(UIViewController*)viewController delegate:(id)delegate {
    
    // 展示广告
    
}
  
@end

 

3. 创建广告回调CustomEvent类

自定义实现一个CustomEvent类(本例中命名为InterstitialCustomEvent)，继承ATInterstitialCustomEvent类，并通过这个类添加自定义广告平台对应的回调代理，当第三方广告平台有回调时，调用本类中您定义的事件方法，这个您定义的事件方法中，您需要调用继承自ATInterstitialCustomEvent的方法，将事件回传给TopOn iOS SDK。本例中仅举例广告加载完成回调，其他方法由您自行添加。

请点击这里查看ATInterstitialCustomEvent类具体说明。

在实现自定义广告平台插屏广告回调事件时，若没有视频播放和结束相关回调事件，可不返回。

//InterstitialCustomEvent.h

#import <AnyThinkInterstitial/AnyThinkInterstitial.h>

NS_ASSUME_NONNULL_BEGIN

@interface InterstitialCustomEvent : ATInterstitialCustomEvent

@end

NS_ASSUME_NONNULL_END

@implementation InterstitialCustomEvent
  
/// 这是您广告平台SDK的广告加载完成回调，具体方法名称及参数请查看您广告平台SDK文档
- (void)your3rdSDKInterstitialAdDidLoad:(id)rewardedVideoAd {
    ...
    //将信息回传给TopOn iOS SDK
    [self trackInterstitialAdLoaded:rewardedVideoAd adExtra:nil];
}

...
其他需要回传的方法

@end