flutter_ads_manager 0.0.9

flutter_ads_manager: ^0.0.9 copied to clipboard

• Fix: AdBannerWidget now retries with the same capped exponential backoff as the full-screen ad controllers when a banner fails to load (e.g. no fill, transient network error), instead of giving up silently and staying blank forever.

• Add AdsManager.instance.openAdInspector() — opens Google's on-device Ad Inspector for debugging ad requests/mediation, without your app needing to depend on google_mobile_ads directly (its own openAdInspector API references a type, AdInspectorError, that package doesn't actually export). Returns null on success or an error message string on failure.

• Upgrade google_mobile_ads to ^9.1.0.
• Fix a deprecated_member_use static analysis warning on compactAdaptive banners (no behavior change — the underlying Google API this relies on is deprecated in favor of a taller size with no compact replacement, so the call is kept but properly isolated/suppressed instead of leaking into your app's own analysis).

• Fix: the device screen could time out and sleep while a full-screen ad was still loading (loading the ad SDK's WebView can take a few seconds), dismissing the ad before the user ever saw it. AdsManager now keeps the screen awake (via wakelock_plus, no extra permissions or native setup needed) from the moment a full-screen ad is triggered until it's dismissed.

• Add BannerAdVariant.compactAdaptive — full device-width banner using Google's compact "current orientation anchored" adaptive size (~50-90dp tall), as opposed to the existing adaptive variant which uses the taller "Large" anchored adaptive size (~90-100dp tall). Use compactAdaptive for an edge-to-edge footer banner that shouldn't take up much vertical space; use adaptive when you want the larger, more prominent size.

• Shorten the pubspec.yaml description to fit pub.flutter-io.cn's 60–180 character limit (was too long to be indexed properly by search engines).

• Add AdsManager.instance.keywords — a settable List<String> sent with every ad request (banner, interstitial, rewarded, rewarded interstitial, app open) for better ad targeting. Set it via init(keywords: ...) or reassign it any time content changes.

• Fix: show() on InterstitialAdController, RewardedAdController, RewardedInterstitialAdController and AppOpenAdController now resolves only after the ad has actually been dismissed (or failed to show), instead of right after the platform call to launch it was issued. Previously, await controller.show(...) could return while the ad was still on screen, so code that inspected state set inside onUserEarnedReward (or that expected the app to have "come back" from the ad) right after the await would see stale results.

Initial release.

• AdsManager singleton: one init() call wires up the Google Mobile Ads SDK, GDPR/UMP consent, and optional preloading.
• Banner ads via AdBannerWidget: standard, adaptive, large banner, and medium rectangle variants.
• InterstitialAdController, RewardedAdController, RewardedInterstitialAdController, AppOpenAdController — self-reloading, with capped retry/backoff on failed loads.
• CountedInterstitialController for "show an interstitial every Nth event" patterns.
• ConsentManager wrapping Google's UMP SDK, including the privacy-options entry point.
• TestAdUnitIds — Google's official test ad unit IDs, used automatically in debug builds.