自定义开屏广告

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

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

1. 创建Adapter类

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

// CustomSplashAdapter.h

#import <Foundation/Foundation.h>

NS_ASSUME_NONNULL_BEGIN

@interface CustomSplashAdapter : NSObject

@end

NS_ASSUME_NONNULL_END

// CustomSplashAdapter.m

#import "CustomSplashAdapter.h"

@interface CustomSplashAdapter ()
 
@end

@implementation CustomSplashAdapter

@end

 

2. 遵循并实现ATAdAdapter协议

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

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

#import "CustomSplashAdapter.h"
#import <AnyThinkSDK/AnyThinkSDK.h>
#import <AnyThinkSplash/ATSplash.h>

@interface CustomSplashAdapter() <ATAdAdapter>

@end

@implementation CustomSplashAdapter

/// 必须实现，用于初始化自定义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 = YES;
    //广告是否准备就绪逻辑
    
    return flag;
}

/// 实现自定义广告平台展示开屏广告的逻辑。
/// - Parameters:
///   - splash: 本次加载传入的对象
///   - localInfo: 本次加载传入的参数字典，包含在 show ad 时传入的window 等参数
///   - delegate: 广告对象代理
+ (void)showSplash:(ATSplash *)splash localInfo:(NSDictionary *)localInfo delegate:(id)delegate {
    
    // 展示广告
    
}
  
@end

 

3. 创建广告回调CustomEvent类

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

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

//SplashCustomEvent.h

#import <AnyThinkSplash/AnyThinkSplash.h>

NS_ASSUME_NONNULL_BEGIN

@interface SplashCustomEvent : ATSplashCustomEvent

@end

NS_ASSUME_NONNULL_END

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

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

@end