Rewarded Video Ads

Rewarded Video Ad Format

Ads that provide in-app rewards (currency, features, content, etc.) in exchange for watching.
Since users watch in exchange for rewards, video ads cannot be skipped and typically run for 30 seconds.

How It Works

Creating Instance and Setting Callbacks

Create a DaroRewardedAd instance and set up callbacks.

import 'package:daro_flutter/daro_flutter.dart';

final rewardedAd = DaroRewardedAd(adUnitKey: 'YOUR_AD_UNIT_KEY');

rewardedAd.onAdLoadSuccess = (adInfo) {
  print('Rewarded ad loaded');
};
rewardedAd.onAdLoadFail = (error) {
  print('Rewarded ad failed to load: ${error.message}');
};
rewardedAd.onAdImpression = (adInfo) {
  print('Rewarded ad impression');
};
rewardedAd.onAdClicked = (adInfo) {
  print('Rewarded ad clicked');
};
rewardedAd.onAdShown = (adInfo) {
  print('Rewarded ad shown');
};
rewardedAd.onAdFailedToShow = (error) {
  print('Rewarded ad failed to show: ${error.message}');
};
rewardedAd.onAdDismiss = (adInfo) {
  print('Rewarded ad dismissed');
};
rewardedAd.onEarnedReward = (adInfo, rewardItem) {
  print('Earned reward: ${rewardItem.amount} ${rewardItem.type}');
};

Reward Callback

The onEarnedReward callback is triggered when the user watches the ad to completion and earns a reward. You can access the reward details through DaroRewardItem.

Property	Description
`amount`	Reward quantity
`type`	Reward type

Loading Ads

Call load() to load an ad.

rewardedAd.load();

Setting Custom Data

Use setCustomData() to set custom data to be included in S2S (Server-to-Server) reward callbacks. This must be set before calling show().

await rewardedAd.setCustomData('your_custom_data');

Showing Ads

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

final isReady = await rewardedAd.isReady();

if (isReady) {
  await rewardedAd.setCustomData('your_custom_data');
  rewardedAd.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 = DaroRewardedAd(
  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 = DaroRewardedAd(
  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.

rewardedAd.dispose();

Implementation Example

This is an example implementation of DaroRewardedAd.

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

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

  @override
  State<RewardedAdPage> createState() => _RewardedAdPageState();
}

class _RewardedAdPageState extends State<RewardedAdPage> {
  late final DaroRewardedAd _rewardedAd;
  String _status = 'Not Loaded';

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

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

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

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

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

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

    _rewardedAd.onAdClicked = (adInfo) {
      print('Rewarded ad clicked');
    };

    _rewardedAd.onAdImpression = (adInfo) {
      print('Rewarded ad impression');
    };

    _rewardedAd.onEarnedReward = (adInfo, rewardItem) {
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('Reward: ${rewardItem.amount} ${rewardItem.type}')),
      );
    };
  }

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

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

DARO 2.0 SDK Migration

Getting Started

SDK Integration

How to Use DARO

FAQ

Legacy SDK

Rewarded Video Ads

Rewarded Video Ad Format

How It Works

Creating Instance and Setting Callbacks

Reward Callback

Loading Ads

Setting Custom Data

Showing Ads

Hide the status bar during iOS ads

Releasing Resources

Implementation Example

​Rewarded Video Ad Format

​How It Works

​Creating Instance and Setting Callbacks

​Reward Callback

​Loading Ads

​Setting Custom Data

​Showing Ads

​Hide the status bar during iOS ads

​Releasing Resources

​Implementation Example

Rewarded Video Ad Format

How It Works

Creating Instance and Setting Callbacks

Reward Callback

Loading Ads

Setting Custom Data

Showing Ads

Hide the status bar during iOS ads

Releasing Resources

Implementation Example