Menu

ATAdManager (Interstitial)

The operation extension for Interstitial ads, providing features such as ad display, checking cache, checking whether the ad is ready, and scenario statistics. It also includes 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 playback flag key
extern NSString *const kATInterstitialExtraFallbackFullboardBackgroundColorKey; // Extra full-screen background color fallback key
extern NSString *const kATInterstitialExtraAdSizeKey; // Extra ad size key, supports TT 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 - TopOn placement ID
/// @param viewController - The view controller displaying the ad
/// @param delegate - Delegate object
- (void)showInterstitialWithPlacementID:(NSString *)placementID
                       inViewController:(UIViewController *)viewController
                               delegate:(id<ATInterstitialDelegate>)delegate;

/// Display an Interstitial ad
/// @param placementID - TopOn placement ID
/// @param scene - Scenario ID
/// @param viewController - The view controller displaying the ad
/// @param delegate - Delegate object
- (void)showInterstitialWithPlacementID:(NSString *)placementID
                                  scene:(NSString *)scene
                       inViewController:(UIViewController *)viewController
                               delegate:(id<ATInterstitialDelegate>)delegate;

/// Display an Interstitial ad
/// @param placementID - TopOn placement ID
/// @param scene - Scenario ID
/// @param viewController - The view controller displaying the ad
/// @param delegate - Delegate object
/// @param nativeMixViewBlock - Callback for the 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 of the current placement
- (nullable ATCheckLoadModel *)checkInterstitialLoadStatusForPlacementID:(NSString *)placementID;

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

/// Enter the cache status statistics of the current placement in a 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