Release Notes

  • Recent updates include a method to disable mediation adapter initialization, improvements to WebView initialization, and dependency version adjustments.

  • Several bug fixes have been addressed across different versions, including issues with native video autoplay, full-screen ad dismissal, native mediation, and banner ad refreshing.

  • Features added include support for multiple native ad loading, ad preloading APIs, custom click gestures, manual banner impression counting, and Publisher Privacy Treatment API.

  • Support for Java 8+ API desugaring has changed across versions, and the minimum required Kotlin version has been reduced.

  • Significant API changes and new features like support for native and custom native ad formats, MRAID v3, and Ad Manager specific functionalities have been introduced in various releases.

Version Release Date Notes
0.21.0-beta01 2025-10-08
  • Added the InitializationConfig.Builder.disableMediationAdapterInitialization() method. Call this method prior to initializing Google Mobile Ads SDK (beta) to disable mediation adapter initialization.
  • Improved WebView initialization usage to reduce ANRs.
  • Downgraded androidx.webkit dependency from 1.13.0 to 1.12.1 to maintain compatibility with Android Gradle plugin 7.3.1.
  • Removed the android.permission.RECEIVE_BOOT_COMPLETED permission used by the androidx.work package.
  • Fixed a misnamed field in the NativeAdMapper class.
0.20.0-beta01 2025-09-19
  • Fixed a bug where some native video ads don't autoplay.
0.19.0-beta01 2025-08-14
  • Downgraded versions of two dependencies.
    • androidx.work:work-runtime from 2.10.0 to 2.7.0.
    • androidx.core:core and androidx.core:core-ktx from 1.15.0 to 1.12.0.
  • Renamed the loadedAdSourceResponse property on ResponseInfo to loadedAdSourceResponseInfo.
  • Fixed a bug that allowed users to prematurely dismiss some full-screen ads with the back button.
  • Publishers with access to the feature now have placement ID support for all ad formats.
  • Added a destroy() callback to NativeAdMapper for native mediation adapters.
0.18.0-beta01 2025-07-17
  • Fixed a native mediation bug that broke ad serving for adapters that referenced com.google.android.gms.ads.NativeAd.MediaView.
  • Annotated MobileAds.registerCustomTabsSession() with @JvmStatic.
  • Fixed a bug where Banner ads loaded using AdMob Network Waterfall would stop refreshing.
0.17.0-alpha02 2025-06-23
  • Fixed a native mediation bidding bug where adapters that implement bidding but not waterfall (e.g. Meta Audience Network) would always fail to render native ads.
  • Fixed a crash that occurring when a mediation adapter invokes multiple MediationAdLoadCallback methods for a single ad request.
0.17.0-alpha01 2025-06-18
  • Version 0.17.0-alpha01 was an accidental release that does not contain the intended new features. Use 0.17.0-alpha02 instead.
0.16.0-alpha01 2025-05-23
  • It is no longer required to enable Java 8+ API desugaring support.
  • Updated User Messaging Platform SDK dependency to version 3.2.0.
  • Fixed a native ads mediation bug that caused crashes in adapters referencing the com.google.android.gms.ads.formats.MediaView class.
  • Ad Preloading: Added getNumAdsAvailable() and deprecated numAdsAvailable().
  • Removed the android.adservices.AD_SERVICES_CONFIG property tag from the SDK's manifest file to prevent merge conflicts for apps that Configure API-specific Ad Services.
0.15.1-alpha01 2025-04-28
0.15.0-alpha01 2025-04-24
  • Native ads: Added support for loading multiple native ads.
    • Added a NativeAdLoader.load(NativeAdRequest, numberOfAds, NativeAdLoaderCallback) method that requests multiple ads at once.
    • Added a NativeAdLoaderCallback.onAdLoadingCompleted() callback that fires when all native ads complete loading.
    • To support Kotlin asynchronous loading, added a NativeAdLoader.load(NativeAdRequest, numberOfAds) method that returns a Flow<NativeAdLoadResult>.
  • Updated kotlinx-coroutines-android dependency from version 1.7.3 to 1.9.0.
0.14.0-alpha01 2025-03-20
  • Ad requests fail if you initialize the SDK with an invalid application ID.
  • The AdPreloader.start() method no longer requires a PreloadCallback callback.
  • The bufferSize property is optional when creating an object through PreloadConfiguration data class. To enable Google to optimize the buffer size, don't set the bufferSize property.
  • Removed the maxAdsPerSession property in PreloadConfiguration data class.
  • Added shouldRequestMultipleImages and shouldReturnUrlsForImageAssets properties to NativeAdOptions class.
0.13.0-alpha01 2025-02-26
  • Added MediationRewardedAdCallback.onUserEarnedReward() and deprecated MediationRewardedAdCallback.onUserEarnedReward(RewardItem).
  • Added ad preloading APIs.
0.12.0-alpha01 2025-01-22
  • Fixed a bug where some methods inside AdRequest, AdRequest.Builder, SignalRequest, and SignalRequest.Builder were obfuscated.
  • For WebView API for Ads users that don't have an Ad Manager application ID, added InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID that can be passed during SDK initialization.
  • Added support for combining native and banner ads in Ad Manager ad requests.
0.11.0-alpha01 2024-12-12
  • Updated the dependency on User Messaging Platform SDK to version 3.1.0.
  • Added support for custom click gestures in native ads.
  • Added support for manual impression counting of banner ads in Ad Manager reservations.
0.10.0-alpha01 2024-11-08
  • Added DSL functions for VideoOptions and RequestConfiguration for better Kotlin support.
  • Added support for the Publisher Privacy Treatment API with RequestConfiguration.setPublisherPrivacyPersonalizationState().
  • Added Kotlin suspend APIs for loading ads and generating signals.
  • Removed IconAd.LoadAdResult and replaced it with AdLoadResult.
  • Fixed an issue where OMID sessions did not start for native video ads.
0.9.0-alpha01 2024-10-02
0.8.0-alpha01 2024-08-22
  • Updated the dependency on User Messaging Platform SDK to version 3.0.0.
  • Native Ads:
    • Official release version for the native ad format.
    • Added support for serving video in the MediaContent asset.
    • Added video lifecycle callbacks.
    • Added video playback custom controls.
    • Enabled Open Measurement for native and custom native ads.
  • signalType is now a required field when building a SignalRequest.
0.6.0-alpha01 2024-06-20
  • Added code that uses Java 8+ APIs available through desugaring. Apps that use minSdkVersion lower than 26 must enable Java 8+ API desugaring support.
  • Added support for native and custom native ad formats that don't include video assets.
  • Added support for MRAID v3.
  • Added dependency on User Messaging Platform SDK version 2.2.0.
  • Updated error domain for Google errors from com.google.android.gms.ads to com.google.android.libraries.ads.mobile.sdk.
  • Added MobileAds.isInitialized() method to check if the SDK has already been initialized.
  • Added BannerAd.isCollapsible() to check if the returned banner ad is collapsible.
  • Added MobileAds.registerCustomTabsSession() to improve monetization for ads in Custom Tabs.
  • Renamed OnInitializationCompleteListener to OnAdapterInitializationCompleteListener.
  • Renamed AdapterResponseInfo to AdSourceResponseInfo.
  • Renamed AdRequest.Builder.putAdNetworkExtrasBundle() to AdRequest.Builder.putAdSourceExtrasBundle().
  • Fixed a bug where bidding adapter classes weren't instantiated correctly.
0.3.0-alpha01 2024-03-20
  • Initial release of the Google Mobile Ads SDK (beta).
  • Supports banner, interstitial, rewarded, rewarded interstitial, and app open ads.
  • Supports mediation for all ad formats. Adapters written for the current Mobile Ads SDK are forward-compatible with the Google Mobile Ads SDK (beta).
  • Added dependency on Open Measurement SDK version 1.4.10.