版本说明

版本 发布日期 备注
1.6.0 2026-10-22
  • 更新了导出广告请求和响应时的广告检查器共享表,以提供文本预览、复制按钮和直接共享建议。
  • 修复了激励广告和插页式激励广告中的一个 bug,该 bug 导致 OnUserEarnedRewardListener.onUserEarnedReward() 方法可能会在 AdEventCallback.onAdDismissedFullScreenContent() 方法之后调用。
  • 将 com.google.android.play:hsdp 依赖项更新为 2.2.0 版,以修复 java.lang.IllegalStateException 崩溃问题。
  • 更新了使用方 ProGuard 规则,以防止在启用 R8 完整模式时 androidx.work.WorkManagerInitializer 类中发生 java.lang.RuntimeException 崩溃。
  • 修复了以下 bug:在展示中介全屏广告时,可用的 Activity 上下文未传递给第三方 SDK。
1.5.0 2026-09-24
  • 添加了适用于 SwipeableInterstitialAd 格式的信号生成和渲染 API。此功能目前处于非公开 Beta 版阶段。请联系您的客户经理,请求访问权限。
  • 向图标广告请求添加了 excludedAppIds API,以便发布商可以选择从图标广告响应中排除应用 ID 列表。
1.4.0 2026-08-20
1.3.1 2026-07-29
  • 针对一项访问权限受限的功能,修复了多个问题并提升了性能。
1.3.0 2026-07-21
  • 更改了 AdView.loadAd(),以便在广告单元停用自动刷新功能时,暂停对失败的广告请求进行自动重试。
  • 现在,当针对多个原生广告或图标广告的广告请求未产生任何可用广告时,SDK 会返回 NO_FILL 错误,而不是 INTERNAL_ERROR。
  • 添加了清单标志,用于停用广告检查器。
  • 添加了 Ad.getAdUnitId() 方法,用于标识请求广告时所用的广告单元 ID。
  • 添加了 InitializationConfig.Builder.disableSdkCrashReporting() 方法,该方法可为 GMA Next-Gen SDK 中的默认崩溃处理程序提供手动选择退出选项。默认情况下,SDK 仍会将崩溃信息委托给其他已注册的处理程序(例如 Crashlytics)。
  • 将中介与自定义事件广告来源搭配使用时,ResponseInfo.getAdapterClassName() 现在会返回自定义事件类名称,而不是 com.google.ads.mediation.customevent.CustomEventAdapter。
1.2.1 2026-06-15
  • 对于使用适用于广告的 WebView API 的应用,修复了导致 SDK 无法向受支持的广告代码(AdSense 代码、Google 发布商代码、IMA for HTML5)提供信号的问题。此问题是由在后台线程上错误调用 Webkit 方法引起的。
1.2.0 2026-06-11
1.1.1 2026-05-27
  • 修复了激励广告连播在过渡期间可能卡住,导致用户无法关闭广告的问题。
1.1.0 2026-05-18
1.0.1 2026-04-30
  • 修复了使用 window.open() 的广告或带有 target="_blank" 的链接无法打开着陆页的问题。
1.0.0 2026-04-14
0.25.0-beta01 2026-03-24
0.24.0-beta03 2026-03-07
  • 修复了以下问题:在广告加载失败后,AdView.destroy() 无法停止广告加载重试。
  • 向 NativeAdMapper 和 UnifiedNativeAdMapper 添加了零参数构造函数,以提高与 Kotlin 的兼容性。
  • 向 IconAd 接口添加了 packageName 属性。
  • 添加了一个选项,用于强制 SDK 使用 Cronet(而非 OkHttp)执行网络操作。如需解决使用 OkHttp 5 的项目中的运行时错误,我们建议强制使用 Cronet 执行网络操作。如需强制使用 Cronet,请在调用 MobileAds.initialize() 时,将 InitializationConfig.Builder 中的 force_use_cronet extra 设置为 true:
    val config = InitializationConfig.Builder()
      .setExtras(bundleOf("force_use_cronet" to true))
      .build()
    MobileAds.initialize(this, config)
  • 添加了对 Java 11 的支持。如需使用 Java 11,请将以下代码添加到 build.gradle 文件的 android 代码块中:
    android {
      compileOptions {
        sourceCompatibility JavaVersion.VERSION_11
        targetCompatibility JavaVersion.VERSION_11
      }
      kotlinOptions {
        jvmTarget = '11'
      }
    }
0.24.0-beta02 2026-03-03
  • 解决了影响服务器到服务器广告请求信号生成的第三方依赖项类加载问题。
0.24.0-beta01 2026-02-13
0.23.0-beta01 2026-01-26
  • 将所需的最低 Android Gradle 插件 (AGP) 版本更新为 8.3.0。
  • 修复了从 Kotlin 调用 AdView 构造函数时会抛出 java.lang.NoSuchMethodError 的 bug。
  • 修复了在广告瀑布流执行期间未调用自定义事件适配器的 bug。
  • 更新了 RtbSignalData,以便在可用时向 RtbAdapter.collectSignals() 提供 activity 上下文。
  • 将 androidx.webkit 依赖项更新到了 1.15.0 版。
  • 将 User Messaging Platform SDK 依赖项更新到了 4.0.0 版。
  • 还原了已废弃的 AdPreloader.getConfiguration() 和 AdPreloader.getConfigurations()。
0.22.0-beta04 2025-12-04
  • 修复了 SDK 版本 0.22.0-beta02 中的一个问题,该问题会导致 Java 17 预览版元数据错误地包含在类文件中。
0.22.0-beta03 2025-11-25
0.22.0-beta02 2025-11-24
0.22.0-beta01 2025-11-20
  • 更新横幅广告 API:
  • 修复了中介广告中的一个 bug,该 bug 会导致系统不遵循 NativeAdRequest.Builder.setAdChoicesPlacement(),从而导致“广告选项”图标放置位置不正确。
  • 将所需的最低 Android Gradle 插件 (AGP) 版本从 8.2.0 降至 7.3.1。
  • 废弃了 AdPreloader.getConfigurations() 和 AdPreloader.getConfiguration(preloadId)。没有替代项。
0.21.0-beta01 2025-10-08
  • 添加了 InitializationConfig.Builder.disableMediationAdapterInitialization() 方法。在初始化 GMA Next-Gen SDK 之前调用此方法,以停用中介适配器初始化。
  • 改进了 WebView 初始化用法,以减少 ANR。
  • 将 androidx.webkit 依赖项从 1.13.0 降级到了 1.12.1。
  • 移除了 androidx.work 软件包使用的 android.permission.RECEIVE_BOOT_COMPLETED 权限。
  • 修复了 NativeAdMapper 类中命名的字段。
0.20.0-beta01 2025-09-19
  • 修复了部分原生视频广告无法自动播放的 bug。
0.19.0-beta01 2025-08-14
  • 降级了两个依赖项的版本。
    • androidx.work:work-runtime 从 2.10.0 降级到 2.7.0。
    • androidx.core:core and androidx.core:core-ktx从 1.15.0 降级到 1.12.0。
  • 将 ResponseInfo 上的 loadedAdSourceResponse 属性重命名为 loadedAdSourceResponseInfo。
  • 修复了以下问题:用户可以使用返回按钮提前关闭某些全屏广告。
  • 有权使用该功能的发布商现在可以为所有广告格式设置展示位置 ID。
  • 为原生广告中介适配器向 NativeAdMapper 添加了 destroy() 回调。
0.18.0-beta01 2025-07-17
  • 修复了原生中介 bug,该 bug 会导致引用 com.google.android.gms.ads.NativeAd.MediaView 的适配器无法投放广告。
  • 使用 @JvmStatic 对 MobileAds.registerCustomTabsSession() 进行了注解。
  • 修复了以下 bug:使用 AdMob 广告联盟瀑布流加载的横幅广告会停止刷新。
0.17.0-alpha02 2025-06-23
  • 修复了原生中介出价 bug,该 bug 会导致实现出价但未实现广告瀑布流的适配器(例如 Meta Audience Network)始终无法呈现原生广告。
  • 修复了中介适配器针对单个广告请求调用多个 MediationAdLoadCallback 方法时发生的崩溃问题。
0.17.0-alpha01 2025-06-18
  • 版本 0.17.0-alpha01 是一个意外版本,不包含预期的新功能。请改用 0.17.0-alpha02。
0.16.0-alpha01 2025-05-23
  • 不再需要启用 Java 8+ API 脱糖支持。
  • 将 User Messaging Platform SDK 依赖项更新到了 3.2.0 版。
  • 修复了原生广告中介 bug,该 bug 会导致引用 com.google.android.gms.ads.formats.MediaView 类的适配器发生崩溃。
  • 广告预加载:添加了 getNumAdsAvailable(),并弃用了 numAdsAvailable()。
  • 从 SDK 的清单文件中移除了 android.adservices.AD_SERVICES_CONFIG 属性标记,以防止 配置 API 专属广告服务的应用发生合并冲突。
0.15.1-alpha01 2025-04-28
  • 现在必须启用 Java 8+ API 脱糖支持。
  • 对于使用 Kotlin 开发的应用,将最低要求的 Kotlin 版本从 2.1 降至 1.9。
0.15.0-alpha01 2025-04-24
  • 原生广告:添加了对加载多个原生广告的支持。
    • 添加了 NativeAdLoader.load(NativeAdRequest, numberOfAds, NativeAdLoaderCallback) 方法,用于一次请求多个广告。
    • 添加了 NativeAdLoaderCallback.onAdLoadingCompleted() 回调,该回调会在所有原生广告加载完毕时触发。
    • 为了支持 Kotlin 异步加载,添加了返回 Flow<NativeAdLoadResult> 的 NativeAdLoader.load(NativeAdRequest, numberOfAds) 方法。
  • 将 kotlinx-coroutines-android 依赖项从 1.7.3 版更新到了 1.9.0 版。
0.14.0-alpha01 2025-03-20
  • 如果您使用无效的应用 ID 初始化 SDK,广告请求将会失败。
  • AdPreloader.start() 方法不再需要 PreloadCallback 回调。
  • 通过 PreloadConfiguration 数据类创建对象时,bufferSize 属性是可选的。如需让 Google 优化缓冲区空间,请勿设置 bufferSize 属性。
  • 移除了 PreloadConfiguration 数据类中的 maxAdsPerSession 属性。
  • 向 NativeAdOptions 类添加了 shouldRequestMultipleImages 和 shouldReturnUrlsForImageAssets 属性。
0.13.0-alpha01 2025-02-26
  • 添加了 MediationRewardedAdCallback.onUserEarnedReward() 并废弃了 MediationRewardedAdCallback.onUserEarnedReward(RewardItem)。
  • 添加了广告预加载 API。
0.12.0-alpha01 2025-01-22
  • 修复了 AdRequest、AdRequest.Builder、SignalRequest 和 SignalRequest.Builder 中的某些方法被混淆的 bug。
  • 对于没有 Ad Manager 应用 ID 的适用于广告的 WebView API 用户,添加了可在 SDK 初始化期间传递的 InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID。
  • 添加了对在 Ad Manager 广告请求中结合使用原生广告和横幅广告的支持。
0.11.0-alpha01 2024-12-12
  • 将对 User Messaging Platform SDK 的依赖项更新到了 3.1.0 版。
  • 添加了对原生广告中自定义点击手势的支持。
  • 新增了对 Ad Manager 预订型横幅广告的手动展示次数统计功能的支持。
0.10.0-alpha01 2024-11-08
  • 为 VideoOptions 和 RequestConfiguration 添加了 DSL 函数,以更好地支持 Kotlin。
  • 添加了对 RequestConfiguration.setPublisherPrivacyPersonalizationState() 的 Publisher Privacy Treatment API 的支持。
  • 添加了用于加载广告和生成信号的 Kotlin 挂起 API。
  • 移除了 IconAd.LoadAdResult,取而代之的是 AdLoadResult。
  • 修复了 OMID 会话无法针对原生视频广告启动的问题。
0.9.0-alpha01 2024-10-02
0.8.0-alpha01 2024-08-22
  • 将对 User Messaging Platform SDK 的依赖项更新到了 3.0.0 版。
  • 原生广告:
    • 原生广告格式的正式发布版本。
    • 添加了对在 MediaContent 资源中投放视频的支持。
    • 添加了视频生命周期回调。
    • 添加了视频播放自定义控件。
    • 为原生广告和自定义原生广告启用了开放式衡量。
  • 现在,构建 SignalRequest 时,signalType 是必填字段。
0.6.0-alpha01 2024-06-20
  • 添加了使用 通过脱糖获得的 Java 8+ API 的代码。使用低于 26 的 minSdkVersion 的应用必须启用 Java 8+ API 脱糖支持。
  • 添加了对不包含视频素材资源的原生广告格式和自定义原生广告格式的支持。
  • 添加了对 MRAID v3 的支持。
  • 添加了对 User Messaging Platform SDK 2.2.0 版的依赖项。
  • 将 Google 错误的错误网域从 com.google.android.gms.ads 更新为 com.google.android.libraries.ads.mobile.sdk。
  • 添加了 MobileAds.isInitialized() 方法,用于检查 SDK 是否已初始化。
  • 添加了 BannerAd.isCollapsible(),用于检查返回的横幅广告是否为折叠式广告。
  • 添加了 MobileAds.registerCustomTabsSession(),以提高自定义标签页中广告的变现能力。
  • OnInitializationCompleteListener 已重命名为 OnAdapterInitializationCompleteListener。
  • AdapterResponseInfo 已重命名为 AdSourceResponseInfo。
  • AdRequest.Builder.putAdNetworkExtrasBundle() 已重命名为 AdRequest.Builder.putAdSourceExtrasBundle()。
  • 修复了出价适配器类未正确实例化的问题。
0.3.0-alpha01 2024-03-20
  • GMA Next-Gen SDK 的初始版本。
  • 支持横幅广告、插页式广告、激励广告、插页式激励广告和开屏广告。
  • 支持所有广告格式的中介。为当前移动广告 SDK 编写的适配器与 GMA Next-Gen SDK 向前兼容。
  • 添加了对开放式衡量 SDK 1.4.10 版的依赖。