অব্যাহতি পত্র

版本发布日期笔记
20.6.0 2022-02-22
20.5.0 2021-11-18
  • 为面向 API 31 的应用添加了对 Android 12 设备的支持。
  • 为报告和欺诈预防等用例添加了对应用集 ID的支持。
20.4.0 2021-09-22
  • 从版本 20.4.0 开始,Google 移动广告 SDK 在 SDK 的清单中包含com.google.android.gms.permission.AD_ID权限,该权限由 Android 构建工具自动合并到应用清单中。要详细了解AD_ID权限声明,包括如何禁用它,请参阅这篇 Play 管理中心帮助文章
  • onAdClicked()回调添加到FullScreenContentCallback
  • 为原生广告格式启用AdListener类中的onAdClicked()回调。
20.3.0 2021-08-23
20.2.0 2021-06-08
  • 为 Google Ad Manager 发布商添加了广告检查器(测试版)支持。
20.1.0 2021-04-29
20.0.0 2021-04-05
  • 重大变化:
    • 删除了旧版Interstitial API。
    • 删除了旧的RewardedVideoAd API。
    • 删除了前缀为Publisher的类(例如: PublisherAdView )。
    • 删除CustomRenderedAd
    • 删除InstreamAd
    • 删除SearchAdRequest
    • 删除AdListener.onAdLeftApplication()
    • 删除了NativeAppInstallAdNativeContentAdUnifiedNativeAd 。现在有一种名为NativeAd的原生广告格式。
    • RewardedAd现在是一个抽象类。使用RewardedAd.load()静态方法加载奖励广告。
  • 添加了广告检查器(测试版)。
  • 弃用AdSize.SMART_BANNER以支持自适应横幅广告
  • 在所有公共 API 上添加了显式可空性注释。
19.8.0 2021-03-15
  • 添加了对 用户消息传递平台 SDK的依赖项。
  • FullScreenContentCallback添加了onAdImpression()回调。
  • 已弃用InstreamAd格式。
  • 中介适配器:
    • 已弃用MediationBannerAdapterMediationInterstitialAdapterMediationNativeAdapter 。新的适配器应该实现Adapter类来加载这些格式。
    • 出价适配器现在可以在Adapter类中为特定于 RTB 的格式实现不同的加载方法。
19.7.0 2021-01-20
  • 主要变化:
    • InterstitialAd
    • RewardedAd
    • NativeAd
    • AppOpenAd
  • 已弃用CustomRenderedAd
  • 带有前缀Publisher的类和包已被弃用,取而代之的是前缀AdManager
  • 版本 20.0.0 之前的最后一个次要版本。在此版本和之前版本中标记为已弃用的所有 API 将在版本 20.0.0 中删除。有关更多详细信息,请参阅版本 20.0.0 迁移指南
19.6.0 2020-12-04
  • 弃用了onAdLeftApplication() AdListener方法。
  • 修复了 Android 11 设备上的用户在点击广告时被要求选择浏览器的错误。
19.5.0 2020-10-20
  • 横幅广告:现在为横幅广告调用onAdImpression() AdListener方法。
  • 添加了setCustomHttpMillis()方法来自定义 Google 移动广告 SDK 发出的 HTTPS 调用的超时时间。
19.4.0 2020-09-10
  • 为面向 API 30 的应用添加了对 Android 11 设备的支持。
  • App Open Ads:更改了AppOpenAd格式,使其更像全屏格式而不是横幅视图。向AppOpenAd添加了getResponseInfo()show()方法。已弃用AppOpenAdViewAppOpenAdPresentationCallback类。
  • 中介:中介状态报告现在可用。使用ResponseInfo.getAdapterResponses()获取参与广告请求的每个广告网络的响应信息。
  • 旧版奖励广告:已弃用RewardedVideoAd
  • 修复了MobileAds.initialize()仅回调完成处理程序一次的错误。现在,对MobileAds.initialize()的每次调用都会调用完成回调。
19.3.0 2020-07-20
  • AdError添加了getDomain()getCause()方法。
  • 为所有返回LoadAdError的广告格式添加了新的加载失败回调。例如, onAdFailedToLoad(LoadAdError)
  • 不推荐使用返回 int 的加载失败回调。例如, onAdFailedToLoad(int)
  • 奖励广告:添加onRewardedAdFailedToShow(AdError)并弃用onRewardedAdFailedToShow(int)
  • 奖励中介:添加了MEDIATION_SHOW_ERROR演示错误代码。现在,与中介广告相关的所有演示错误都会为AdError.getCode()和 NonNull AdError.getCause()返回MEDIATION_SHOW_ERROR ,表示潜在的中介错误。
19.2.0 2020-06-18
  • 添加了RewardedInterstitialAd格式。此功能目前处于私人测试阶段。联系您的客户经理以请求访问权限。
  • 原生广告:在测试请求中添加了原生验证器 UI,以帮助您捕捉和修复原生政策违规行为。
  • 添加了MobileAds.disableMediationAdapterInitialization()方法。在初始化 Google Mobile Ads SDK 之前调用此方法以禁用中介适配器初始化。
19.1.0 2020-04-16
19.0.1 2020-03-18
  • 原生广告:修复了使用NativeCustomTemplateAd时发生的内存泄漏。
19.0.0 2020-03-02
  • setNeighboringContentUrls()getNeighboringContentUrls()添加到AdRequest
  • 添加了ResponseInfo类,该类提供有关已加载广告的信息。
  • 对于所有广告格式,已弃用getMediationAdapterClassName()以支持getResponseInfo()
  • 原生广告:MediaContent添加getDuration()getCurrentTime()方法。
  • 原生中介:为 UnifiedNativeAdMapper 添加了UnifiedNativeAdMapper getDuration()getCurrentTime()方法,供适配器实现。
  • 已弃用AdRequest.Builder.addTestDevice() 。请改用RequestConfiguration.Builder.setTestDeviceIds()
18.3.0 2019-11-05
  • InstreamAd广告格式添加了 API。此功能目前处于私人测试阶段。联系您的客户经理以请求访问权限。
  • 自适应横幅:更改了AdSize类中的自适应横幅创建方法。例如,将AdSize.getCurrentOrientationBannerAdSizeWithWidth()重命名为AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize()
  • 中介:Google 移动广告 SDK 现在可以捕获中介适配器引发的异常。
  • 奖励中介:修复了如果缓存了多个中介奖励广告,则只有一个会显示的错误。
  • 添加了setTestDeviceIds()方法,可以为所有广告请求设置一次测试设备。
18.2.0 2019-08-29
  • AppOpenAd格式添加了 API。此功能目前处于私人测试阶段。联系您的客户经理以请求访问权限。
18.1.1 2019-07-23
18.1.0 2019-07-09
18.0.0 2019-06-17
  • 从 Android 支持库迁移到 Jetpack (AndroidX) 库。有关详细信息,请参阅Google Play 服务发行说明
  • 为避免从 Play 商店安装应用程序后首次启动时发生崩溃,此版本要求发布者在其 build.gradle 中声明其他依赖项:
    com.google.android.gms:play-services-measurement:17.0.0
    com.google.android.gms:play-services-measurement-sdk:17.0.0
17.2.1 2019-05-21
  • 修复了源自android.media.AudioManager.getStreamVolume的 ANR。
17.2.0 2019-03-11
  • 激励视频:添加了一组新的激励 API(参见激励包),使您能够同时加载多个激励广告。
  • 中介:添加了一组支持初始化的新中介适配器 API。实现新 API 的适配器实现了Adapter类。
  • 使用 firebase firebase-analytics以及任何广告库(例如com.google.android.gms:play-services-ads:17.2.0 )版本17.2.0的发布商必须使用com.google.firebase:firebase-analytics:16.3.0 .
17.1.3 2019-01-31
  • 使用firebase-analytics以及任何广告库(例如com.google.android.gms:play-services-ads:17.1.3 )版本17.1.3的发布商必须使用com.google.firebase:firebase-analytics:16.3.0 .
17.1.2 2018-12-03
  • 使用firebase-analytics以及任何广告库的17.1.2版(例如com.google.android.gms:play-services-ads:17.1.2 )的发布商必须使用com.google.firebase:firebase-analytics:16.0.6
17.1.1 2018-11-12
  • 修复了play-services-adsfirebase-analytics的某些组合(例如ads:17.1.0analytics:16.0.5 )导致duplicate entry编译器错误的错误。使用firebase-analytics以及任何广告库(例如com.google.android.gms:play-services-ads:17.1.1 )版本17.1.1的发布商必须使用com.google.firebase:firebase-analytics:16.0.5
17.1.0 2018-11-02
17.0.0 2018-10-05
  • 谷歌 AdMob 发布商需要指定一个<meta-data>标记,其中包含密钥com.google.android.gms.ads.APPLICATION_ID他们的 AndroidManifest.xml。有关详细信息,请参阅入门指南
  • 原生广告: NativeAppInstallAdNativeContentAd和相关 API 已弃用,取而代之的是UnifiedNativeAd 。有关使用新 API 的更多说明,请参阅Native Ads Advanced Unified
  • 原生广告:添加了“静音此广告”功能。
  • 原生广告:良性警告日志:“UnconfirmedClickListener 在设置 ClickConfirmingView 时不得为空。”已被删除。
  • 奖励广告:RewardedVideoAd上添加了setAdMetadataListener方法来监听广告元数据的变化。
  • 奖励广告:调用destroy()将使侦听器无效。
  • AdRequest.Builder上弃用了以下方法。
  • 修复了onRewardedVideoCompleted()没有在模拟器上触发的错误。
16.0.0 2018-10-02
  • 没有广告变化。有关详细信息,请参阅 Google Play 服务发行说明
15.0.0 2018-04-12
  • MRAID v3 测试版。
  • 原生广告:添加了统一原生广告 API。这将NativeAppInstallAdsNativeContentAds组合成一种新类型: UnifiedNativeAd
  • 注意:使用原生广告时,点击原生广告时,日志中会出现良性警告:“ UnconfirmedClickListener must not be null while ClickConfirmingView is set. ”这个警告可以忽略,会在下一个版本。
12.0.1 2018-03-28
  • 没有广告变化。有关详细信息,请参阅 Google Play 服务发行说明
12.0.0 2018-03-20
  • 奖励视频:在RewardedVideoAdListener中添加了onRewardedVideoCompleted()回调方法。
  • 原生中介:向NativeAdMapper添加了trackViews()方法,使适配器能够访问与单个原生广告资产对应的View对象。弃用trackView()以支持trackViews()
11.8.0 2017-12-18
  • 错误修复和一般改进。
11.6.0 2017-11-07
  • NativeAppInstallAdNativeContentAd中添加了NativeAdViewHolder类和相关方法。
  • 已弃用AdLoader.getMediationAdapterClassName (发布者应改为使用NativeAppInstallAdNativeContentAd中的同名方法)。
  • 测试广告现在会在广告顶部显示一个标签。有关详细信息,请参阅测试指南
11.4.0 2017-09-19
  • NativeAppInstallAdNativeContentAd类添加了getMediationAdapterClassName()方法。 AdLoader中的同名方法将被弃用。
  • MediationNativeListener类中添加了onVideoEnd()方法,在 NativeAdMapper 类中添加了 hasVideoContent( hasVideoContent()setHasVideoContent()setMediaView()方法,在NativeMediationAdRequest类中添加了NativeAdMapper getAdVolume()isAdMuted()方法,以支持原生视频中介。
  • 删除了SearchAdRequest类。
11.2.2 2017-09-05
  • 添加了一个新的loadAd()方法,该方法将PublisherAdRequest对象接收到RewardedVideoAd类。
11.2.0 2017-08-14
  • AdLoader类添加了loadAds()方法,该方法允许应用在单个请求中加载多个唯一广告。
  • 当您将应用升级到 11.2.0 或更高版本的 Google 移动广告 SDK 时,还必须更新应用的build.gradle以指定compileSdkVersion至少为26 (Android O)。这不会改变您的应用程序的运行方式。您将不需要更新targetSdkVersion
  • 从版本 11.2.0 开始,Google 移动广告 SDK 可通过 Google 的 Maven 存储库获得。有关详细信息,请参阅 Google Play 服务发行说明
11.0.0 2017-06-07
  • AdListener类添加了onAdClicked()onAdImpression()方法。这些方法仅对原生应用安装和原生内容广告调用。
  • AdViewInterstitialAdNativeExpressAdView类中删除了getInAppPurchaseListener()setInAppPurchaseListener()方法。还删除了相关的应用内购买类。
  • VideoController.VideoLifecycleCallbacks类中添加了OnVideoMute()OnVideoPause()OnVideoPlay()OnVideoStart()方法。
  • 通过将setImmersiveMode()方法添加到PublisherInterstitialAdRewardedVideoAd类,添加了在全屏广告上启用沉浸式模式的功能。
  • 添加了OnPublisherAdViewLoadedListener接口、 PublisherAdViewOptions类和PublisherAdViewOptions.Builder类,以便与AdLoader一起用于原生加横幅请求。
  • 添加了中介适配器可以实现的可选OnImmersiveModeUpdatedListener接口,以通知沉浸式模式更新。
  • RewardedVideoAd类添加了getMediationAdapterClassName()方法。
  • 添加了keep规则以在使用ProGuard时自动保留中介适配器类名称。
10.2.0 2017-2-15
  • Google Play 服务 10.2.x 是第一个不再包含对 Android 版本 2.3.x (Gingerbread) 的完全支持的版本。使用 SDK 版本 10.2.x 及更高版本开发的应用程序要求最低 Android API 级别为 14,并且不能安装在 API 级别低于 14 的设备上。要了解有关您的选项的更多信息,包括构建多个 APK 以扩展您的应用程序对 Android Gingerbread 的支持,请参阅Android 开发者博客
  • 添加了对原生高级内容和自定义模板广告的视频资产的支持。
  • PublisherAdView类添加了getVideoController()setVideoOptions()getVideoOptions()方法。
  • 添加了AdChoicesView类。
  • getAdChoicesContent()setAdChoicesContent()方法添加到NativeAdMapper类。
  • 添加了InitializableMediationRewardedVideoAdAdapter接口,用于希望在发出广告请求之前选择早期初始化的激励视频中介适配器。
  • 在 Google Ad Manager 中添加了对应用内预览和问题排查的支持。
10.0.1 2016-11-21
  • 错误修复和一般改进。
9.8.0 2016-10-24
  • MobileAds.Initialize(Context)已被弃用。 Google Ad Manager 发布商应在初始化其应用时调用此方法。 AdMob 发布商仍应使用MobileAds.Initialize(Context, String)并传递其应用程序代码。
9.6.0 2016-09-22
  • 为原生广告高级视频广告添加了MediaView类。
  • MobileAds类添加了一个openDebugMenu()方法,用于 Ad Manager 广告单元的广告素材预览和问题排查。
  • 添加了对奖励视频自定义事件的支持。
9.4.0 2016-08-01
  • 错误修复和一般改进。
9.2.0 2016-06-27
9.0.1 2016-05-26
  • 解决了 9.0.0 中引入的 ProGuard 问题。发布商不再需要com.google.android.gms.common.util.DynamiteApikeep选项。
9.0.0 2016-05-18
8.4.0 2015-12-18
  • 添加了一个公共方法MobileAds.setAppVolume()来通知移动广告 SDK 应用的当前音量级别。
  • 实施了错误修复和改进。
8.3.0 2015-11-6
  • 添加了对奖励视频广告的支持。
  • PublisherAdViewPublisherInterstitialAd添加了isLoading()方法,以检查广告请求是否正在进行中。
  • AdRequest.BuilderPublisherAdRequest.Builder添加了setIsDesignedForFamilies()方法。
  • NativeAdView添加了destroy()方法。
8.1.0 2015-09-24各种错误修复。
7.8.0 2015-08-13
  • MRAID v2 正式发布版。
  • AdLoaderAdViewInterstitialAd添加了isLoading()方法,以检查广告请求是否正在进行中。
  • 已弃用PublisherAdRequest.Builder#setManualImpressionsEnabled() 。请改用PublisherAdView#setManualImpressionsEnabled()
7.5.0 2015-05-28
  • 添加了对跨 AdMob 和 Ad Manager 的应用安装和内容原生广告格式的支持。
  • 添加了对自定义原生广告格式的支持,可用于 Ad Manager 预订。
7.3.0 2015-04-28各种错误修复。
7.0.0 2015-03-19
  • PublisherAdRequest.Builder添加addCustomTargeting()addCategoryExclusion()方法。
  • 修复了使用手动展示次数计数时导致PublisherAdView.recordManualImpression()在 Ad Manager 中记录多次展示的问题。
  • 修复了在<supports-screens>标记上使用android:largestWidthLimitDp属性时导致广告无法正确呈现的问题。
  • AdRequest.BuilderPublisherAdRequest.Builder添加了setRequestAgent()方法。此方法应用于表示第三方以移动广告 SDK 为中介的广告请求来源。
6.5.87 2014-12-08
  • 引入了拆分 JAR 架构——Android Studio 开发人员现在可以根据com.google.android.gms: play‑services‑ads :6.+只包含 Google Play 服务的广告部分。
    注意:以 XML 格式创建横幅广告的应用程序仍必须引用整个库com.google.android.gms: play‑services :6.+
  • 各种错误修复。
6.1 2014-10-08
  • com.google.android.gms.ads.MediationAdRequest添加了一个getLocation()方法。
  • 为可访问性的插页式关闭按钮添加了内容描述。
  • 当库项目正确链接时,删除了“未找到 Google Play 资源”的日志记录。
  • getMediationAdapterClassName()添加到AdView以获取当前显示广告的广告网络中介适配器的类名。
5.0 2014-06-25
  • 添加了新的 API 来实现自定义事件。
  • 使用 Google Play Billing API 添加了应用内购买的默认购买流程。
4.4 2014-05-07
  • 添加了新的中介适配器 API。
  • 为手机和平板电脑添加了新的 320x100 LARGE_BANNER广告格式。
  • 为应用内购买添加了新的插页式格式。在InterstitialAd上设置InAppPurchaseListener以侦听应用内购买事件。
  • 由于未经许可读取 gservices 而导致SecurityException崩溃的错误修复。
4.3 2014-03-17
  • 如果传递了应用程序上下文, InterstitialAd现在会起作用。
  • PublisherAdRequest.Builder添加了setContentUrl()方法。
  • 修复服务未注册时的异常。
4.2 2014-02-03各种错误修复。
4.1 2014-01-16
  • 添加了对 Ad Manager 和移动应用搜索广告的支持。
  • AdRequest.Builder现在有一个setLocation()方法。
  • 修复了在请求插页式广告但未在清单中指定AdActivity时发生的崩溃。
4.0 2013-10-31
  • Google Mobile Ads API 现在是Google Play 服务的一部分。
  • Google Mobile Ads API 的未来更新会通过 Google Play 服务自动推送到设备。
  • 尚不支持移动应用的 Ad Manager 和 Search Ads。