Menu

ATAdManager (Interstitial)

Operation extensions for Interstitial Ads, providing ad display, cache checking, readiness checking, scenario statistics, and other features, including the definition of Extra keys.

Copy
typedef void(^NativeMixViewBlock)(ATSelfRenderingMixInterstitialView *selfRenderingMixInterstitialView);

extern NSString *const kATInterstitialExtraMediationNameKey; // Extra mediation name key
extern NSString *const kATInterstitialExtraUserIDKey; // Extra user ID key
extern NSString *const kATInterstitialExtraUserFeatureKey; // Extra user feature key
extern NSString *const kATInterstitialExtraMuteStartPlayingFlagKey; // Extra mute start playing flag key
extern NSString *const kATInterstitialExtraFallbackFullboardBackgroundColorKey; // Extra full-screen background color fallback key
extern NSString *const kATInterstitialExtraAdSizeKey; // Extra ad size key, supports Pangle Interstitial Ads, default size is 600x600
extern NSString *const kATInterstitialExtraUsesRewardedVideo; // Use Rewarded Video

extern NSString *const kATInterstitialExtraAdSize600_400; // 600x400 ad size
extern NSString *const kATInterstitialExtraAdSize600_600; // 600x600 ad size
extern NSString *const kATInterstitialExtraAdSize600_900; // 600x900 ad size

@interface ATAdManager (Interstitial)

/// Display an Interstitial Ad
/// @param placementID - Taku Ad Placement ID
/// @param viewController - The view controller to display the ad in
/// @param delegate - Delegate object
- (void)showInterstitialWithPlacementID:(NSString *)placementID
                       inViewController:(UIViewController *)viewController
                               delegate:(id<ATInterstitialDelegate>)delegate;

/// Display an Interstitial Ad
/// @param placementID - Taku Ad Placement ID
/// @param scene - Scenario ID
/// @param viewController - The view controller to display the ad in
/// @param delegate - Delegate object
- (void)showInterstitialWithPlacementID:(NSString *)placementID
                                  scene:(NSString *)scene
                       inViewController:(UIViewController *)viewController
                               delegate:(id<ATInterstitialDelegate>)delegate;

/// Display an Interstitial Ad
/// @param placementID - Taku Ad Placement ID
/// @param scene - Scenario ID
/// @param viewController - The view controller to display the ad in
/// @param delegate - Delegate object
/// @param nativeMixViewBlock - Callback for mixed ad view
- (void)showInterstitialWithPlacementID:(NSString *)placementID
                                  scene:(NSString *)scene
                       inViewController:(UIViewController *)viewController
                               delegate:(id<ATInterstitialDelegate>)delegate
                     nativeMixViewBlock:(nullable NativeMixViewBlock)nativeMixViewBlock;

- (void)showInterstitialWithPlacementID:(NSString *)placementID
                             showConfig:(ATShowConfig *)config
                       inViewController:(UIViewController *)viewController
                               delegate:(id<ATInterstitialDelegate>)delegate
                     nativeMixViewBlock:(nullable NativeMixViewBlock)nativeMixViewBlock;

/// Check whether the Interstitial Ad is ready
/// v5.7.06+
- (BOOL)interstitialReadyForPlacementID:(NSString *)placementID;

/// Get the status object ATCheckLoadModel for the current Ad Placement
- (nullable ATCheckLoadModel *)checkInterstitialLoadStatusForPlacementID:(NSString *)placementID;

/// Query all cached information for the Ad Placement
/// v5.7.53+
- (nullable NSArray<NSDictionary *> *)getInterstitialValidAdsForPlacementID:(NSString *)placementID;

/// Record the cache status statistics of the current Ad Placement in the business scenario
/// @param scene - Ad Scenario
/// v5.7.91+
- (void)entryInterstitialScenarioWithPlacementID:(NSString *)placementID
                                           scene:(NSString *)scene;
@end
Previous
ATAdManager (Banner)
Next
ATAdManager (Native)
Last modified: 2026-07-08Powered by