Light Popup Ads

A full-screen ad format.
Displays an ad as a popup over your app screen.
Android light popup example

iOS light popup example

Creating Instance and Setting Callbacks

Create a DaroLightPopupAd instance and set up callbacks.

import 'package:daro_flutter/daro_flutter.dart';

final lightPopupAd = DaroLightPopupAd(adUnitKey: 'YOUR_AD_UNIT_KEY');

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

Loading Ads

Call load() to load an ad.

lightPopupAd.load();

Showing Ads

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

final isReady = await lightPopupAd.isReady();

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

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 = DaroLightPopupAd(
  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 = DaroLightPopupAd(
  adUnitKey: 'YOUR_AD_UNIT_KEY',
  hideStatusBarDuringFullscreenAd: true,
  systemUiRestoreConfiguration: DaroSystemUiRestoreConfiguration(
    mode: SystemUiMode.manual,
    overlays: const [SystemUiOverlay.bottom], // App baseline: status bar hidden
  ),
);

Calling dispose() while the popup is visible closes it and restores the status bar after dismissal completes. 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, including from your widget’s State.dispose(). Create a new instance instead of reusing one after disposal. Create the ad instance in initState() and keep it when rotation causes build() to run again. An orientation change alone does not require another ad load. The native SDK adjusts the existing ad’s layout, following the orientations supported by your app.

lightPopupAd.dispose();

Style Customization

Use DaroLightPopupStyle to customize the UI of light popup ads. Pass Flutter Color objects directly.

final lightPopupAd = DaroLightPopupAd(
  adUnitKey: 'YOUR_AD_UNIT_KEY',
  style: DaroLightPopupStyle(
    backgroundColor: const Color(0xB2121416),  // Overall background color
    containerColor: const Color(0xFF121416),   // Card background color
    titleColor: const Color(0xFFF7FAFF),       // Title color
    bodyColor: const Color(0xFFB6BECC),        // Body text color
    ctaBackgroundColor: const Color(0xFFEB2640), // CTA button background color
    ctaTextColor: const Color(0xFFFFFFFF),     // CTA button text color
    closeButtonColor: const Color(0xFFF7FAFF), // Close button text color
    closeButtonText: 'Close AD',               // Close button text
    adMarkLabelTextColor: const Color(0xFFF7FAFF),   // Ad mark label text color
    adMarkLabelBackgroundColor: const Color(0xFF3E434F), // Ad mark label background color
  ),
);

Style Properties

Property	Type	Description
`backgroundColor`	`Color?`	Overall background color
`containerColor`	`Color?`	Card background color
`titleColor`	`Color?`	Title color
`bodyColor`	`Color?`	Body text color
`ctaBackgroundColor`	`Color?`	CTA button background color
`ctaTextColor`	`Color?`	CTA button text color
`closeButtonColor`	`Color?`	Close button text color
`closeButtonText`	`String?`	Close button text
`adMarkLabelTextColor`	`Color?`	Ad mark label text color
`adMarkLabelBackgroundColor`	`Color?`	Ad mark label background color

Implementation Example

This is an example implementation of DaroLightPopupAd.

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

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

  @override
  State<LightPopupAdPage> createState() => _LightPopupAdPageState();
}

class _LightPopupAdPageState extends State<LightPopupAdPage> {
  late final DaroLightPopupAd _lightPopupAd;
  String _status = 'Not Loaded';

  @override
  void initState() {
    super.initState();
    _lightPopupAd = DaroLightPopupAd(
      adUnitKey: 'YOUR_AD_UNIT_KEY',
      style: DaroLightPopupStyle(
        backgroundColor: const Color(0xB2121416),
        containerColor: const Color(0xFF121416),
        titleColor: const Color(0xFFF7FAFF),
        bodyColor: const Color(0xFFB6BECC),
        ctaBackgroundColor: const Color(0xFFEB2640),
        ctaTextColor: const Color(0xFFFFFFFF),
        closeButtonColor: const Color(0xFFF7FAFF),
        closeButtonText: 'Close AD',
        adMarkLabelTextColor: const Color(0xFFF7FAFF),
        adMarkLabelBackgroundColor: const Color(0xFF3E434F),
      ),
    );
    _setupCallbacks();
  }

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

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

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

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

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

    _lightPopupAd.onAdClicked = (adInfo) {
      print('LightPopup ad clicked');
    };

    _lightPopupAd.onAdImpression = (adInfo) {
      print('LightPopup ad impression');
    };
  }

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

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

DARO 2.0 SDK Migration

Getting Started

SDK Integration

How to Use DARO

FAQ

Legacy SDK

Creating Instance and Setting Callbacks

Loading Ads

Showing Ads

Hide the status bar during iOS ads

Releasing Resources

Style Customization

Style Properties

Implementation Example

​Light Popup Ad Format

​Creating Instance and Setting Callbacks

​Loading Ads

​Showing Ads

​Hide the status bar during iOS ads

​Releasing Resources

​Style Customization

​Style Properties

​Implementation Example

Light Popup Ad Format

Creating Instance and Setting Callbacks

Loading Ads

Showing Ads

Hide the status bar during iOS ads

Releasing Resources

Style Customization

Style Properties

Implementation Example