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

Creating Instance and Setting Callbacks

Create a DaroInterstitialAd instance and set up callbacks.

import 'package:daro_flutter/daro_flutter.dart';

final interstitialAd = DaroInterstitialAd(adUnitKey: 'YOUR_AD_UNIT_KEY');

interstitialAd.onAdLoadSuccess = (adInfo) {
  print('Interstitial ad loaded');
};
interstitialAd.onAdLoadFail = (error) {
  print('Interstitial ad failed to load: ${error.message}');
};
interstitialAd.onAdImpression = (adInfo) {
  print('Interstitial ad impression');
};
interstitialAd.onAdClicked = (adInfo) {
  print('Interstitial ad clicked');
};
interstitialAd.onAdShown = (adInfo) {
  print('Interstitial ad shown');
};
interstitialAd.onAdFailedToShow = (error) {
  print('Interstitial ad failed to show: ${error.message}');
};
interstitialAd.onAdDismiss = (adInfo) {
  print('Interstitial ad dismissed');
};

Loading Ads

Call load() to load an ad.

interstitialAd.load();

Showing Ads

Check if the ad is ready with isReady(), then display it with show().

final isReady = await interstitialAd.isReady();

if (isReady) {
  interstitialAd.show();
}

After the ad is dismissed, isReady() returns false. To show another ad, call load() again on the same instance and wait for the onAdLoadSuccess callback.

Hide the status bar during iOS ads

Available in Flutter SDK 2.0.5 and later. Enable hideStatusBarDuringFullscreenAd when the status bar overlaps an ad’s close control. It defaults to false and does not change system UI on Android.

final ad = DaroInterstitialAd(
  adUnitKey: 'YOUR_AD_UNIT_KEY',
  hideStatusBarDuringFullscreenAd: true,
);

The SDK completes the status bar hide request before showing the ad. After dismissal or a presentation failure, it restores SystemUiMode.edgeToEdge by default. Returning from show() does not mean that the ad has ended, so do not restore the status bar immediately after that call. On iOS with this option enabled, calling load() or show() on the same instance before its ad presentation session ends throws StateError. Do not preload that instance from onAdShown; call load() after onAdDismiss or onAdFailedToShow instead. If your app normally hides the status bar or uses manual system UI settings, specify the configuration to restore. Flutter has no API for reading the current system UI configuration, so the SDK cannot automatically recover an arbitrary previous configuration.

import 'package:flutter/services.dart';
import 'package:daro_flutter/daro_flutter.dart';

final ad = DaroInterstitialAd(
  adUnitKey: 'YOUR_AD_UNIT_KEY',
  hideStatusBarDuringFullscreenAd: true,
  systemUiRestoreConfiguration: DaroSystemUiRestoreConfiguration(
    mode: SystemUiMode.manual,
    overlays: const [SystemUiOverlay.bottom], // App baseline: status bar hidden
  ),
);

Calling dispose() while an ad is visible does not forcibly close that ad. The SDK waits for the actual dismissal or presentation-failure callback before restoring system UI. SystemUiMode.manual requires an overlays list. An empty list requests that all system UI overlays remain hidden. Overlapping active ad sessions share the first session’s restore configuration, which is applied after the last session ends. If your app changes SystemChrome settings during an ad, the SDK’s restore configuration may be applied afterward.

Status bar behavior depends on the Flutter and iOS versions, UIViewControllerBasedStatusBarAppearance, and which controller owns the ad screen’s status bar. A Flutter issue reports ignored SystemChrome settings when an app built with the iOS 27 SDK sets this key to NO. When changing the key, verify your app’s status bar behavior and ad presentation and dismissal with your ad demand sources.

Releasing Resources

Call dispose() to release resources when done.

interstitialAd.dispose();

Implementation Example

This is an example implementation of DaroInterstitialAd.

import 'package:flutter/material.dart';
import 'package:daro_flutter/daro_flutter.dart';

class InterstitialAdPage extends StatefulWidget {
  const InterstitialAdPage({super.key});

  @override
  State<InterstitialAdPage> createState() => _InterstitialAdPageState();
}

class _InterstitialAdPageState extends State<InterstitialAdPage> {
  late final DaroInterstitialAd _interstitialAd;
  String _status = 'Not Loaded';

  @override
  void initState() {
    super.initState();
    _interstitialAd = DaroInterstitialAd(adUnitKey: 'YOUR_AD_UNIT_KEY');
    _setupCallbacks();
  }

  void _setupCallbacks() {
    _interstitialAd.onAdLoadSuccess = (adInfo) {
      setState(() => _status = 'Loaded');
    };

    _interstitialAd.onAdLoadFail = (error) {
      setState(() => _status = 'Failed to Load');
      print('Interstitial ad failed to load: ${error.message}');
    };

    _interstitialAd.onAdShown = (adInfo) {
      setState(() => _status = 'Shown');
    };

    _interstitialAd.onAdFailedToShow = (error) {
      setState(() => _status = 'Failed to Show');
    };

    _interstitialAd.onAdDismiss = (adInfo) {
      setState(() => _status = 'Not Loaded');
    };

    _interstitialAd.onAdClicked = (adInfo) {
      print('Interstitial ad clicked');
    };

    _interstitialAd.onAdImpression = (adInfo) {
      print('Interstitial ad impression');
    };
  }

  @override
  void dispose() {
    _interstitialAd.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Interstitial Ad')),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text('Status: $_status'),
            const SizedBox(height: 16),
            ElevatedButton(
              onPressed: () async {
                final isReady = await _interstitialAd.isReady();
                if (isReady) {
                  _interstitialAd.show();
                } else {
                  setState(() => _status = 'Loading...');
                  _interstitialAd.load();
                }
              },
              child: Text(_status == 'Loaded' ? 'Show Interstitial' : 'Load Interstitial'),
            ),
          ],
        ),
      ),
    );
  }
}

DARO 2.0 SDK Migration

Getting Started

SDK Integration

How to Use DARO

FAQ

Legacy SDK

Interstitial Ad Format

How It Works

Creating Instance and Setting Callbacks

Loading Ads

Showing Ads

Hide the status bar during iOS ads

Releasing Resources

Implementation Example

​Interstitial Ad Format

​How It Works

​Creating Instance and Setting Callbacks

​Loading Ads

​Showing Ads

​Hide the status bar during iOS ads

​Releasing Resources

​Implementation Example

Interstitial Ad Format

How It Works

Creating Instance and Setting Callbacks

Loading Ads

Showing Ads

Hide the status bar during iOS ads

Releasing Resources

Implementation Example