simple_ads_manager 1.1.0

An easy way to use google ads in flutter.

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