simple_ads_manager

Google Mobile Ads (AdMob) Made Simple for Flutter

A clean, centralized, and production-ready ads manager for Flutter apps using Google Mobile Ads (AdMob).

✅ Platform Support

Android iOS
✅ ✅

✨ Supported Ad Formats

Ad Type Preload Support Revenue Callback Lifecycle Aware
Banner ❌ ✅ Inline
Native (Template) ❌ ✅ Inline
Interstitial ✅ ✅ Manual
Rewarded ❌ ✅ Manual
Rewarded Interstitial ✅ ✅ Manual
App Open ❌ ✅ Foreground
Auto App Open ❌ ✅ Automatic

✨ Features

  • Banner Ads
  • Native Ads (Template-based)
  • Interstitial Ads (Preload support)
  • Rewarded Ads
  • Rewarded Interstitial Ads
  • App Open Ads
  • Auto App Open (Lifecycle-based)
  • Revenue callbacks
  • Availability checks
  • Cooldown control

📦 Installation

dependencies:
  simple_ads_manager: ^0.0.2

Run:

flutter pub get

⚙️ Setup

1️⃣ Add AdMob App ID

Android → AndroidManifest.xml

<meta-data
    android:name="com.google.android.gms.ads.APPLICATION_ID"
    android:value="REPLACE_WITH_YOUR_ANDROID_APP_ID" />

iOS → Info.plist

<key>GADApplicationIdentifier</key>
<string>REPLACE_WITH_YOUR_IOS_APP_ID</string>

2️⃣ Initialize SDK

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await SimpleAdsManager.instance.init();
  runApp(const MyApp());
}

3️⃣ Optional: Enable Test Ads

SimpleAdsManager.alwaysTestADs = true;

🔥 Usage

🟢 Banner Ad

SimpleAdsManager.instance.banner(
  adUnitId: "ca-app-pub-xxxxxxxxxxxxxxxx/banner-id",
);

🟢 Native Ad

SimpleAdsManager.instance.nativeAd(
  adUnitId: "ca-app-pub-xxxxxxxxxxxxxxxx/native-id",
  nativeTemplateStyle: NativeTemplateStyle(
    templateType: TemplateType.medium,
  ),
);

🟢 Interstitial (Recommended: Preload)

Preload

SimpleAdsManager.instance.preloadInterstitial(
  adUnitId: "ca-app-pub-xxxxxxxxxxxxxxxx/interstitial-id",
);

Show

SimpleAdsManager.instance.showPreloadedInterstitial(
  context: context,
  adUnitId: "ca-app-pub-xxxxxxxxxxxxxxxx/interstitial-id",
  onDismiss: (shown) {},
);

🟢 Rewarded

SimpleAdsManager.instance.loadAndShowRewarded(
  adUnitId: "ca-app-pub-xxxxxxxxxxxxxxxx/rewarded-id",
  context: context,
  onCompleted: (reward, earned) {},
);

🟢 Rewarded Interstitial

SimpleAdsManager.instance.loadAndShowRewardedInterstitial(
  adUnitId: "ca-app-pub-xxxxxxxxxxxxxxxx/rewarded-interstitial-id",
  context: context,
);

🟢 App Open

SimpleAdsManager.instance.loadAndShowAppOpen(
  adUnitId: "ca-app-pub-xxxxxxxxxxxxxxxx/app-open-id",
  context: context,
);

🟢 Auto App Open (Best Practice)

SimpleAdsManager.instance.showAppStateAppOpen(
  adUnitId: "ca-app-pub-xxxxxxxxxxxxxxxx/app-open-id",
  context: context,
);

🧠 Check Ad Availability

bool ready =
    SimpleAdsManager.instance.isInterstitialReady;

💡 Best Practices

  • Initialize SDK before showing ads.
  • Preload fullscreen ads for better UX.
  • Avoid showing ads back-to-back.
  • Use natural transition points.
  • Always use test ads during development.
  • Follow AdMob policies strictly.

👨‍💻 Author

Eng. Zeeshan Ali
Senior Software Engineer
Flutter • Android • iOS
Google Mobile Ads Specialist

📄 License

MIT License © 2025 Zeeshan Ali

Libraries

simple_ads_manager