Interstitial Ads

Load ads after SDK initialization succeeds. Swift examples require import Daro; Objective-C examples use DaroObjCBridge. For an existing integration, follow the migration guide first.

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 Key issued from the dashboard.

Swift
Objective-C

let interstitialUnit = DaroAdUnit(adUnitKey: "your_interstitial_unit_key")

// In Objective-C, adUnitKey is passed directly during initialization
NSString *interstitialUnitKey = @"your_interstitial_unit_key";

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]
        initWithAdUnitKey:@"your_interstitial_unit_key"];
    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.adUnitKey);
}

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

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

- (void)interstitialAdDidFailToShow:(DaroObjCInterstitialAd *)ad
                        adInfo:(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.

The following example is for UIKit apps that explicitly supply a presenting UIViewController. UIViewControllerBasedStatusBarAppearance in Info.plist must be YES; iOS defaults to YES when the key is absent. With NO, the prefersStatusBarHidden approach below does not apply.A fullscreen ad controller can own status bar appearance, so the result also depends on its presentation style and the ad demand implementation. Configuring the parent controller alone cannot control every ad screen. For Flutter apps, use the Flutter status bar option guide instead of copying this UIKit code.

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)interstitialAdDidFailToShow:(DaroObjCInterstitialAd *)ad
                        adInfo:(DaroObjCAdInfo *)adInfo
                         error:(NSError *)error {
    self.adShowing = NO;
    [self setNeedsStatusBarAppearanceUpdate];
}

DARO 2.0 SDK Migration

Getting Started

SDK Integration

How to Use DARO

FAQ

Legacy SDK

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

Interstitial Ad Format

How It Works

Ad Unit Setup

Ad Implementation

Troubleshooting: Ad Close Button Overlap Issue