Skip to main content

google_admob_sdk 1.0.6+5 copy "google_admob_sdk: ^1.0.6+5" to clipboard
google_admob_sdk: ^1.0.6+5 copied to clipboard

A self-managed, high-speed Flutter plugin for Google Mobile Ads Next-Gen SDK & 3rd-Party Ad Networks (AppLovin, Meta, Mintegral, Unity Ads, Pangle, IronSource, Liftoff) with centralized Ad Unit ID man [...]

1.0.6+5 #

  • Banners are adaptive by default (behavior change):
    • BannerAdWidget without adSize, isAdaptive, width or height now requests an anchored adaptive banner instead of the fixed 320x50. Passing adSize (or sizing the widget with width / height) keeps a fixed banner; passing isAdaptive is honored as before. BannerAdPool.preload is adaptive unless adSize or isAdaptive: false is given, and a ParallelAdPoolManager banner slot without bannerSize is adaptive too.
    • Check your layout: an adaptive banner is as wide as the screen and usually taller than 50dp. A parent with a fixed 50dp height, or narrower than the screen, clips it: remove the fixed height, or pass adSize: AdSize.banner / adaptiveWidth.
    • A banner preloaded by BannerAdPool.warmUp (always adaptive) is now consumed by a BannerAdWidget without a size; before, the sizes never matched and the preloaded banner was wasted.
    • The banner that replaces a closed native ad (closeNativeShowBanner) is adaptive for the width of the native slot.
    • The adaptive width is read from the screen metrics when the request is sent. A preload or pool load sent before the first frame, when the metrics may still be empty, uses the 360dp fallback.
  • Banner reuse across quick screen changes:
    • Added BannerAdPool.impressedReuseWindow (default 30 seconds). A non-collapsible banner whose latest impression is younger than the window is kept when its widget is disposed (holdImpressedAd), and the next BannerAdWidget of the same ad unit and size shows it without a new request (takeHeldImpressed). It is disposed when the window ends unused. heldImpressedCount reports held banners.
    • Set BannerAdPool.impressedReuseWindow = Duration.zero for the previous behavior (impressed banners disposed at once).
    • Reuse needs the previous widget to be disposed before the next one is created: leaving a screen and opening another, or scrolling a keepAlive: false banner away and back. A screen replaced in place (pushReplacement, a tab swapped in one frame) still sends its own request, because the new banner is created first.
    • The widget that takes a held banner gets onAdLoaded and onAdImpression for it, as for any ad attached from a pool; AdMob counts no new impression until the banner refreshes.
    • Not yet verified on devices: re-mounting an impressed banner in a new platform view, and whether a detached banner refreshes during the window.
  • Expired ads:
    • BannerAdPool.maxAdAge and NativeAdPool.maxAdAge: 60 → 55 minutes. AppOpenAdManager.maxAdAge: 4 hours → 3 hours 50 minutes.
    • BannerAdWidget and NativeAdWidget dispose and reload a mounted ad that reaches that age without an impression (a kept-alive tab or a list item never scrolled to), also when the age is reached while the device sleeps. When the slot cannot be seen (app in background, route covered) the reload waits until it is seen again. A caller-owned preloadedAd is left alone.
    • A slot that stays mounted on the current route without ever being seen reloads once per 55 minutes.
  • Close / collapse buttons inside native ads: 48dp touch area:
    • A tap that lands next to an in-ad close or collapse button, inside a 48dp box around it, now presses that button. Before, the touch area was the 24-32dp icon, and a tap a few dp beside it landed on the ad and was counted as an ad click (on the collapsible card the whole card opens the ad).
    • Android: AdPlatformContainerFrameLayout takes that tap for a visible, enabled button with a click listener and the id iv_close, imageClose or overlayButton (CloseTouchTarget), so custom layouts that reuse those ids get it too. The finger has to stay in the box until it lifts, and a second finger cancels the press. iOS: FigmaNativeAdView.hitTest returns the collapse arrow for a point in that area.
    • AdChoices keeps its taps: a touch on the button itself is dispatched as before, and a touch on a view the ads SDK placed over the ad is never taken (Android: any view NativeAdView holds besides the ad's layout; iOS: any view the template did not create).
    • Nothing moves on screen. The strip around the button no longer opens the ad; the rest of the ad is clickable as before.
    • Checked on an Android 12 phone with test ads on the collapsible home card: a tap about 5dp outside the arrow button opened the ad before and collapses the card now; a tap on the arrow collapses it; pressing beside the arrow, dragging away and back does nothing; the card's CTA still opens the ad. Not checked on a device: an ad that shows an AdChoices icon (the test creatives have none), a second finger, fullscreen native close buttons, and iOS (type-checked only).

1.0.6+4 #

  • iOS Native View Sizing (GoogleAdmobSdkPlugin.swift):
    • Initial Bounds Synchronization: In attachToContainer, newView.frame is now always reset to container.bounds even when the platform view container is 0x0 before Flutter's first layout pass. This prevents autoresizingMask (.flexibleWidth, .flexibleHeight) from compounding the view's initial frame with the container's final size (e.g. inflating a 375x267 view to 777x547 in a 402x280 slot).
  • Example Project Maintenance:
    • Cleaned up and removed tracked Swift Package Manager Package.resolved lock files from example/ios and example/macos to prevent dependency resolution conflicts.

1.0.6+3 #

  • Shimmer Animation & Performance (AdShimmerEffect):
    • Smooth Diagonal Sweep: Replaced the linear alignment slide with a 15-degree diagonal sweep (_sweepShader) computed dynamically from bounds and aspect ratio. The sweep starts before the child's first corner and ends after its last corner, completely eliminating harsh jumps/flashes when the animation loop wraps around.
    • Cosine Gradient Transition: Introduced 7 cosine-distributed gradient color stops (_bandStops) for natural light falloff without abrupt edges or harsh color peaks.
    • Repaint Boundary Isolation: Added dual RepaintBoundary wrappers: an outer boundary preventing shimmer frame updates from invalidating the surrounding widget tree, and an inner boundary allowing the shader sweep to recomposite without repainting the child skeleton content every frame.
    • Default Period: Adjusted default shimmer animation period from 1300ms to 1500ms for a smoother, more polished cadence.
    • Test Coverage: Added test/ad_shimmer_effect_test.dart verifying jump-free cycles across Banner (320x50), Small Native (375x100), Medium Native (375x282), and Fullscreen Native (400x800) formats, as well as frame repaint isolation.

1.0.6+2 #

  • iOS Native Layouts:
    • Real-Bounds Layout: Native templates (NativeAdView) now lay out their subviews inside layoutSubviews using the container's real bounds instead of fixed frames computed at 0x0 when the platform view container is created. This eliminates layout clipping and subviews overflowing the ad view container (resolving AdMob native validator warning "Advertiser assets outside native ad view").
    • CLS Collapsible Template: Added native iOS layout support for collapsible factory IDs (cls, admob_native_cls*, admob_native_media_fit_*, admob_native_media_crop_*), with MediaView, icon, Ad badge, headline, body, full-width CTA, and collapse arrow button.
    • Collapsible Close Options: Honors close_ads_native_collapsible / showCloseButton and hideNativeOnClose, firing onNativeCloseButtonClicked. Forwarded customOptions on load, rebind, and swap.
    • Height Reporting on Rebind: Rebind reports the template's intrinsic height instead of the mounted container's height, allowing proper intrinsic auto-resizing after collapse.
    • Localized "Ad" Label: Small template includes localized "Ad" badge matching Android admob_native_small.
  • Flutter Native Preview (FigmaNativeAdPreview):
    • Wrapped native ad body text in Flexible to prevent pixel overflows in compact slots where headline plus two body lines exceed the available slot height.

1.0.6+1 #

  • Android R8 Consumer Rules: The plugin's consumer rules kept GMA Next-Gen, UMP, every mediation adapter, every partner SDK and the plugin itself whole (-keep class ... { *; }), so R8 could not shrink, optimize or obfuscate them in any app using the plugin (Play Console "DEX code optimization: Low"). These libraries ship their own rules, and GMA keeps the adapters it loads by name, so the plugin now keeps only the partner privacy classes it calls through Class.forName. The Mediation Setup Guide and the example app no longer use the broad rules.

1.0.6 #

  • Inline Ads (show rate):
    • Banner Slots Never Share One Ad: Two BannerAdWidgets waiting on one in-flight request both attached the ad it delivered, and a cacheKey ad already on screen was attached again by a second widget with the same key. One slot went blank, and disposing either widget disposed or rescued the ad the other still showed. The in-flight result is now claimed by one widget only (and only at the expected size), cacheKey reuse skips an ad that is on screen, and takeStandby skips mounted ads.
    • Superseded Native Requests: A replaced native request that loaded or failed later cancelled the reveal timer of the ad that replaced it, so with minShimmerDuration that ad stayed hidden and onAdLoaded never came. Native now ignores superseded results like banner.
    • Replaced Ads Kept: An unimpressed ad replaced in a widget (late preloadedAd, pool attach) was neither disposed nor returned to the pool. It now goes to the standby queue (disposed when the queue is full); a caller's preloadedAd is still never touched.
    • Banner preloadedAd After Mount: A preloadedAd passed after the banner mounted was ignored, so it was never shown. It now replaces the widget's own ad.
    • Banner Backoff On Screen Changes: After a failed load, a keyboard, inset or rotation change requested a new banner at once and reset the retry backoff. The new size is now used by the pending retry.
  • Fullscreen:
    • loadAd Callbacks: A loadAd call that joined a load in flight, or found an ad already held, never called onAdLoaded / onAdFailedToLoad, so flows waiting on them hung. Both are now called.
    • Ads Outside The App: The 5-minute on-screen watchdog closed a fullscreen ad while the user was in the store page it opened, losing a rewarded ad's reward. It now waits for the user to return.
    • Reward After Dismiss: On Android the reward and the dismiss arrive from different SDK threads, and a reward landing just after the dismiss was dropped (the ad was already disposed) and ad_complete logged end_type: quit. Rewarded formats without a reward yet now wait 500ms before ad_complete, the dispose and onAdDismissedFullScreenContent, so the reward is delivered first.
    • Preloader Refill: AdPreloader stopped refilling for the session after two failed retries, a network-error failure, an offline fill, an expiry prune or an empty pollAd. It now retries after the circuit-breaker pause, refills every slot when the network returns, and refills on an expiry prune or an empty poll.
  • iOS: SDK init timings are sent as loadTimeMs (were latencyMs, logged as 0).

1.0.5 #

  • NativeAdWidget Kept Ad Now Reported: When the widget's cacheKey changed while that key's preload was in flight (e.g. Language 1 → Language 2) and the preload got no fill, the widget kept its current ad on screen, rebound to the new layout, but called neither onAdLoaded nor onAdFailedToLoad. A parent covering the slot with its own shimmer until onAdLoaded stayed on the shimmer forever. The kept ad is now reported through onAdLoaded (and onAdImpression when it already had one), like an ad taken from the pool.

1.0.4 #

  • iOS: Google Mobile Ads 13 & UMP 3:

    • Podspec: Google-Mobile-Ads-SDK ~> 13.0 and GoogleUserMessagingPlatform ~> 3.0 (were ~> 12.0 / ~> 2.7). The Swift sources use the 13.x / 3.x API names and did not compile against the old pins; CocoaPods now also resolves the current adapters (AppLovin 13.6.4, Meta 6.22.1, Mintegral 8.1.8, Unity 4.21.0, Pangle 8.4.0.5, IronSource 9.7.0, Liftoff 7.7.8).
    • CocoaPods Required: The plugin's Package.swift declares only Flutter, so a Swift Package Manager build (Flutter's default) links no ads SDK and no adapter. Apps must set flutter: config: enable-swift-package-manager: false in pubspec.yaml; see the README iOS setup.
    • ResponseInfo on iOS: Loads and load failures of every format now report ResponseInfo (winning ad source, every ad source tried with its error, mediation group extras), like Android. Revenue and Databuckets events get the real network instead of unknown.
    • Banner Reload Loop Fixed: Mounting a banner stretched its BannerView to the 0×0 platform view, which GMA turned into a new 0×0 request ("Invalid ad width or height") after every load. Banners now keep their size, auto-refreshes are reported as onAdRefreshed / onAdFailedToRefresh (a failed refresh keeps the banner), and banners get a rootViewController for landing pages and collapsible banners.
  • Inline Ads (BannerAdWidget, NativeAdWidget):

    • No Retry Loop After a Failure: A failed load kept the disposed ad, and build() reloaded it at once, so every No-Fill (Android and iOS) became an endless burst of requests. The widget now drops the failed ad and shows errorBuilder.
    • Background Retry with Backoff: After a final failure the widget retries after 2s, 4s, 8s and 16s (AdRetryPolicy), keeping errorBuilder until an ad loads. Network errors wait for the connection to return; requests skipped by the SDK (consent, ads off, no ad unit) are not retried.
  • Mediation:

    • Unity Ads SDK Bundled (Android): Added com.unity3d.ads:unity-ads:4.21.0. The Unity adapter does not pull the Unity Ads SDK, so Unity Ads could never initialize, bid or fill. Release builds hid the missing classes because of -dontwarn com.unity3d.ads.**.
    • Android Adapters: ironSource 9.7.0.0, Liftoff (Vungle) 7.7.9.0. Removed the unused Chartboost and ironSource Maven repositories; only Mintegral and Pangle are still added.
    • Pangle Resource Keep Rules: res/raw/google_admob_sdk_keep.xml keeps the Pangle resources that isShrinkResources = true removed.
    • InitializationConfig.waitForAdapterInitialization: Holds every load until MobileAds.initialize reports all adapters, so every partner joins the first request (default false).
    • Adapter Status Logging: Android logs each adapter's init state, and FirebaseAdLogger sends one adapter_<network> param per adapter (R / N + latency).
    • MediationConfig.enableTestMode: Now puts Meta Audience Network in test mode on Android and iOS (it was reserved and did nothing). Logs a warning when enabled in a release build.
  • Diagnostics:

    • ResponseInfo on Android: adapterResponses now lists every ad source of the request with its error, and responseExtras holds the mediation group / A/B test names.
    • AdInstanceManager.onAdLoadResult: Called once per finished request of any format with the ad and its error, for logging which ad source served or failed.
    • BannerAdPool.unconsumedAds() / NativeAdPool.unconsumedAds(): PooledAdSnapshots of loaded pooled ads that no widget shows yet, for show-rate diagnostics.
  • Native Ads (Android): Views are measured before they are attached and laid out only once attached to a window, and an impressed pooled ad is detached from its key so the next ad can preload.

  • Example: Mediation Testing card (Ad Inspector, adapter statuses, ad source of every request, warnings for sample ad units, missing test devices and iOS builds using Android ad units or App IDs), with your own IDs passed through --dart-define-from-file=ads.local.json. The iOS example builds with CocoaPods.

1.0.3+1 #

  • Databuckets IAA Tracking (Sheet 41):

    • iaa_request Is Now Sent: Logged right before every load call (each waterfall unit, the parallel standby request, BannerAdWidget / NativeAdWidget, BannerAdPool / NativeAdPool, AdPreloader and ParallelAdPoolManager slots) with ad_request_id, ad_format, ad_unit_id, ad_placement, ad_platform and, when known, ad_unit_name, ad_mediation, screen_name, the mediation A/B test params and session_number. It goes through the new logAdRequestStart extension over logCustomEvent, so custom AdAnalyticsLogger implementations keep compiling.
    • Joinable ad_request_id (AdRequestTracking): When the caller passes no adRequestId, the SDK generates one per load attempt and binds it to the loaded ad. An ad served from the standby, the preloader or a pool keeps the id of the request that loaded it, so iaa_request, ad_request, iaa_loaded / iaa_fail_load and the show events of that ad share the same id.
    • Request Context on Show Events: iaa_click, iaa_complete, iaa_fail_show and iaa_impression now include ad_request_id, ad_unit_name, ad_mediation and screen_name. Splash pool slots send ad_request_id and their unitKey as ad_unit_name (they have no screen context).
    • Parallel Standby Logging: The standby request started by the parallel fallback now logs ad_load_performance, ad_request and iaa_loaded / iaa_fail_load like every other attempt.
  • Docs & Tests:

    • .agents/ rules and skill, AGENTS.md and doc/ synced with the current code (file map, invariants, runbooks, code samples that compile). The Sheet 41 IAA taxonomy table is back in rule 03 and doc/DATABUCKETS_TRACKING.md, with an implementation status column.
    • Added iaa_tracking_test.dart (154 tests in total).
  • Migration Notes:

    • A load attempt now sends four events (iaa_request, then ad_load_performance, ad_request and iaa_loaded / iaa_fail_load), and the parallel standby request is counted too. Check Firebase event quotas and dashboards that count ad_request.
    • A custom AdAnalyticsLogger receives iaa_request only if it handles logCustomEvent.

1.0.3 #

  • Revenue & Analytics Fixes:

    • Waterfall Preserved After Every Show: Auto-reload after a fullscreen show now repeats the original loadAd (original customAdUnitId, AdRequest, screenName, adUnitName, A/B test params) instead of pinning the unit that just served, so the next load starts again from the high-floor unit. The resolved network of the shown ad is no longer reused as a sticky adNetwork override.
    • Splash & ParallelAdPoolManager Analytics: Pool loads log ad_request + health monitor stats; pool shows log revenue (onPaidEvent), iaa_fail_show, clicks and ad_complete. Each SharedAdUnitSlot has its own AdRetryPolicy, reset when connectivity returns.
    • Firebase Reserved Names: FirebaseAdLogger no longer sends the reserved ad_click event (click data goes to iaa_click) and skips reserved event names and firebase_ / google_ / ga_ user properties instead of throwing.
    • iOS Consent Status Mapping: getConsentStatus maps UMP values explicitly to the Dart ConsentStatus order (iOS orders required before notRequired); builds without UMP return unknown instead of obtained.
    • Failed Shows: The frequency-capping cooldown starts only in onAdShowedFullScreenContent. A failed or throwing show() disposes the ad, resets the showing flags, logs iaa_fail_show and reloads; PlatformException on show is reported through onAdFailedToShowFullScreenContent.
    • Enforced Backoff (AdRetryPolicy.loadBlockedError): After a failed waterfall, loadAd is refused for the backoff window (2s, 4s, 8s... up to 60s; 3-minute circuit breaker after 5 failures) and offline loads are refused too, all reported through onAdFailedToLoad instead of silently returning false.
  • Policy & Compliance:

    • COPPA & Meta ATT Propagation (Android & iOS): MediationConfig.isChildDirected is forwarded to Meta (setMixedAudience), Vungle (setCOPPAStatus), Mintegral, Unity (setNonBehavioral) and IronSource/LevelPlay (is_child_directed), and mirrored into AdMob tagForChildDirectedTreatment unless the RequestConfiguration sets it. metaAdvertiserTrackingEnabled reaches FBAdSettings on iOS. setThirdPartyPrivacyConsent replies only after the flags are applied.
    • Native Privacy Fixes: iOS now applies privacy flags at init (Dart sends mediationConfig, Swift read mediationPrivacy). Each 3rd-party setter runs independently, so missing APIs (Pangle 8.x setGDPRConsent) no longer abort a network's remaining flags. IronSource uses LevelPlay (mediation SDK 9.x); Unity uses UnityAds.setUserConsent / setUserOptOut / setNonBehavioral (4.20+), with MetaData as fallback.
    • Consent Gate (GoogleAdmobSdk.instance.canRequestAds): requestConsentIfRequired stores the UMP result; while it is false every load fails with LoadAdError.consentRequired without a network request or a counted retry failure. The consent-info request times out after infoUpdateTimeout (10s) so the splash never hangs offline; showPrivacyOptionsForm refreshes the gate.
    • Click-Safe Layouts: The NativeAdWidget close button moved to a 32px strip outside the ad view (never over assets, CTA or AdChoices; closeButtonAlignment defaults to topRight). Fullscreen variants 2, 8 and 10 now close through the template Close button and keep a top close icon. The tallMediaProgressClose progress bar follows the real countdown instead of a fixed 45%.
    • No Impressions Under the Shimmer: eagerSurfaceMount now defaults to false for NativeAdWidget and BannerAdWidget; when enabled, minShimmerDuration is ignored.
    • Release Logging & PII: ConsoleAdLogger.useDeviceLog defaults to !kReleaseMode; initialize(enableLogging:, enableDeviceLog:) default to off in release (an onLog callback still receives logs). AnalyticsUserProperties.userName / userEmail are deprecated and skipped by FirebaseAdLogger, which also redacts e-mail addresses (and phone numbers in search/feedback text).
    • No Silent Test Ads in Release (AdIdConfig.allowTestAdUnitIds): Defaults to !kReleaseMode. In release builds a missing or Google test ad unit ID resolves to '' and the load fails with LoadAdError.missingAdUnitId plus a one-time warning. AdIdConfig.test() keeps test IDs allowed.
  • Lifecycle & Leak Fixes:

    • Reused Ads: NativeAdWidget / BannerAdWidget restore the ad's previous listener when they let go of it and ignore callbacks for ads they no longer show, so disposed widgets stop receiving onPaidEvent / onAdClicked (no duplicated revenue).
    • Superseded Banner Requests: A banner request replaced by a hedged fallback or pool rescue can no longer touch timers, start a fallback or replace the ad on screen.
    • Pools: NativeAdPool.set / BannerAdPool.set release the ad they replace; NativeAdPool forgets key mappings when ads leave the keyed pool; BannerAdPool.clear(), disposeAd() and releaseOrRescueKeyedAd() complete pending waiters (no widget stuck on shimmer). Widgets dispose ads they loaded themselves even when a preloadedAd was given (the caller still owns preloadedAd).
    • Disposed Ads: load() after dispose() no longer reaches native, and show() on a disposed ad reports onAdFailedToShowFullScreenContent.
    • Countdown Dialog: showAdSafely and NativeAdInterstitialDialog close only their own route (dismissOwnRoute) instead of popping the user's screen.
    • Fullscreen Watchdog (AdInstanceManager): A show that never reports back fails after fullScreenShowTimeout (10s); a lost dismiss is reported after fullScreenMaxOnScreen (5 min), or fullScreenResumeGrace (3s) after the app resumes on Android. Late native events are dropped, so isAnyFullScreenAdShowing and the splash race always recover.
    • Shared Interstitial Cooldown (GoogleAdmobSdk.instance.lastInterstitialShowTime): Every InterstitialAdManager (including forUnitKey) and ParallelAdPoolManager check the same cooldown; resetCooldown() clears it.
    • Banner Resizing: Adaptive banners are re-requested after rotation / split-screen resize (300ms debounce) and when adUnitId, size or collapsible placement change (didUpdateWidget).
    • Debug Crash: NativeAdWidget(borderRadius:) without decoration no longer asserts.
    • Slow-Network Detection: isSlowNetwork needs slowLoadsBeforeFastTrack (2) consecutive slow loads or a network error within slowNetworkWindow (60s); any fast response ends it, so high-floor units are no longer skipped after a single slow load.
  • Architecture & Maintenance:

    • FullScreenAdManager<T>: InterstitialAdManager, RewardedAdManager, RewardedInterstitialAdManager and AppOpenAdManager now share one implementation (rewarded formats via the RewardedFullScreenAd mixin); public APIs are unchanged. Fixes the waterfall skipping its first fallback on slow networks. isAdAvailable / isAdLoaded are side-effect free.
    • Global Ads Switch (GoogleAdmobSdk.instance.adsEnabled / adsEnabledListenable): For premium users or a Remote Config kill switch. While false, loads fail with LoadAdError.adsDisabled, fullscreen ads and splash races are skipped, and ad widgets render nothing; mounted widgets load again when re-enabled.
    • Deprecations: setUserControlledAppMuted (use setAppMuted), setApplicationVolume (use setAppVolume) and GoogleAdmobSdk.instance.health (use healthMonitor).
    • File Layout: NativeAdPool, BannerAdPool, FigmaNativeAdPreview and the Firebase / Console / Composite loggers moved to part files; AdCountdownConfig / AdCountdownDialog moved to ad_countdown_dialog.dart (still exported).
    • MediationConfig.copyWith: setPrivacyConsent no longer drops enableHedgedParallelFallback. Unused fields (enableTestMode, credentials, networkExtras, preloadBiddingSignals) are documented as reserved.
    • Docs: AGENTS.md and README.md corrected (consent-first quickstart, enforced backoff, 55-minute TTL, slow-network rules, eagerSurfaceMount, ads switch).
    • Tests: Added p0_fixes_test.dart, p0_policy_test.dart, p1_lifecycle_test.dart and p2_architecture_test.dart (147 tests in total).
  • Build Fixes:

    • Added the 9 drawables used by admob_native_cctv_horizontal.xml, admob_native_cctv_medium.xml and admob_native_full.xml (admob_rounded_card_cctv, ic_ad_info, ...), fixing :google_admob_sdk:verifyReleaseResources in release builds.
  • Migration Notes:

    • Call GoogleAdmobSdk.requestConsentIfRequired() before GoogleAdmobSdk.initialize().
    • Release builds need real ad unit IDs for every format they use (or AdIdConfig.test() / allowTestAdUnitIds: true for internal builds).
    • Pass enableLogging: true to keep console logs in release.
    • showCloseButton / closeNativeShowBanner add a 32px strip to the native widget height.
    • Adaptive banners make an extra request on each rotation.

1.0.2 #

  • Banner Creative Snug-Fitting & Letterbox Elimination (BannerAdWidget / BannerAdWidget.adaptive):
    • AdMob WebView Background Normalization:
      • Automatically clears AdMob WebView's <body style="background-color:#000000"> black letterbox background to transparent, preventing black bars when adaptive slots are taller than the creative.
      • Re-aligns internal #google-center-div to vertical-align: top so banner creatives flush snugly against the top edge and align with the "Test Ad" badge.
    • Rendered Creative Height Auto-Detection (syncBannerWebViewCreativeBounds):
      • Injected lightweight JavaScript evaluator into s41 (gmaWebView) to probe #google_image_div / rendered image bounds and fire onAdSizeChanged to shrink BannerAdWidget to the exact rendered creative height (e.g. 53dp for scaled 468x60 ads in a 411x64 adaptive slot).
    • Platform View Container Protection (AdPlatformContainerFrameLayout):
      • Created custom AdPlatformContainerFrameLayout container on Android that measures AdView with MeasureSpec.UNSPECIFIED while clipping to the exact rendered creative height, completely preventing GMA Next-Gen SDK's "Not enough space to show ad" error.
  • Workspace & Package Cleanup:
    • Removed internal tracking spreadsheet from repository and package distribution.
    • Synchronized all developer rules and workflow skills in .agents/rules and .agents/skills with v1.0.2 architecture and standards.

1.0.1 #

  • Dynamic / Intrinsic Height Auto-Resizing (height == null) without Ad Reloading:
    • Native Ad Intrinsic Height Auto-Adjustment (NativeAdWidget):
      • Changed height to default to null across NativeAdWidget and all named preset constructors (.small, .medium, .fromPreset, .normal, .nativeViewSmall, .medium01, .nativeView, .figmaMedium, .mediaView, .mediaViewTopCta, .mediaViewSplitCenter, .mediaViewSplitRight, .mediaViewLarge, .big, .cls, .interstitial, .dark).
      • When height == null, the widget automatically resizes to the exact measured intrinsic height of the native ad (platformAdHeight / loadedHeight) without triggering an ad reload.
      • When an explicit height is provided (height != null), the widget strictly respects the caller's specified height.
      • Added onAdSizeChanged listener callback to AdWithViewListener and NativeAdListener.
      • Synchronized layout rebinding (rebindLayout) and swapPlatformViewAd to notify Flutter of newly measured dimensions and update SizedBox dimensions in-place.
    • Banner Ad Dynamic Height Auto-Adjustment (BannerAdWidget):
      • Added optional width and height parameters (null by default) to BannerAdWidget and BannerAdWidget.adaptive.
      • When height == null, the container dynamically resizes to the loaded platformAdSize without reloading the ad.
      • Updated BannerAdWidget.adaptive and BannerAdPool to request standard 'anchoredAdaptive' (AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize) instead of 'largeAnchoredAdaptive', matching Google's official adaptive height formula (~50dp–64dp on phones) and preventing oversized ~128dp slots with black bars above and below 60dp creatives.
      • Added measureBannerAdViewIntrinsic, resolveBannerLoadedSizeDp, syncBannerWebViewCreativeBounds, and AdPlatformContainerFrameLayout in GoogleAdmobSdkPlugin.kt to query BannerAd.getAdSize(), clear AdMob WebView's <body style="background-color:#000000"> letterbox background, align #google-center-div to vertical-align: top, and resize BannerAdWidget to the exact rendered #google_image_div creative height (53dp for scaled 468x60 inside 411x64) without triggering "Not enough space to show ad".
      • Added onAdSizeChanged callback to BannerAdListener and wired size change notifications on initial load, adaptive re-measurements, and auto-refreshes (onAdRefreshed).
    • Elimination of Excess Blank Space & Layout Measurement Hardening:
      • Android (GoogleAdmobSdkPlugin.kt):
        • Added measureNativeAdViewIntrinsic to compute the true intrinsic content height via MeasureSpec.UNSPECIFIED (temporarily constraining internal SDK AdChoices overlay views to WRAP_CONTENT during measurement).
        • Added createContainerLayoutParamsForAdView using WRAP_CONTENT height for inline NativeAdView and AdView (instead of MATCH_PARENT), completely eliminating unwanted blank white space beneath native ad cards.
        • Fixed pre-mounted container squashing for BannerAd: banners (~90dp) now measure with MeasureSpec.UNSPECIFIED height instead of being clipped to the initial shimmer container height (~69dp).
        • Attached containerLayoutListeners (OnLayoutChangeListener) to dynamically report onAdSizeChanged events to Flutter whenever container dimensions change.
      • iOS (GoogleAdmobSdkPlugin.swift):
        • Added intrinsic height calculation for Figma presets, returning loadedWidth and loadedHeight in nativeMetadata and onAdLoaded.
        • Added native handler for rebindNativeAdLayout and updated swapPlatformViewAd to emit onAdSizeChanged.
    • Build & Gradle Duplicate Class Fixes:
      • Resolved :app:checkDebugDuplicateClasses build failure caused by duplicate com.google.android.gms.ads.* classes between Next-Gen SDK ads-mobile-sdk:1.6.0 and transitive play-services-ads-api:25.5.0 via explicit Gradle exclude rules in android/build.gradle.kts and example/android/app/build.gradle.kts.

1.0.0 #

  • Google Mobile Ads (GMA) Next-Gen SDK (com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0) Migration & Compliance Hardening:
    • GMA Next-Gen SDK Native Engine:
      • Migrated Android native runtime from legacy com.google.android.gms:play-services-ads to com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0 and com.google.android.ump:user-messaging-platform:4.0.0.
      • Added InitializationConfig, format-specific AdRequest classes (BannerAdRequest, NativeAdRequest, AppOpenAdRequest), BannerAd.isCollapsible(), MobileAds.setUserControlledAppMuted(...), and Next-Gen Preloader APIs (InterstitialAdPreloader, RewardedAdPreloader, RewardedInterstitialAdPreloader, AppOpenAdPreloader).
      • Upgraded all 7 bundled mediation adapters to their latest Next-Gen compatible artifacts (applovin:13.6.4.2, facebook:6.22.0.1, mintegral:17.1.81.1, unity:4.21.0.0, pangle:8.3.0.4.0, ironsource:9.6.1.0, vungle:7.7.8.1) with scoped exclusion of legacy play-services-ads.
      • Updated all built-in XML Native layouts (admob_native_cls.xml, admob_native_mediaview.xml, admob_native_mediaview_bottom_cta.xml, admob_native_interstitial.xml, admob_native_small.xml) to com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView, MediaView, and AdChoicesView.
    • UMP "Privacy Options" (GDPR) Compliance (Android & iOS):
      • Added ConsentInformation.instance.getPrivacyOptionsRequirementStatus(), ConsentInformation.instance.isPrivacyOptionsRequired(), ConsentForm.showPrivacyOptionsForm(...), and GoogleAdmobSdk.showPrivacyOptionsForm().
      • Implemented getPrivacyOptionsRequirementStatus and showPrivacyOptionsForm on both Android (UserMessagingPlatform.showPrivacyOptionsForm) and iOS (ConsentForm.presentPrivacyOptionsForm).
    • Consent-Safe Boot Warm-Up & Strict InitializationConfig Handling:
      • Removed premature MobileAds.initialize from AdmobFastBootProvider so process boot only warms up Chromium WebView, DNS cache, and XML ViewPools without starting the AdMob SDK or 3rd-party mediation adapters before UMP consent.
      • Added release-build validation in resolveAdMobAppId to fail fast with a clear MISSING_APP_ID error if com.google.android.gms.ads.APPLICATION_ID is omitted in release builds.
      • Added Meta Audience Network CCPA Limited Data Use (AdSettings.setDataProcessingOptions(["LDU"], 0, 0)) and structured warning logs in applyThirdPartyPrivacyConsent.
    • Next-Gen Adaptive Banner AdSize APIs:
      • Tagged adaptive AdSize instances with sizeType ('anchoredAdaptive', 'largeAnchoredAdaptive', 'inlineAdaptive', 'fluid'), orientation, and maxHeight.
      • Resolved native AdSize on Android and iOS using AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize, AdSize.getLargeAnchoredAdaptiveBannerAdSize, and AdSize.getInlineAdaptiveBannerAdSize, returning resolved dimensions via BannerAd.platformAdSize.
    • Zero-Leak In-Flight Ad Disposal & Main-Thread UI Safety:
      • Tracked disposedAdIds and disposeGeneration in native Android & iOS so in-flight ads that finish loading after disposeAd(adId) are immediately destroyed (ad.destroy()) and never leaked in memory.
      • Enforced runOnMainThread across all View/MethodChannel callbacks invoked from GMA Next-Gen SDK's background Publisher Callback threads.

0.1.0 #

  • Complete Figma Native (23 Presets) & Native Fullscreen + Video (12 Variants) Catalog + 0.0ms Frame #1 Rendering Engine:
    • 23 Built-in Figma NativeTemplatePreset Layouts:
      • Added full support and named constructors on NativeAdWidget and AdmobNativeStyles for all Figma Native designs: small (100dp), normal (132dp, 57:964), nativeViewSmall (136dp, 57:1032), medium01 (182dp, 57:977), nativeView (203dp, 57:1013), medium / figmaMedium (272dp, 57:992), mediaView (272dp, 57:1049), mediaViewTopCta (272dp, 57:1069), mediaViewSplitCenter (272dp, 57:1089), mediaViewSplitRight (272dp, 57:1109), mediaViewLarge (272dp, 57:1129), big (282dp, 57:1149), cls (282dp, 57:1167), clsOrange (282dp, 57:1185), interstitial (380dp, 70:6181), dark (272dp), plus 7 fullscreen layout presets.
    • 12 Built-in Figma NativeFullScreenVariant (Fullscreen & Video) Layouts:
      • Added NativeFullScreenVariant (classicCard, tallMediaStackedButtons, headerTopTallMedia, tallMediaArrowNext, immersiveVideo, segmentedArrowNext, segmentedClose, segmentedSplitButtons, tallMediaProgressClose, blurredCardStackedButtons, segmentedClassicCard, segmentedFloatingCta) matching Figma nodes 57:1203 – 57:1540.
      • Added embeddable NativeFullScreenAdWidget (with 12 named constructors) and upgraded showNativeAdInterstitialDialog + NativeAdInterstitialDialog.warmUp(...).
    • 0.0ms Frame #1 Dual-Layer Instant Render & 0ms Hot-Swap (Android & iOS Parity):
      • Implemented FigmaNativeAdPreview in ad_core.dart rendering all 23 Figma presets in 0.0ms on Frame #1 on both Android and iOS using NativeAdMetadata (headline, body, callToAction, advertiser, starRating, iconBytes, imageUri, mediaAspectRatio, hasVideoContent).
      • Upgraded GoogleAdmobSdkPlugin.kt (Android) and GoogleAdmobSdkPlugin.swift (iOS) with pre-inflated/pre-bound NativeAdView / GADNativeAdView builders, Eager Surface Pre-Mounting (containerId = -widgetId), and 0ms swapPlatformViewAd hot-swapping.
      • Added layout-accurate NativeAdShimmer (NativeShimmerLayout) skeletons for all 23 presets to ensure Zero Cumulative Layout Shift (Zero-CLS).

0.0.9 #

  • Advanced Revenue & Enterprise Monetization Optimizations:
    • Anchored Adaptive Banners (BannerAdWidget.adaptive):
      • Added BannerAdWidget.adaptive(...) factory and isAdaptive: true support to dynamically calculate optimal anchored banner height using AdSize.getLargeAnchoredAdaptiveBannerAdSize(...).
      • Eliminates letterboxing, side gutters, and vertical text clipping across modern devices and tablets.
    • High-eCPM Collapsible Banner Ads:
      • Added CollapsiblePlacement enum (none, bottom, top) and parameter to BannerAdWidget.
      • Automatically injects {'collapsible': 'bottom'|'top'} extras into AdRequest, rendering an expandable overlay on first load with a close toggle that yields 2x–4x higher eCPM compared to static banners.
    • Server-Side Verification (SSV) for Rewarded Ads:
      • Added ServerSideVerificationOptions support to RewardedAdManager and RewardedInterstitialAdManager.
      • Exposes setServerSideVerificationOptions(...) and serverSideVerificationOptions parameter in loadAd(...).
      • Google AdMob servers validate rewarded ad views through direct webhook callbacks to the backend, preventing client-side reward manipulation and virtual currency spoofing.
    • Automated Background-to-Foreground App Open Reactor (AppLifecycleReactor):
      • Implemented AppLifecycleReactor implementing WidgetsBindingObserver to manage background-to-foreground transitions.
      • Configurable minBackgroundDuration (default 15s) prevents annoying ad popups on rapid app switching or system permission dialogs.
      • Configurable minShowInterval (default 5 minutes) and custom canShowAd predicate (e.g. skip ads during checkout flows).
    • COPPA & Ad Content Rating Compliance in Initialization:
      • Added maxAdContentRating (MaxAdContentRating.g, pg, t, ma) and ageRestrictedTreatment (TagForChildDirectedTreatment.yes, no) in GoogleAdmobSdk.initialize.
      • Ensures compliance with Google Play Families Policy and EU GDPR-K.
    • Google UMP (User Messaging Platform) Consent Flow & Enterprise Tools:
      • Added GoogleAdmobSdk.requestConsentIfRequired(...) to automate IAB TCF v2.2 GDPR/UK consent management, preventing 100% No-Fill (Error Code 3) penalties in European markets.
      • Added GoogleAdmobSdk.openAdInspector(...) for real-time on-device mediation and bidding inspection.
      • Added GoogleAdmobSdk.setAppMuted(bool) and GoogleAdmobSdk.setAppVolume(double) for global video ad audio control.
    • Fullscreen Concurrency Guards & Ad Collision Prevention:
      • Added atomic isShowing state tracking across all fullscreen managers (InterstitialAdManager, RewardedAdManager, RewardedInterstitialAdManager, AppOpenAdManager).
      • Added global GoogleAdmobSdk.instance.isAnyFullScreenAdShowing and lastFullScreenAdDismissedTime state coordination.
      • Safely blocks rapid double-tap or simultaneous showAd / showAdSafely requests, eliminating native PlatformException: Ad already presented exceptions.
      • Protects AppLifecycleReactor by automatically suppressing App Open Ads immediately after closing Interstitial or Rewarded Ads.
    • In-Flight Request Deduplication & Multi-Caller Caching (Completer<bool>):
      • Implemented single-flight request deduplication across all 4 fullscreen managers (InterstitialAdManager, RewardedAdManager, RewardedInterstitialAdManager, AppOpenAdManager).
      • Concurrent loadAd() calls attach to the single active network request instead of triggering multiple duplicate requests or dropping calls with false.
      • Eliminates request spamming to Google AdMob servers and preserves high Match Rate (> 85-95%).
    • BannerAdPool & Multi-Widget Banner Caching:
      • Added BannerAdPool and cacheKey / preloadedAd properties to BannerAdWidget and BannerAdWidget.adaptive, matching NativeAdPool.
      • Allows caching and reusing banners across tabs and screen transitions without repeatedly requesting new banner ads.

0.0.8 #

  • Critical AdMob Metrics, Traffic Quality & Match/Show Rate Protection:
    • Ad Quality, Show Rate & Match Rate Protection Architecture:
      • Ad TTL & 60-Minute Expiration Auto-Invalidation:
        • Added maxAdAge (60 minutes for Interstitial, Rewarded, and Rewarded Interstitial; 4 hours for App Open) in accordance with Google AdMob policy.
        • Added isAdAvailable and loadTime getters across all managers.
        • Automatically invalidates and disposes expired ads to prevent displaying stale ads that cause invalid impressions and account-level policy penalties.
      • Exponential Backoff & Circuit Breaker (AdRetryPolicy):
        • Integrated AdRetryPolicy into all managers to prevent rapid request storms on ERROR_CODE_NO_FILL (Code 3) or network loss.
        • Implements backoff sequence (2s $\rightarrow$ 4s $\rightarrow$ 8s $\rightarrow$ 16s $\rightarrow$ 60s) and trips a Circuit Breaker when consecutive failures exceed the threshold, protecting Ad Unit Quality Score and Match Rates.
      • Smart Auto-Reload & Delay Capping:
        • Added GoogleAdmobSdk.instance.enableAutoReload and autoReloadDelay to eliminate orphan preloads (ads loaded upon dismissal that are abandoned when the user leaves the app).
      • Realtime Inventory Health Monitor (AdHealthMonitor):
        • Added AdHealthMonitor accessible via GoogleAdmobSdk.instance.healthMonitor (.health).
        • Computes realtime Match Rate, Show Rate, and CTR with automatic warnings when Show Rate $< 50%$ or consecutive No-Fill errors occur.
    • Frequency Capping & Safe Interstitial Flow:
      • Added InterstitialAdManager.shared singleton instance to retain preloaded interstitial ads across screens and lifecycle transitions.
      • Integrated Frequency Capping (minShowInterval, defaults to 180 seconds - 3 minutes) with canShow and remainingCooldown getters to prevent excessive CTR and accidental clicks (Invalid Traffic policy penalties).
      • Added showAdSafely(...) with configurable countdown notice dialog (AdCountdownDialog / showWarningCountdown), smoothly notifying users before fullscreen ad presentation.
      • Added AdCountdownConfig and exposed parameters countdownTitle, countdownSubtitle, and countdownConfig across InterstitialAdManager, RewardedAdManager, and RewardedInterstitialAdManager for custom styling and internationalization (i18n).
      • Enhanced showNativeAdInterstitialDialog with custom styling parameters (backgroundColor, height, showProgressBar, progressColor, closeButton, topBar, contentPadding).
      • Standardized all user-facing dialogs, examples, and internal doc comments to English.
    • Rewarded & Rewarded Interstitial Shared Singletons:
      • Added RewardedAdManager.shared and RewardedInterstitialAdManager.shared to resolve 0% Show Rate caused by orphan preloaded ads being disposed during screen navigation.
      • Added showAdSafely(...) to both rewarded managers.
    • App Open Ad Shared Singleton:
      • Added AppOpenAdManager.shared global instance for app open lifecycle handling.
    • Banner & Native Ad KeepAlive & State Retention:
      • Integrated AutomaticKeepAliveClientMixin (keepAlive: true by default) in both BannerAdWidget and NativeAdWidget to eliminate ad destruction and reload cycles during ListView/GridView/TabBarView scrolling and tab switches.
      • Added NativeAdPool cache pool (cacheKey) and preloadedAd support to reuse loaded native ads across feeds and tabs, resolving the 24–34 impressions/user spam issue.
    • Bidding & Mediation Troubleshooting (0.00% Bids Resolution):
      • Added Pangle (TikTok / ByteDance) mediation adapter setup for Android (com.google.ads.mediation:pangle:6.4.0.6.0) and iOS (GoogleMobileAdsMediationPangle).
      • Added comprehensive root-cause analysis and troubleshooting checklist in doc/MEDIATION_SETUP_GUIDE.md and README.md addressing why apps experience 0.00% bids when native adapters are omitted.

0.0.7 #

  • Native Ad Styles, Presets & Custom Layouts:
    • Added NativeTemplatePreset enum with clean preset names (mediaView, cls, interstitial, small, dark) matching modern design tokens, with deprecated figma* aliases for backward compatibility:
      • mediaView: Matches Figma node 70:6182 (Ads?Native_mediaview) with #1A90FF CTA, white background, 10px corner radius, and subtle typography.
      • cls: Matches Figma node 70:6183 (Ads/Native_cls) with CLS-optimized layout and palette.
      • interstitial: Matches Figma node 70:6181 (Ads Interstitial) with prominent 16px title, 14px body, and 10px rounded corners.
      • small: Compact small template using the modern design tokens.
      • dark: Dark mode theme (#1E1E1E background).
    • Added AdmobNativeStyles factory class with predefined factory methods (mediaView, cls, interstitial, small, dark, fromPreset, and custom) alongside deprecated figma* aliases.
    • Enhanced NativeAdWidget with templatePreset, decoration, margin, padding, and borderRadius properties. Gracefully defaults to mediaView when neither nativeTemplateStyle nor factoryId is supplied, preventing assertion errors out-of-the-box.
    • Added Custom Layout Support in NativeAdWidget:
      • layoutBuilder: Custom builder allowing developers to place the ad view anywhere in their custom widget hierarchy.
      • Integrated layout slots: header, footer, badge, badgeAlignment, showCloseButton, onClose, closeButtonAlignment, and aspectRatio.
      • Added customOptions map forwarding to NativeAd for custom platform factories.
    • Added showNativeAdInterstitialDialog and NativeAdInterstitialDialog reproducing the fullscreen Figma "Ads Interstitial" layout (Node 70:6181) with top bar indicator, close button, and Databuckets tracking.
    • Added complete native platform factory guide doc/CUSTOM_NATIVE_LAYOUTS.md with Android XML and iOS Swift templates.
    • Updated Example app with interactive Native Ad styles switcher (MediaView vs CLS) and fullscreen Native Interstitial Dialog demonstration.

0.0.6 #

  • Tag & Logging Enhancements:
    • Standardized bracketed tag [GoogleAdmobSdk] across all log outputs for easy search and filtering in Android Studio Logcat.
    • Added configurable logTag parameter (defaults to [GoogleAdmobSdk]) in GoogleAdmobSdk.initialize, with runtime getter GoogleAdmobSdk.instance.logTag and setter GoogleAdmobSdk.instance.setLogTag(String).
    • Added custom log interceptor callback onLog in GoogleAdmobSdk.initialize and runtime setter GoogleAdmobSdk.instance.setOnLog(callback).
    • Silenced repetitive uninitialized Firebase warning in FirebaseAdLogger when Firebase is not configured in the host app.
  • Dependency Compatibility:
    • Expanded dependency ranges: firebase_analytics: '>=12.4.6 <13.0.0' and firebase_core: '>=4.13.0 <5.0.0' for maximum compatibility across Flutter apps.

0.0.5 #

  • Device & Console Logging Enhancements:
    • Added enableDeviceLog and enableLogging flags in GoogleAdmobSdk.initialize to output formatted logs directly to Android Studio Logcat and iOS console across all build modes (Debug, Profile, and Release).
    • Added runtime logging toggle GoogleAdmobSdk.instance.setLoggingEnabled(bool).
    • Formatted output displaying detailed diagnostics for AdMob Load Success (format, unit ID, placement, load duration ms, network), Load Failure (error code, error message, duration), Impressions (with revenue value), Clicks, and Fullscreen Ad Completions.

0.0.4 #

  • Android Built-in Kotlin Migration:
    • Migrated plugin build configuration from external Kotlin Gradle Plugin (org.jetbrains.kotlin.android) to AGP Built-in Kotlin (id("com.android.library")), resolving Flutter KGP deprecation warnings.
    • Configured unified JVM target 17 across Java and Kotlin tasks (tasks.withType<KotlinCompile>).
  • Dependency Updates & Compatibility:
    • Updated and verified dependencies: google_mobile_ads: ^9.1.0, firebase_analytics: ^12.4.6, firebase_core: ^4.13.0, flutter_lints: ^6.0.0.
    • Re-exported firebase_core and firebase_analytics from the main barrel file for convenient access.
    • Made FirebaseAdLogger resilient with lazy initialization to prevent crashes when Firebase is not yet configured.
  • AI-Ready Context & Developer Documentation:
    • Added root AGENTS.md, workspace rules (.agents/rules/), and workflow skill (.agents/skills/google-admob-sdk-guide/).
    • Added comprehensive architecture, ad format, and Databuckets tracking documentation in doc/ (ARCHITECTURE.md, AD_FORMATS_GUIDE.md, DATABUCKETS_TRACKING.md, TESTING_AND_CONTRIBUTING.md).
  • Package Publishing & Quality:
    • Optimized .pubignore and .gitignore to keep published archive size ultra-compact (~267 KB).
    • Excluded build artifacts in analysis_options.yaml with 0 analysis issues and 100% test coverage.
    • Synchronized example project dependencies and configuration.

0.0.3 #

  • Fixed onPaidEvent setter error in BannerAdWidget and NativeAdWidget by passing onPaidEvent directly as a parameter in BannerAdListener and NativeAdListener.
  • Expanded logAdRequest with support for full Databuckets Sheet 41 parameters: ad_request_id, ad_unit_name, ad_mediation, screen_name, error_code, error_message, ad_mediation_ab_test_name, ad_mediation_ab_test_variant, session_number, ad_source_instance, ad_source_instance_id, ad_source, ad_source_id, media_format.
  • Added dual event firing for Sheet 41 Universal IAA events (iaa_request, iaa_loaded, iaa_fail_load, iaa_impression, iaa_fail_show, iaa_click, iaa_complete) alongside legacy ad_* events.
  • Updated all ad widgets (BannerAdWidget, NativeAdWidget) and ad managers (InterstitialAdManager, RewardedAdManager, RewardedInterstitialAdManager, AppOpenAdManager) to accept the new tracking parameters and automatically log them during ad load requests.
  • Fully verified and aligned all IAA tracking events with Technify <> Databuckets - 41.csv specification.

0.0.2 #

  • Added adKey parameter support across all ad widgets and managers, sending ad_key and type-specific key_<ad_type> parameters (key_banner, key_interstitial, key_rewarded, key_rewardedInterstitial, key_appOpen, key_native) to Firebase Analytics.
  • Added RewardedInterstitialAdManager for Rewarded Interstitial Ads with official Google test IDs.
  • Added NativeAdWidget for Native Ads with customizable NativeTemplateStyle and NativeAdOptions.
  • Added customizable progressIndicator property to BannerAdWidget and NativeAdWidget.
  • Added comprehensive unit test suite covering all configurations, loggers, and ad managers.

0.0.1 #

  • Initial release of google_admob_sdk.
  • Added GoogleAdmobSdk manager for centralized SDK initialization.
  • Added AdIdConfig for managing Android & iOS Ad Unit IDs with Google test IDs fallback.
  • Added AdAnalyticsLogger supporting FirebaseAdLogger and ConsoleAdLogger.
  • Added BannerAdWidget widget for automatic banner state management.
  • Added InterstitialAdManager, RewardedAdManager, and AppOpenAdManager.
1
likes
130
points
555
downloads

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

A self-managed, high-speed Flutter plugin for Google Mobile Ads Next-Gen SDK & 3rd-Party Ad Networks (AppLovin, Meta, Mintegral, Unity Ads, Pangle, IronSource, Liftoff) with centralized Ad Unit ID management, waterfall fallback, and Databuckets analytics.

Repository (GitLab)
View/report issues

Topics

#ads #admob #mediation #monetization #analytics

License

MIT (license)

Dependencies

firebase_analytics, firebase_core, flutter

More

Packages that depend on google_admob_sdk

Packages that implement google_admob_sdk