Custom Splash Ad Adapter

💡Tips: The class name can be customized, but it must be consistent with the custom ad platform class name configured in the backend. For example, if the adapter class name added in the backend is: DemoCustomSplashAdapter, then you need to create the corresponding DemoCustomSplashAdapter.m file.

1. Recommended File Structure

Splash/
├── DemoCustomSplashAdapter.h          # Splash ad adapter header file
├── DemoCustomSplashAdapter.m          # Splash ad adapter implementation file
├── DemoCustomSplashDelegate.h         # Splash ad delegate header file
└── DemoCustomSplashDelegate.m         # Splash ad delegate implementation file

2. Required Methods to Override

You need to inherit from DemoCustomBaseAdapter and override the relevant methods:

• When developers call the ad loading API, the custom Adapter's loadADWithArgument: method will be called
• When developers call the ad ready status check API, the custom Adapter's adReadySplashWithInfo: method will be called
• When developers call the ad display API, the custom Adapter's showSplashInViewController: method will be called

3. Callback Methods Description

The splash ad adapter supports the following callback methods, which are inherited from the ATBaseTrackProtocol protocol:

4. Implementation Steps

4.1 Implement DemoCustomSplashDelegate.h

1. Import the header file #import <AnyThinkSDK.h>
2. Add property: @property (nonatomic, strong) ATAdStatusBridge * adStatusBridge;
3. Conform to your third-party ad SDK's splash ad callback protocol

Example:

objc Copy

// Import header files
#import <AnyThinkSDK/AnyThinkSDK.h>
#import <Foundation/Foundation.h>

@interface DemoCustomSplashDelegate : NSObject<YourSplashAdDelegate>

@property (nonatomic, strong) ATAdStatusBridge * adStatusBridge;

@end

4.2 Implement DemoCustomSplashDelegate.m

1. Implement your third-party SDK's protocol methods, such as ad load success, ad click, ad close, etc.
2. In the third-party SDK's ad load success event, call to notify us that the ad loaded successfully

objc Copy

// Ad load success
- (void)splashAdDidLoad:(YourSplashAd *)splashAd {
    [self.adStatusBridge atOnAdMetaLoadFinish:{}];
}

3. In the third-party SDK's ad load failure event, call to notify us that the ad failed to load

objc Copy

// Ad load failure
- (void)splashAdDidFailToLoad:(YourSplashAd *)splashAd error:(NSError *)error {
    [self.adStatusBridge atOnAdLoadFailed:error adExtra:nil];
}

4. Refer to our SDK protocol, implement other ad events and notify us:

objc Copy

// Ad load success
- (void)splashAdDidLoad:(YourSplashAd *)splashAd {
    [self.adStatusBridge atOnAdMetaLoadFinish:{}];
}


// Ad display success
- (void)splashAdDidShow:(YourSplashAd *)splashAd {
    [self.adStatusBridge atOnAdShow:nil];
}

// Ad click
- (void)splashAdDidClick:(YourSplashAd *)splashAd {
    [self.adStatusBridge atOnAdClick:nil];
}

// Ad close
- (void)splashAdDidClose:(YourSplashAd *)splashAd {
    [self.adStatusBridge atOnAdClosed:nil];
}

4.3 Implement DemoCustomSplashAdapter.h

1. Inherit from DemoCustomBaseAdapter
2. Import the header file #import <AnyThinkSDK.h>
3. Conform to the ATBaseSplashAdapterProtocol protocol

4.4 Implement DemoCustomSplashAdapter.m

1. Add the following properties:

objc Copy

@interface DemoCustomSplashAdapter()

@property (nonatomic, strong) DemoCustomSplashDelegate *splashDelegate;
@property (nonatomic, strong) YourSplashAd *splashAd;

@end

2. Initialize the splashDelegate property

objc Copy

#pragma mark - lazy
- (DemoCustomSplashDelegate *)splashDelegate{
    if (_splashDelegate == nil) {
        _splashDelegate = [[DemoCustomSplashDelegate alloc] init];
        _splashDelegate.adStatusBridge = self.adStatusBridge;
    }
    return _splashDelegate;
}

3. Implement the ad loading method:

objc Copy

#pragma mark - Ad load
- (void)loadADWithArgument:(ATAdMediationArgument *)argument {
    self.splashAd = [[YourSplashAd alloc] init];
    self.splashAd.delegate = self.splashDelegate;
    
    [self.splashAd loadAdWithSlotId:argument.serverContentDic[@"slot_id"]];
}

4. Implement the ad display method:

objc Copy

#pragma mark - Ad show
- (void)showSplashInViewController:(UIViewController *)viewController {
    [self.splashAd showInViewController:viewController];
}

5. Implement the ad ready status check method:

objc Copy

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