Interstitial Ads

Interstitial Ad Format

Full-screen ads that cover the entire app interface. Includes both image and video ads (video more common), typically skippable after 5 seconds.

How It Works

Ad Unit Setup

Configure your ad unit using the ad unit ID issued from the dashboard.

Swift
Objective-C

let interstitialUnit = DaroAdUnit(unitId: "your_interstitial_unit_id")

// In Objective-C, unitId is passed directly during initialization
NSString *interstitialUnitId = @"your_interstitial_unit_id";

Ad Implementation

Swift
Objective-C

class ExampleViewController: UIViewController {
    private var daroInterstitialAd: DaroInterstitialAd? = nil
    let daroInterstitialLoader = DaroInterstitialAdLoader(unit: interstitialUnit)

    override func viewDidLoad() {
        super.viewDidLoad()
        setupInterstitialAd()
    }

    private func setupInterstitialAd() {
        // Ad load success listener
        daroInterstitialLoader.listener.onAdLoadSuccess = { [weak self] ad, adInfo in
            print("[DARO] Listener Interstitial Ad loaded: \(ad) \(adInfo)")
            self?.showAd(ad: ad)
        }

        // Ad click listener
        daroInterstitialLoader.listener.onAdClicked = { adInfo in
            print("[DARO] Listener Interstitial Ad clicked: \(adInfo)")
        }

        // Ad impression listener
        daroInterstitialLoader.listener.onAdImpression = { adInfo in
            print("[DARO] Listener Interstitial Ad impression: \(adInfo)")
        }

        // Ad load fail listener
        daroInterstitialLoader.listener.onAdLoadFail = { error in
            print("[DARO] Listener Interstitial Ad failed: \(error)")
        }
        daroInterstitialLoader.loadAd()
    }

    private func showAd(ad: DaroInterstitialAd) {
        self.daroInterstitialAd = ad

        // Ad show success listener
        self.daroInterstitialAd?.interstitialListener.onShown = { adInfo in
            print("[DARO] Listener Interstitial Ad shown: \(adInfo)")
        }

        // Ad dismiss listener
        self.daroInterstitialAd?.interstitialListener.onDismiss = { adInfo in
            print("[DARO] Listener Interstitial Ad dismissed: \(adInfo)")
        }

        // Ad show fail listener
        self.daroInterstitialAd?.interstitialListener.onFailedToShow = { adInfo, error in
            print("[DARO] Listener Interstitial Ad failed to show: \(adInfo) \(error)")
        }
        showInterstitialAd()
    }

    private func showInterstitialAd() {
        daroInterstitialAd?.show(viewController: self)
    }
}

1. Adopt the delegate protocol in your header file:

@interface ExampleViewController () <DaroObjCInterstitialAdDelegate>
@property (nonatomic, strong) DaroObjCInterstitialAd *interstitialAd;
@end

2. Setup and load interstitial ad:

- (void)setupInterstitialAd {
    self.interstitialAd = [[DaroObjCInterstitialAd alloc]
        initWithAdUnitId:@"your_interstitial_unit_id"];
    self.interstitialAd.delegate = self;

    // Load ad
    [self.interstitialAd load];
}

3. Implement delegate methods:

#pragma mark - DaroObjCInterstitialAdDelegate

- (void)interstitialAdDidLoad:(DaroObjCInterstitialAd *)ad
                       adInfo:(DaroObjCAdInfo *)adInfo {
    NSLog(@"[DARO] Interstitial ad loaded - Unit: %@", adInfo.adUnitId);
}

- (void)interstitialAdDidFail:(DaroObjCInterstitialAd *)ad
                        toLoad:(NSError *)error {
    NSLog(@"[DARO] Failed to load: %@", error.localizedDescription);
}

- (void)interstitialAdDidShow:(DaroObjCInterstitialAd *)ad
                       adInfo:(DaroObjCAdInfo *)adInfo {
    NSLog(@"[DARO] Interstitial ad shown");
}

- (void)interstitialAdDidFail:(DaroObjCInterstitialAd *)ad
                        toShow:(DaroObjCAdInfo *)adInfo
                         error:(NSError *)error {
    NSLog(@"[DARO] Failed to show: %@", error.localizedDescription);
}

- (void)interstitialAdDidClick:(DaroObjCInterstitialAd *)ad
                        adInfo:(DaroObjCAdInfo *)adInfo {
    NSLog(@"[DARO] Interstitial ad clicked");
}

- (void)interstitialAdDidRecordImpression:(DaroObjCInterstitialAd *)ad
                                   adInfo:(DaroObjCAdInfo *)adInfo {
    NSLog(@"[DARO] Impression recorded");
}

- (void)interstitialAdDidDismiss:(DaroObjCInterstitialAd *)ad
                          adInfo:(DaroObjCAdInfo *)adInfo {
    NSLog(@"[DARO] Interstitial ad dismissed");
}

4. Show ad:

- (void)showInterstitialAd {
    if (self.interstitialAd.isReady) {
        [self.interstitialAd showFrom:self];
    } else {
        NSLog(@"[DARO] Ad is not ready to show");
    }
}

Troubleshooting: Ad Close Button Overlap Issue

When displaying interstitial ads using the DARO iOS SDK, some ad creatives may visually overlap with the top Safe Area or Status Bar. The following guide shows how to hide the Status Bar only while the ad is displayed and restore it once the ad is dismissed.

Swift
Objective-C

1. Add status bar control properties to your ViewController:

class ExampleViewController: UIViewController {
    private var isAdShowing = false

    override var prefersStatusBarHidden: Bool {
        return isAdShowing
    }

    override var childForStatusBarHidden: UIViewController? {
        return presentedViewController
    }
}

2. Hide status bar before showing ad and restore in callbacks:

private func showAd(ad: DaroInterstitialAd) {
    self.daroInterstitialAd = ad

    self.daroInterstitialAd?.interstitialListener.onShown = { [weak self] adInfo in
        print("[DARO] Interstitial Ad shown")
    }

    self.daroInterstitialAd?.interstitialListener.onDismiss = { [weak self] adInfo in
        self?.isAdShowing = false
        self?.setNeedsStatusBarAppearanceUpdate()
    }

    self.daroInterstitialAd?.interstitialListener.onFailedToShow = { [weak self] adInfo, error in
        self?.isAdShowing = false
        self?.setNeedsStatusBarAppearanceUpdate()
    }

    // Hide status bar just before show()
    isAdShowing = true
    setNeedsStatusBarAppearanceUpdate()
    daroInterstitialAd?.show(viewController: self)
}

1. Add property to header file:

@interface ExampleViewController ()
@property (nonatomic, assign) BOOL adShowing;
@end

2. Override status bar control methods:

- (BOOL)prefersStatusBarHidden {
    return self.adShowing;
}

- (UIViewController *)childViewControllerForStatusBarHidden {
    return self.presentedViewController;
}

3. Hide before showing ad and restore in callbacks:

- (void)showInterstitialAd {
    // Hide status bar just before show()
    self.adShowing = YES;
    [self setNeedsStatusBarAppearanceUpdate];

    [self.interstitialAd showFrom:self];
}

// Restore on dismiss
- (void)interstitialAdDidDismiss:(DaroObjCInterstitialAd *)ad
                          adInfo:(DaroObjCAdInfo *)adInfo {
    self.adShowing = NO;
    [self setNeedsStatusBarAppearanceUpdate];
}

// Restore on show failure
- (void)interstitialAdDidFail:(DaroObjCInterstitialAd *)ad
                        toShow:(DaroObjCAdInfo *)adInfo
                         error:(NSError *)error {
    self.adShowing = NO;
    [self setNeedsStatusBarAppearanceUpdate];
}

Getting Started

SDK Integration

How to Use DARO

FAQ

Interstitial Ad Format

How It Works

Ad Unit Setup

Ad Implementation

Troubleshooting: Ad Close Button Overlap Issue

Getting Started

SDK Integration

How to Use DARO

FAQ

​Interstitial Ad Format

​How It Works

​Ad Unit Setup

​Ad Implementation

​Troubleshooting: Ad Close Button Overlap Issue

Interstitial Ad Format

How It Works

Ad Unit Setup

Ad Implementation

Troubleshooting: Ad Close Button Overlap Issue