flutter_ads_manager #

Drop-in AdMob ads for Flutter. Call init() once, then use AdBannerWidget and AdsManager.instance for every ad type — banner, interstitial, rewarded, rewarded interstitial, and app open — without writing ad-loading code yourself.

Built on google_mobile_ads. It handles:

• Loading, retrying, and reloading ads automatically
• Google's test ad IDs in debug builds, so you never show real ads by accident
• GDPR/UK/US consent (shown automatically before ads load)
• "Show an interstitial every 3rd time" style frequency capping
• Keywords for better ad targeting

AdMob still requires a native App ID in AndroidManifest.xml / Info.plist for every app — that's a Google requirement, not something any package can remove. Everything else is handled for you.

Setup #

1. Add the dependency #

dependencies:
  flutter_ads_manager: ^0.0.1

2. Add your AdMob App ID #

Android — android/app/src/main/AndroidManifest.xml, inside <application>:

<meta-data
    android:name="com.google.android.gms.ads.APPLICATION_ID"
    android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>

iOS — ios/Runner/Info.plist:

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy</string>

3. Initialize once, at startup #

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

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await AdsManager.instance.init(
    adUnitIds: const AdUnitIdSet(
      android: AdUnitIds(
        banner: 'ca-app-pub-xxxxxxxxxxxxxxxx/1111111111',
        interstitial: 'ca-app-pub-xxxxxxxxxxxxxxxx/2222222222',
        rewarded: 'ca-app-pub-xxxxxxxxxxxxxxxx/3333333333',
        rewardedInterstitial: 'ca-app-pub-xxxxxxxxxxxxxxxx/4444444444',
        appOpen: 'ca-app-pub-xxxxxxxxxxxxxxxx/5555555555',
      ),
      ios: AdUnitIds(
        banner: 'ca-app-pub-xxxxxxxxxxxxxxxx/6666666666',
        interstitial: 'ca-app-pub-xxxxxxxxxxxxxxxx/7777777777',
        rewarded: 'ca-app-pub-xxxxxxxxxxxxxxxx/8888888888',
        rewardedInterstitial: 'ca-app-pub-xxxxxxxxxxxxxxxx/9999999999',
        appOpen: 'ca-app-pub-xxxxxxxxxxxxxxxx/0000000000',
      ),
    ),
    showAppOpenOnResume: true, // auto-shows an app open ad on resume
  );

  runApp(const MyApp());
}

That's it — every ad type is now ready to use anywhere in your app.

Usage #

Banner #

const AdBannerWidget(variant: BannerAdVariant.adaptive)        // full-width, ~90-100dp tall
const AdBannerWidget(variant: BannerAdVariant.compactAdaptive) // full-width, ~50-90dp tall
const AdBannerWidget(variant: BannerAdVariant.standard)        // 320x50
const AdBannerWidget(variant: BannerAdVariant.largeBanner)     // 320x100
const AdBannerWidget(variant: BannerAdVariant.mediumRectangle) // 300x250

Just place it in your layout — it loads itself and shows nothing while loading or if it fails, so it never leaves a gap. A failed load retries on its own with capped exponential backoff, same as the full-screen ad types.

Interstitial #

await AdsManager.instance.interstitial.show();

Counted interstitial (every Nth time) #

// Shows an interstitial only on the 3rd, 6th, 9th... call for this trigger.
await AdsManager.instance.countedInterstitial.registerEventAndMaybeShow(
  'level_complete',
  every: 3,
);

Rewarded #

AdsManager.instance.rewarded.load(); // call ahead of time

if (AdsManager.instance.rewarded.isReady) {
  await AdsManager.instance.rewarded.show(
    onUserEarnedReward: (ad, reward) => grantCoins(reward.amount.toInt()),
  );
}

Rewarded interstitial #

Same as rewarded:

await AdsManager.instance.rewardedInterstitial.show(
  onUserEarnedReward: (ad, reward) => grantCoins(reward.amount.toInt()),
);

App open #

// Automatic: pass showAppOpenOnResume: true to init().

// Or manually:
await AdsManager.instance.appOpen.show();

Consent (GDPR/UMP) #

Handled automatically. If you need a "Privacy options" button in your settings screen:

if (await AdsManager.instance.consent.isPrivacyOptionsRequired) {
  await AdsManager.instance.consent.showPrivacyOptionsForm();
}

Keywords (better ad targeting) #

Describe your app or its current content so AdMob can pick more relevant ads:

AdsManager.instance.keywords = ['sports', 'basketball'];

Testing on a real device with real ad unit IDs #

await AdsManager.instance.init(
  adUnitIds: ...,
  testDeviceIds: ['33BE2250B43518CCDA7DE426D04EE231'], // printed to console on first request
);

Troubleshooting #

An ad shows behind my app's UI (e.g. AppBar visible over an interstitial). This is a known issue on some Android devices, unrelated to this package — the ad's Activity doesn't cover the status bar area the way yours does. Fix it by keeping your app in immersive mode (already done in this repo's example/android/.../MainActivity.kt):

class MainActivity : FlutterActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        WindowCompat.setDecorFitsSystemWindows(window, false)
        WindowInsetsControllerCompat(window, window.decorView)
            .hide(WindowInsetsCompat.Type.systemBars())
    }
}

Screen stays awake during ads #

Loading a full-screen ad's SDK (its WebView) can take a few seconds. On an idle device, that's sometimes long enough for the screen to time out and sleep before the ad ever appears. AdsManager keeps the screen awake from the moment a full-screen ad is triggered until it's dismissed, so this never happens — no setup required, no extra permissions on Android or iOS.

API surface #

Notes #

• Android minSdkVersion 21+, iOS 13.0+ (same as google_mobile_ads).
• Not usable on web/desktop — AdMob is mobile-only.