🧩 Drop-in widgets

⚙️ Central configuration — AppAdsUtil

• One singleton for all ad unit IDs (Android + iOS per format)
• configure() — set everything in one call before SDK init
• useTestAds — global test/production switch (safe defaults)
• testDeviceIds — register devices for safe production-unit testing
• Publisher mismatch logging at startup

🛡️ Production-ready safeguards

• Fallback to Google official test ad units when IDs are missing
• Bounded exponential backoff for transient NO_FILL responses
• RewardedAdShowResult — reliable reward tracking
• AdMobAdState lifecycle on every util
• Graceful no-op on web/desktop
• Optional structured logging via onLog

🚀 Developer experience

• Fully documented public API (dartdoc on every export)
• Runnable Android + iOS example with Google test inventory
• Strict analysis & CI-friendly tests
• MIT licensed — personal & commercial use

const AdMobBannerWidget(useAdaptiveWidth: true)

Omit adUnitIds to use AppAdsUtil.bannerAdUnitIds.

const AdMobNativeWidget(templateType: TemplateType.medium)

Or load manually:

final native = NativeAdUtil(
  adUnitIds: AppAdsUtil.instance.nativeAdUnitIds,
  nativeTemplateStyle: NativeTemplateStyle(templateType: TemplateType.medium),
);

await native.load();
final widget = native.buildWidget();
native.dispose();

Omit adUnitIds to use AppAdsUtil.nativeAdUnitIds. For custom platform layouts, pass factoryId instead of nativeTemplateStyle.

Preload on startup; show when the app returns to the foreground:

final appOpen = AppOpenAdUtil(
  adUnitIds: AppAdsUtil.instance.appOpenAdUnitIds,
);

await appOpen.load();

// On resume (WidgetsBindingObserver.didChangeAppLifecycleState):
await appOpen.showIfAvailable();

await appOpen.show(); // or show immediately when ready
appOpen.dispose();

Loaded ads expire after four hours by default (AdMobAdsConstants.defaultAppOpenCacheDuration); expired inventory is discarded and reloaded automatically.

final interstitial = InterstitialAdUtil(
  adUnitIds: AppAdsUtil.instance.interstitialAdUnitIds,
);

await interstitial.load();
await interstitial.show();
interstitial.dispose();

final rewarded = RewardedAdUtil(
  adUnitIds: AppAdsUtil.instance.rewardedAdUnitIds,
);

await rewarded.load();
final result = await rewarded.show(onUserEarnedReward: (reward) {
  // grant the reward
});
if (result.shown && result.rewardEarned) {
  // user completed the ad
}
rewarded.dispose();

final rewardedInterstitial = RewardedInterstitialAdUtil(
  adUnitIds: AppAdsUtil.instance.rewardedInterstitialAdUnitIds,
);

await rewardedInterstitial.load();
final result = await rewardedInterstitial.show(onUserEarnedReward: (reward) {
  // grant the reward
});
if (result.shown && result.rewardEarned) {
  // user completed the ad
}
rewardedInterstitial.dispose();

AppAdsUtil.useTestAds defaults to true, serving Google's official test inventory on every placement.

Register test devices via AppAdsUtil.testDeviceIds to request production unit IDs while still receiving test creatives during development. Each device prints its hash in logcat as Use RequestConfiguration.Builder().setTestDeviceIds(...).