google_mobile_ads

• Adding Ad Preloading APIs. PR 1445
• Support AdManagerBannerAd recycling by exposing isMounted. PR 1443
• Added setConsentSyncId() on ConsentRequestParameters. PR 1452
• Introduces ageRestrictedTreatment property to RequestConfiguration. PR 1455
• Null-safe return values across the plugin. PR 1461
• Updates GMA Android SDK dependencies:
  • Google Mobile Ads SDK version 25.4.0.
  • Google Mobile Ads Next-Gen SDK version 1.3.1.
• Updates GMA iOS dependency to 13.7.0.
• Uses latest UMP SDK:
  • Android UMP SDK version 4.0.0.
  • iOS UMP SDK version 3.1.0.

• Adding Ad Preloading APIs. PR 1445
• Support AdManagerBannerAd recycling by exposing isMounted. PR 1443
• Added setConsentSyncId() on ConsentRequestParameters. PR 1452
• Introduces ageRestrictedTreatment property to RequestConfiguration. PR 1455
• Null-safe return values across the plugin. PR 1461
• Updates GMA Android SDK dependencies:
  • Google Mobile Ads SDK version 25.4.0.
  • Google Mobile Ads Next-Gen SDK version 1.3.1.
• Updates GMA iOS dependency to 13.7.0.
• Uses latest UMP SDK:
  • Android UMP SDK version 4.0.0.
  • iOS UMP SDK version 3.1.0.

What's Changed

• Bump styfle/cancel-workflow-action from 0.13.0 to 0.13.1 by @dependabot[bot] in #1424
• Adding Next Gen GMA SDK for Android by @LTPhantom in #1434
• Resolve pending start/stop method channel futures in AppStateNotifier by @LTPhantom in #1438
• GMA SDK plugin major version bump to 9.0.0 by @LTPhantom in #1439
• Completed missing callbacks for NextGen GMA SDK by @LTPhantom in #1440

Full Changelog: v8.0.0...v9.0.0

• Resolves pending start/stop method channel futures in AppStateNotifier Android. PR 1438
• Updates GMA Android SDK dependencies:
  • Google Mobile Ads SDK version 25.3.0.
  • Google Mobile Ads Next-Gen SDK version 1.1.0.
• Updates GMA iOS dependency to 13.3.0.
• Uses latest UMP SDK:
  • Android UMP SDK version 4.0.0.
  • iOS UMP SDK version 3.1.0.

Release Notes

Visit https://pub.dev/packages/google_mobile_ads/changelog to see the official release notes

What's Changed

• Workflow fix by @LTPhantom in #1408
• Workflow fix by @LTPhantom in #1409
• Bump actions/setup-java from 4 to 5 by @dependabot[bot] in #1347
• Bump actions/upload-artifact from 4 to 6 by @dependabot[bot] in #1379
• Update CODEOWNERS by @LTPhantom in #1407
• Bump actions/checkout from 4.2.2 to 6.0.2 by @dependabot[bot] in #1398
• Bump actions/upload-artifact from 6 to 7 by @dependabot[bot] in #1414
• Bump styfle/cancel-workflow-action from 0.12.1 to 0.13.0 by @dependabot[bot] in #1415
• Adds ‎google_mobile_ads support for Swift Package Manager by @stuartmorgan-g in #1395
• Migration to use UISceneDelegate protocol. by @LTPhantom in #1421
• Adds isCollapsible API for BannerAd by @LTPhantom in #1425
• Renaming of initWithInt method inside FLTNSString by @LTPhantom in #1426
• GMA SDK major version update 8.0.0 by @LTPhantom in #1427
• Fixes Native Ads template for iOS | Increases minimum Flutter version by @LTPhantom in #1428

New Contributors

• @stuartmorgan-g made their first contribution in #1395

Full Changelog: v7.0.0...v8.0.0

• Updates minimum Flutter SDK to 3.38.1
• Updates Dart SDK low bound to 3.10.0.
• Adds Swift Package Manager Support for the plugin. PR 1395
• Adds isCollapsible API. FR 1294
• Renamed method name to avoid possible name collision. FR 1394
• Migrated to use UISceneDelegate protocol. Issue 1391
• New to Anchored adaptive banner ads:
  • The following APIs have been deprecated for their replacement:
    • The getCurrentOrientationAnchoredAdaptiveBannerAdSize function is deprecated. Instead, use the getLargeAnchoredAdaptiveBannerAdSize function.
    • The getAnchoredAdaptiveBannerAdSize function is deprecated. Instead, use the getLargeAnchoredAdaptiveBannerAdSizeWithOrientation function.
• Updates GMA Android dependency to 25.1.0
• Updates GMA iOS dependency to 13.2.0
• Uses latest UMP SDK:
  • Android UMP SDK version 4.0.0.
  • iOS UMP SDK version 3.1.0.

GMA SDK major version update 7.0.0 (#1369)

* Fix Native Ads templates

* Updated iOS project, updated inline banner ad unit in example app

* Correctly set new low bounds for Flutter and Dart versions

* Updated minSdk for Android to make it compatible with Flutter versions

* Format fix

* Added more contraints on Native Ad template to avoid unexpected button behaviors

* Made the release a major release (7.0.0)

* Updated Android GMA SDK to 24.9.0

* Modified layout contraints to let CTA button in Native Ad to not be pushed away

• Added character limits expected for Native Ad Templates. Issues 1243 and 1332
• Fixed padding for Native Ads small template. Issue 1357
• Updated to use Gradle plugin 9.2.1 Issue 1361
• Updates dependencies. Issue 1366
• Updates GMA Android dependency to 24.9.0
• Updates GMA iOS dependency to 12.14.0
• Uses latest UMP SDK:
  • Android UMP SDK version 4.0.0.
  • iOS UMP SDK version 3.1.0.

• Updates minimum Flutter SDK to 3.27.0
• Updates Dart SDK low bound to 3.6.0.
• Fixes AdMessageCodec deprecated API issue: https://github.com/googleads/googleads-mobile-flutter/issues/1242
• Adds a new API (isMounted) to support recycling ad banners
• Updates GMA Android dependency to 24.1.0
• Updates GMA iOS dependency to 12.2.0
• Uses latest UMP SDK:
  • Android UMP SDK version 3.2.0.
  • iOS UMP SDK version 3.0.0.

• Fixes dart SDK low bound building issues: #1234

• Fixes dart SDK low bound building issues: https://github.com/googleads/googleads-mobile-flutter/issues/1234

• Updated WebView Flutter Android dependency
• Adds support for the new Debug Geography enums for the UMP SDK
• Adds support for the new Debug Geography enums for the UMP SDK:
  • Android UMP SDK version 3.1.0.
  • iOS UMP SDK version 2.7.0.
• Updates GMA iOS dependency to 11.13.0
• Updates GMA Android dependency to 23.6.0

• Updated WebView Flutter Android dependency
• Adds support for the new Debug Geography enums for the UMP SDK:
  • Android UMP SDK version 3.1.0.
  • iOS UMP SDK version 2.7.0.
• Updates GMA iOS dependency to 11.13.0
• Updates GMA Android dependency to 23.6.0

• Removed use of rootViewController for iOS GMA SDK which solved issues like
  #1146 and #700.
• Android GMA SDK is now initialized on a background thread.
• Updates GMA iOS dependency to 11.10.0
• Updates GMA Android dependency to 23.4.0

• Removed use of rootViewController for iOS GMA SDK which solved issues like https://github.com/googleads/googleads-mobile-flutter/issues/1146 and https://github.com/googleads/googleads-mobile-flutter/issues/700.
• Android GMA SDK is now initialized on a background thread.
• Updates GMA iOS dependency to 11.10.0
• Updates GMA Android dependency to 23.4.0

• Adds support for APIs from the Android UMP SDK version 2.2.0.
• Adds support for APIs from the iOS UMP SDK version 2.4.0.

• Adds support for APIs from the Android UMP SDK version 2.2.0.
• Adds support for APIs from the iOS UMP SDK version 2.4.0.

• Adds MediationExtras class to include parameters when using mediation through the implementation of FlutterMediationExtras in Android and FlutterMediationExtras in iOS.
• Deprecates MediationNetworkExtrasProvider and FLTMediationNetworkExtrasProvider.
• Removed the orientation parameter for the AppOpen Ad format.
• Bumps minimum Android SDK version to 21.
• Updates GMA iOS dependency to 11.2.0
• Updates GMA Android dependency to 23.0.0

• Adds MediationExtras class to include parameters when using mediation through the implementation of FlutterMediationExtras in Android and FlutterMediationExtras in iOS.
• Deprecates MediationNetworkExtrasProvider and FLTMediationNetworkExtrasProvider.
• Removed the orientation parameter for the AppOpen Ad format.
• Bumps minimum Android SDK version to 21.
• Updates GMA iOS dependency to 11.2.0
• Updates GMA Android dependency to 23.0.0

• The minimum supported Flutter version is now 3.7.0.
• Removes visibility_detector as a dependency, and the workaround added in https://github.com/googleads/googleads-mobile-flutter/pull/610.
• Adds null checks for Ad Ids for Android in https://github.com/googleads/googleads-mobile-flutter/pull/967
• Updated Android dependencies in https://github.com/googleads/googleads-mobile-flutter/pull/843
• Updates GMA iOS dependency to 10.11.0
• Updates GMA Android dependency to 22.5.0

• Updates GMA iOS dependency to 10.9.0
• Adds explicit UMP SDK 2.1.0 dependency for Android.
• Fixes https://github.com/googleads/googleads-mobile-flutter/issues/735

SHA1 Checksum c033b599479d618afd79cbf947dc9dbb21d4fc4a Size 0.2 MB

Download googleusermessagingplatform.zip

Release notes

Version Release Date Notes

3.1.0 2025-10-29

• Added -[UMPRequestParameters setConsentSyncID] API to sync a user’s consent across apps configured for consent syncing.

3.0.0 2025-03-24

• Breaking changes :

• Updated the minimum supported Xcode version to 16.0.

• Updated Swift API names to follow the naming conventions from Apple’s Swift API Design Guidelines .

Version 2 Version 3 Classes

UMPConsentForm ConsentForm

UMPConsentInformation ConsentInformation

UMPConsentStatus ConsentStatus

UMPDebugGeography DebugGeography

UMPDebugSettings DebugSettings

UMPFormErrorCode FormErrorCode

UMPFormStatus FormStatus

UMPPrivacyOptionsRequirementStatus PrivacyOptionsRequirementStatus

UMPRequestErrorCode RequestErrorCode

UMPRequestParameters RequestParameters

UMPVersionString Version

Properties

sharedInstance shared

tagForUnderAgeOfConsent isTaggedForUnderAgeOfConsent

• Added internal functionality to call Firebase consent APIs when consent mode support is configured through Privacy & messaging .

2.7.0 2024-10-30

• To support testing with regulated US states, added the following options to UMPDebugGeography :

• UMPDebugGeographyRegulatedUSState

• UMPDebugGeographyOther

• Deprecated UMPDebugGeographyNotEEA . Use UMPDebugGeographyOther instead.

2.6.0 2024-09-05

• UIViewController references for consent messages are now nullable and not required. The SDK uses the app’s main window to look up view controllers automatically when one is not provided.

2.5.0 2024-06-26

• Updated canRequestAds API to return true when the app has no privacy messages configured.

• Updated nullability on -[UMPConsentForm init] from nullable to nonnull .

2.4.0 2024-04-24

• Updated the signing identity from AdMob Inc. to Google LLC using team ID EQHXZ8M8AV . If this triggers a notice in Xcode, select “Accept Change” to accept the new identity.

2.3.0 2024-03-14

• Added support for privacy manifest files .

• Updated the Info.plist to work around a Swift Package Manager issue on Xcode 15.3.

2.2.0 2024-02-20

• Increased minimum supported Xcode version to 15.1.

• Increased iOS minimum deployment target to 12.0.

• Removed all references to advertisingIdentifier .

• Added Info.plist files to make the SDK compatible with

• Adds support for MobileAds.registerWebView(). This API supports in-app ad monetization for WebViews. You can read more in the android or iOS documentation. This plugin now depends on webview_flutter, webview_flutter_wkwebview, and webview_flutter_android
• Updates Android GMA dependency to 22.0.0 and iOS dependency to 10.4.0
• Fixes https://github.com/googleads/googleads-mobile-flutter/issues/700
• Updates minimum supported Xcode version to 14.1.

• Adds support for native templates, which are predefined layouts for native ads.
  • NativeAd has a new optional parameter, nativeTemplateStyle of type NativeTemplateStyle. If provided, the plugin will inflate and style a platform native ad view for you, instead of requiring you to write and register a NativeAdFactory (android) or FLTNativeAdFactory (iOS).
• Adds a new flag, AdWidget.optOutOfVisibilityDetectorWorkaround. Setting this to true lets you opt out of the fix added for https://github.com/googleads/googleads-mobile-flutter/issues/580, which was resolved in Flutter 3.7.0.

• Updates GMA iOS dependency to 9.13
• Updates GMA Android dependency to 21.3.0
• Updates request agent string based on metadata in AndroidManifest.xml or Info.plist

• Updates GMA iOS dependency to 9.11.0. This fixes dependency issues in apps that also depend on the latest version of Firebase: https://github.com/googleads/googleads-mobile-flutter/issues/673
• Adds the field responseExtras to ResponseInfo. See ResponseInfo docs:
  • https://developers.google.com/admob/flutter/response-info
  • https://developers.google.com/ad-manager/mobile-ads-sdk/flutter/response-info
• Fixes a crash introduced in 2.1.0, issue #675

• Updates GMA dependencies to 21.2.0 (Android) and 9.10.0 (iOS):
• Adds loadedAdapterResponseInfo to ResponseInfo and the following fields to AdapterResponseInfo:
  • adSourceID
  • adSourceInstanceId
  • adSourceInstanceName
  • adSourceName
• Fixes close button issue on iOS

• Bug fix for issue 580. Adds a workaround on Android to wait for the ad widget to become visible before attaching the platform view.

• Updates GMA Android dependency to 21.0.0 and iOS to 9.6.0
• Removes credentials from AdapterResponseInfo, which is replaced with adUnitMapping.
• Removes serverSideVerificationOptions from RewardedAd.load() and RewardedInterstitialAd.load(), replacing them with setters RewardedAd.setServerSideVerificationOptions() and RewardedInterstitialAd.setServerSideVerificationOptions(). This lets you update the ssv after the ad is loaded.
• Removes static testAdUnitId parameters. See the Admob and AdManager documentation for up to date test ad units.
• Removes NativeAdListener.onNativeAdClicked. You should use onAdClicked instead, which present on all ad listeners.
• Removes AdRequest.location

• Adds support for programmatically opening the debug options menu usingMobileAds.openDebugMenu(String adUnitId)
• Adds support for Ad inspector APIs. See the AdMob and Ad Manager sites for integration guides.
• Adds support for User Messaging Platform. See the AdMob and Ad Manager sites for integration guides.

• Set new minimum height for FluidAdWidget. This is required after Flutter v2.11.0-0.1.pre because Android platform views that have no size don't load.
• Update GMA Android dependency to 20.6.0 and iOS to 8.13.0.
  • Android release notes
  • iOS release notes
• Deprecate AdapterResponseInfo.credentials in favor of adUnitMapping
• Deprecates LocationParams in AdRequest and AdManagerAdRequest.

• Adds support for Rewarded Interstitial (beta) ad format.
• Adds support for onAdClicked events to all ad formats. NativeAdListener.onNativeAdClicked is now deprecated.
  • FullScreenContentCallback and AdWithViewListeners now have an onAdClicked event.

• Fix for Issue 449. In LocationParams, time is now treated as an optional parameter on Android.
• Fix for Issue 447, which affected mediation networks that require an Activity to be initialized on Android.

• Mediation is now supported in beta.

  • There are new APIs to support passing network extras to mediation adapters:
    • MediationNetworkExtrasProvider on Android and FLTMediationNetworkExtrasProvider on iOS
  • See the mediation example app README for more details on how to use these APIs.

• Fix for Android 12 issue #330

  • This will break compilation on android if you do not already set compileSdkVersion to 31, or override the WorkManager dependency to < 2.7.0:

    dependencies {
        implementation('androidx.work:work-runtime') {
            version {
                strictly '2.6.0'
            }
        }
    }
    

• Fixes issue #404

  • Adds a new dart class, AppStateEventNotifier. You should subscribe to AppStateEventNotifier.appStateStream instead of using WidgetsBindingObserver to listen to app foreground/background events.
  • See the app open example app for a reference on how to use the new API.

• Adds a new parameter extras to AdRequest and AdManagerAdRequest.

  • This can be used to pass additional signals to the AdMob adapter, such as CCPA signals.
  • For example, to notify Google that RDP should be enabled when constructing an ad request:

      AdRequest request = AdRequest(extras: {'rdp': '1'});
    

• Partial fix for #265.
  • The partial fix allows you to load ads from a cached flutter engine in the add to app scenario, but it only works the first time the engine is attached to an activity.
  • Support for reusing the engine in another activity after the first one is destroyed is blocked by this Flutter issue which affects all platform views: https://github.com/flutter/flutter/issues/88880.
• Adds support for getRequestConfiguration API
  • Android API reference
  • iOS API reference
• Adds support for Fluid Ad Size (Ad Manager only)
  • Fluid ads dynamically adjust their height based on their width. To help display them we've added a new ad container, FluidAdManagerBannerAd, and a new widget FluidAdWidget.
  • You can see the fluid_example.dart for a reference of how to load and display a fluid ad.
  • Android API reference
  • iOS API reference
• Adds AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize() to support getting an AnchoredAdaptiveBannerAdSize in the current orientation.
  • Previously the user had to specify an orientation (portrait / landscape) to create an AnchoredAdaptiveBannerAdSize. It has been made optional with this version. SDK will determine the current orientation of the device and return an appropriate AdSize.
  • More information on anchored adaptive banners can be found here:
    • Admob android
    • Admob iOS
    • Ad manager android
    • Ad manager iOS
• Adds support for inline adaptive banner ads.
  • Inline adaptive banner ads are meant to be used in scrollable content. They are of variable height and can be as tall as the device screen. They differ from Fluid ads in that they only resize once when the ad is loaded. You can see the inline_adaptive_example.dart for a reference of how to load and display inline adaptive banners.
  • More information on inline adaptive banners can be found here:
    • Admob android
    • Admob iOS
    • Ad manager android
    • Ad manager iOS
• Fix for #369
  • Fixes setting the app volume in android (doesn't affect iOS).
• Adds support for setting location in AdRequest and AdManagerAdRequest.
  • Both AdRequest and AdManagerAdRequest have a new param, location.
  • Location data is not used to target Google Ads, but may be used by 3rd party ad networks.
  • See other packages for getting the location. For example, https://pub.dev/packages/location.
• Adds publisherProvidedId to AdManagerAdRequest to support publisher provided ids.

• Adds support for app open.
  • Implementation guidance can be found here.
  • As a reference please also see the example app.
  • Best practices can be found here.

• Adds support for muting and setting the volume level of the app.
• Visit the following links for more information:
  • https://developers.google.com/admob/android/global-settings#video_ad_volume_control
  • https://developers.google.com/android/reference/com/google/android/gms/ads/MobileAds#public-static-void-setappvolume-float-volume
• Adds support for setting immersive mode for Rewarded and Interstitial Ads in Android.
• Visit the following links for more information:
  • https://developers.google.com/android/reference/com/google/android/gms/ads/interstitial/InterstitialAd?hl=en#setImmersiveMode(boolean)
  • https://developers.google.com/android/reference/com/google/android/gms/ads/rewarded/RewardedAd#setImmersiveMode(boolean)
• Adds support for disableSDKCrashReporting in iOS; disableMediationInitialization and getVersionString in both the platforms.
  • https://developers.google.com/admob/ios/api/reference/Classes/GADMobileAds#-disablesdkcrashreporting
  • iOS (disableMediationInitialization): https://developers.google.com/admob/ios/api/reference/Classes/GADMobileAds#-disablemediationinitialization
  • Android (disableMediationAdapterInitialization): https://developers.google.com/android/reference/com/google/android/gms/ads/MobileAds#public-static-void-disablemediationadapterinitialization-context-context
  • https://developers.google.com/android/reference/com/google/android/gms/ads/MobileAds#getVersionString()

• Adds support for NativeAdOptions. More documentation also available for Android and iOS

• Fixes a crash where PlatformView.getView() returns null
• Fixes memory leaks on Android.
• Fixes a crash on iOS.
• Marks smart banner sizes as deprecated. Instead you should use adaptive banners.

• Fixes Issue #130

• Adds support for the paid event callback.

• Updates GMA Android and iOS dependencies to 20.1.0 and 8.5.0, respectively.
• Renames APIs that use the Publisher prefix to AdManager.
• Rewarded and Interstitial ads now provide static load methods and a new FullScreenContentCallback for full screen events.
• Native ads use GADNativeAdView for iOS and NativeAdView on Android.
• Adds support for ResponseInfo.
• Adds support for same app key on iOS.
• Removes testDevices from AdRequest. Use MobileAds.updateRequestConfiguration to set test device ids.
• Removes Ad.isLoaded(). Instead you should use the onAdLoaded callback to track whether an ad is loaded.
• Removes need to call Ad.dispose() for Rewarded and Interstitial ads when they fail to load.

• Add support for anchored adaptive banners.

• Fix anchored adaptive banner message corruption error.
• Update example app with better practices and adaptive banner.

• Rewarded ads now take an optional ServerSideVerification, to support custom data in rewarded ads.

• Fixes a crash with Swift based native ads

• Migrated to null safety. Minimum Dart SDK version is bumped to 2.12.0.

Open beta release of the Google Mobile Ads Flutter plugin. Please see the README for updated integration steps.

• Package and file names have been renamed from firebase_admob to google_mobile_ads.

• Removes support for legacy plugin APIs.

• Removes Firebase dependencies.

• Adds support for RequestConfiguration targeting APIs.

• Adds support for Ad Manager key values, via the new Publisher ad containers. See PublisherBannerAd and similar classes.

• Shows warning if an Ad object is reused without being disposed.

• Removes support for V1 embedding.

• Add version to request agent.

• Improve AdRequest documentation and fix README heading.

• Set min Android version to 19.
• Fixes bug that displayed "This AdWidget is already in the Widget tree".
• Update minimum gradle version.
• Add references to the codelab in the README.

• Fixes an Android crash when reusing Native and Banner Ad objects.
• Fixes iOS memory leaks.
• Adds a section on Ad Manager to the README.
• Updates iOS setup in the README to include SKAdNetwork.

• Fixes a bug where state is not properly cleaned up on hot restart.
• Update README and example app to appropriately dispose ads.

• Initial Release: not ready for production use