Note di rilascio

• 修复了以下问题：如果广告对象在广告完成呈现之前被释放，系统不会调用 GADFullScreenContentDelegate 方法。
• Open Measurement：已更新为 OM SDK 1.5.2。

• 废弃了 GADErrorMediationNoFill。
• 插页式滚显广告：废弃了 GADMediationInterscrollerAd 和 -loadInterscrollerAdForAdConfiguration:completionHandler:。

• 更改了视频缓冲，以提升使用移动网络连接时的播放性能。

• 官方版本支持 iOS 18。
• 修复了导致应用打开广告无法隐藏状态栏的问题。
• 更新了调试控制台日志，以便使用 OSLog 和子系统名称 com.google.GoogleMobileAds。
• 修复了与 MarketplaceKit 相关的 bug，该 bug 会导致 SDK 在 MacOS 上运行时崩溃。

• 原生广告：修复了播放暂停的视频会触发额外的 GADVideoControllerDelegate 播放和暂停回调的 bug。

• 弃用了 GADQueryInfo API。如需生成查询信息，请改用 +[GADMobileAds generateSignal:completionHandler:]。

• 添加了对 MarketplaceKit 的依赖项。这要求应用使用 Xcode 15.3 或更高版本进行构建。
• MarketplaceKit 仅支持 Swift，因此我们在分发版中添加了一个 Swift 占位符文件，以便应用中包含 Swift 标准库，即使它们不包含其他 Swift 文件也是如此。

• 向 GADBannerView 添加了 isCollapsible 属性，用于检查返回的横幅是否可收起。
• 现在，将素材资源视图设置为 nil 后，原生广告素材资源视图的 userInteractionEnabled 状态会恢复。
• 广告检查器：添加了对显示其他隐私信号（例如 TFUA 和 TFCD）的支持。

• 使用团队 ID EQHXZ8M8AV 将签名身份从 AdMob Inc. 更新为 Google LLC。如果这在 Xcode 中触发了通知，请选择“接受更改”以接受新身份。

• 向 GADAppOpenAd 添加了 adUnitID 属性。

• 添加了对隐私权清单文件的支持。
• Open Measurement：已更新为 OM SDK 1.4.12。
• 改进了一些响应错误代码，以正确识别网络故障而不是无填充。
• 更新了 SDK 的 Info.plist，以解决 Xcode 15.3 上的 Swift Package Manager 问题。
• 广告检查器：添加了对显示 .plist 信息和 IAB TCF 值的支持。

• 修复了以下问题：加载视频广告可能会触发有关主线程使用情况的警告消息发送到控制台。
• 广告检查器：添加了对显示用户的应用跟踪授权状态的支持。

• Open Measurement：
  • 回滚到了 OM SDK 1.4.8。
  • 解决了 OM SDK 1.4.10 中存在的意外全局 adView 符号问题。如果多个库包含 OM SDK 1.4.10，则会导致重复符号错误。

• 重大变更：
  • 该 SDK 不再直接依赖于 GoogleAppMeasurement。要继续在 AdMob 中收集用户指标，请将您的 AdMob 应用关联到 Firebase，并将 Google Analytics for Firebase SDK 集成到您的应用中。
  • 将支持的最低 Xcode 版本更新为 15.1。
  • 将最低部署目标更新为 iOS 12。
  • 将接收广告的最低操作系统要求更新为 iOS 13。
  • 移除了许多之前已废弃的 API。
• Open Measurement：已更新为 OM SDK 1.4.10。
• 全屏广告：
  • 全屏广告的 UIViewController 引用现在可为 null，并且不是必需的。如果未提供视图控制器，SDK 会使用应用的主窗口自动查找视图控制器。
• 测试：
  • 更新了 isTesting API：现在，如果设备是模拟器或在 AdMob 界面中定义为测试设备，GADMediationAdConfiguration.isTestRequest 和 GADCustomEventRequest.isTesting 会返回 true。
• 广告检查器：
  • 广告检查器现在会显示会话开始期间遇到的任何错误。
  • 修复了 SDK 初始化期间与广告检查器相关的罕见崩溃问题。

• 弃用了 GADSimulatorID。默认情况下，模拟器已处于测试模式。
• 弃用了 -setSameAppKeyEnabled:。请改用 -setPublisherFirstPartyIDEnabled:。
• 为 GADCustomEvent API 添加了额外的废弃警告。 请改用 GADMediationAdapter API。

• 为Publisher Privacy Treatment API（Beta 版）添加了 publisherPrivacyPersonalizationState 属性。
• 废弃了 GADAdFormatUnknown。

• 弃用了 GADMediationAdConfiguration 中的 childDirectedTreatment 属性。 请改用 GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment。

• 修复了以下 bug：如果广告以一种屏幕方向加载，但以另一种屏幕方向展示，可能会导致某些广告素材显示不正确。

• 官方版本支持 iOS 17。
• Open Measurement：已更新至 OM SDK 1.4.8。
• 广告检查器：添加了 SDK 支持，以显示插件信息。
• 移除了建议在 testDeviceIdentifiers API 中添加模拟器 ID 的控制台日志。默认情况下，模拟器已处于测试模式。

• Open Measurement：已更新至 OM SDK 1.4.6。
• 广告检查器：添加了对导出广告响应的 SDK 支持。
• 修复了音频问题，即即使广告静音，音频会话也会在视频结束时意外停止背景音乐。
• 添加了在生成 GADQueryInfo 时传递广告单元 ID 的支持。

• 对 adWillPresentFullScreenContent:、adWillDismissFullScreenContent: 和 adDidDismissFullScreenContent: 委托回调由参与中介的广告的委托方处理的方式进行了细微更改。这些变化使得参与中介的广告更像是第一方广告。
• 现在，多次调用 adWillPresentFullScreenContent: 后跟 adDidDismissFullScreenContent: 的第三方 SDK 将触发多个回调，而不是仅触发第一组调用。
• 当第三方全屏广告未能展示时，系统会调用 ad:didFailToPresentFullScreenContentWithError:，而不是 adWillPresentFullScreenContent: 和 adDidDismissFullScreenContent:。

• GADRequestConfiguration：废弃了 tagForChildDirectedTreatment: 方法，并添加了 tagForChildDirectedTreatment 读写属性。
• GADRequestConfiguration：废弃了 tagForUnderAgeOfConsent: 方法，并添加了 tagForUnderAgeOfConsent 读写属性。
• 弃用了 sdkVersion。请改用 versionNumber。
• 现在，系统可以保留非渲染适配器以收集信号。

• 减少了发出大量并行广告请求时的内存用量。

• 修复了创建 GADQueryInfo 对象时发生的内存泄漏问题。

• 将支持的最低 Xcode 版本更新为 14.1。
• Xcode 14 不支持 armv7，并且已将其从 SDK 中移除。
• 最低部署目标已提高到 iOS 11.0。
• 广告检查器：添加了 SDK 支持，以便在广告检查器界面中显示广告单元名称。

• 修正了一些错误并提升了性能。

• 向 GADVideoController 添加了 isMuted 属性。

• 修正了一些错误并提升了性能。

• 重大变更：
  • 不再在 iOS 11 上投放广告。必须使用 iOS 12 才能检索广告，但最低部署目标仍为 iOS 10.0。
  • 现在，所有 Ad Manager 应用都需要 Ad Manager 应用 ID。该 ID 的格式为：
    ca-app-pub-################~##########。如需了解更多详情，请参阅更新您的 Info.plist。
  • 现在，所有 Ad Manager 应用都需要 GoogleAppMeasurement.xcframework。
  • 移除了以下已弃用的字段：
    • userBirthday
    • userGender
    • userHasLocation
    • userLatitude
    • userLocationAccuracyInMeters
    • userLocationDescription
    • userLongitude
• 原生广告：修复了以下 bug：即使图片在 GADMediaView 中成功呈现，GADMediaContent.mainImage 也会返回 nil。
• 广告检查器的偏离上下文的原生广告现在具有媒体视图。
• 废弃了 GADMediationAdConfiguration 中的以下字段：
  • userHasLocation
  • userLatitude
  • userLocationAccuracyInMeters
  • userLongitude
• 从 Google 移动广告 SDK build 中移除了位码。

• 开屏广告： +loadWithAdUnitID:request:orientation:completionHandler: 已弃用，取而代之的是 +loadWithAdUnitID:request:completionHandler:。现在，加载开屏广告会假定设备的屏幕方向，与其他全屏广告格式匹配。
• 为开屏广告添加了中介支持。
• 广告检查器：添加了通过广告检查器界面请求和展示广告的 SDK 支持。

• 支持在原生广告中执行其他点击操作。
• 修正了一些错误并提升了性能。

• 添加了 GADQueryInfo，以支持信号收集和呈现。
• 更新了音频 API 的文档。

• 修正了一些错误并提升了性能。

• 支持 iOS 16 的正式版本。
• iLTV：向 GADAdNetworkResponseInfo 添加了以下属性：
  • adSourceID
adSourceInstanceName
adSourceName
  向 GADResponseInfo 添加了以下属性：
  • extrasDictionary

• 修正了一些错误并提升了性能。

• 激励广告中介：废弃了 GADMediationRewardedAdEventDelegate 中的 didRewardUserWithReward:，取而代之的是 didRewardUser。didRewardUserWithReward: 提供的广告奖励始终是无操作的，广告奖励值来自 Ad Manager 界面中的广告单元设置。
• 广告检查器：添加了对导出广告请求的 SDK 支持。

• 向 GADResponseInfo 添加了 loadedAdNetworkResponseInfo 属性，用于返回有关加载广告的广告联盟的信息。
• 向 GADAdNetworkResponseInfo 添加了 adSourceInstanceID 属性。

• 添加了对 WKWebView 中广告创收功能的支持。如需了解详情，请参阅集成适用于广告的 WebView API。

• 原生广告中介：系统现在会对中介的原生广告调用 nativeAdDidRecordImpression: 和 nativeAdDidRecordClick: 回调。
• 在公共头文件中将 extern 替换为 FOUNDATION_EXPORT，以支持与 C++ 头文件的兼容性。

• 将支持的最低 Xcode 版本更新为 13.2.1。
• 修正了一些错误并提升了性能。

• 修正了一些错误并提升了性能。

• Open Measurement：已更新为 OM SDK 1.3.30。
• 添加了在应用代码引用 adDidPresentFullScreenContent，而不是 GADFullScreenContentDelegate 中较新的 adWilllPresentFullScreenContent 时发出的警告

• 修正了一些错误并提升了性能。

• 主要版本 9 的变更，如迁移至 SDK v9 中所述。

• 弃用了 GAMRequest 中的常量 kGAMSimulatorID。改为在 GADRequestConfiguration 中使用 GADSimulatorID。
• 废弃了 GADAdNetworkResponseInfo 中的 credentials 属性。使用同一类中的新 adUnitMapping 属性。

• 修复了以下 bug：在测试模式下从视图层次结构中移除原生广告视图时，原生广告验证工具可能会导致崩溃。
• 废弃了所有带 kGAD 前缀的常量。请改用前缀为 GAD 的命令。

• 官方版本支持 iOS 15。
• 添加了保护措施，以防止在 iOS 9 或更低版本上运行 Google 移动广告 SDK 时应用崩溃。该 SDK 仅在 iOS 10 及更高版本中受支持，否则将不执行任何操作。

• 发布了内嵌自适应横幅广告 API。

• 修复了影响 iOS 15 Beta 版的罕见 bug，该 bug 会导致多场景应用的全屏 WebView 可能无法正确调整大小。
• 修复了以下 bug：如果通过复制方法创建 GADRequest 对象，对 registerAdNetworkExtras: 的调用会崩溃。

• 添加了逻辑，以防止出现多个应用内商店可能互相叠加的罕见情况。

• 添加了 bannerViewDidRecordClick: 和 adDidRecordClick: 代理 API，用于报告广告点击次数。
• 已将 GADRequest 中的 keywords 属性类型更改为 NSArray<NSString *>。

• 弃用了 GADCustomNativeAd 中的 mediaView 属性。 请改用同一类中的新 mediaContent 属性。
• 修复了以下 bug：系统未针对出价原生广告调用视频静音 / 取消静音委托回调。
• 将 kGAMSimulatorID 类型从 id 更新为 NSString*，以避免在 Swift 中进行额外的类型转换。

• 修复了以下 bug：在关闭广告后，如果多次展示实验性广告格式，系统不会关闭它。

• 增强了对使用 SKAdImpression 的 SKAdNetwork 转化事件的支持。

• 添加了对发布商第一方 ID（以前称为“同应用标识键”）的支持，可帮助您利用从应用中收集的数据来投放更相关、更具个性化的广告。
• 向 GADFullScreenContentDelegate 添加了 adWillDismissFullScreenContent:。
• 修复了在呈现之前立即调用 adDidPresentFullScreenContent:，而不是在之后立即调用的问题。

• 修复了在使用具有不同 user_target_xcconfig 设置的多个 pod 时发生的 CocoaPods 安装错误“Can't merge user_target_xcconfig”。

• 添加了额外的 SKAdNetwork 支持，为强制执行 AppTrackingTransparency 做准备。
• 移除了仅在 11 之前的 Xcode 版本中需要的 UIWindowScene 宏定义。

• 废弃了 disableAutomatedInAppPurchaseReporting 和 enableAutomatedInAppPurchaseReporting。IAP 报告已从 SDK 中移除。这些方法现在无效。
• 添加了标志，以减少 SDK 对 CTTelephonyNetworkInfo API 的访问权限。

• 主要版本 8 的变更，如为 SDK v8 做准备中所述。
• 提高了并发发出大量请求时的 SDK 性能。
• 移除了对 i386 架构的支持。Xcode 不再支持 32 位模拟器。
• 修复了 GADMediationAdapter 协议中的 adapterVersion 与 Swift 中的 NSObject 冲突的 bug。

• 要求应用针对 Xcode 12.0 或更高版本进行构建。
• 添加了 arm64 模拟器 slice，以允许在 Apple Silicon Mac 平台的模拟器上进行测试。
• 向 GADDynamicHeightSearchRequest 添加了 styleID 参数。
• 针对 Beta 版全屏广告格式向 GADFullScreenContentDelegate 添加了 -adDidRecordImpression: 回调。
• 添加了对 NSUserDefaultsgad_has_consent_for_cookies 的支持。当 gad_has_consent_for_cookies 偏好设置设为 0 时，移动广告 SDK 将启用 受限广告 (LTD) 。 如需了解详情，请参阅设置 Cookie 意见征求。
• 当使用 forChildDirectedTreatment: true 调用 GADMobileAds.sharedInstance().requestConfiguration.tag（请参阅面向儿童的内容设置）或调用 GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent(true)（请参阅未达到同意年龄的用户设置）时，Mobile Ads SDK 会停用广告标识符 (IDFA) 传输。

• 将 SDK 从 .framework 更新为 .xcframework。现在，安装 CocoaPod 需要使用 CocoaPods 1.9.0 或更高版本。
• 从分发中移除了 arm64e。在 arm64e 上进行本地测试的功能将不再可用。
• 添加了原生广告政策验证工具。
• 添加了广告检查器 Beta 版。
• 修复了 GADNativeCustomTemplateAd 的 rootViewController 保留指向广告的强指针的 bug。

• 发布了适用于插页式广告和激励广告的新 Beta 版 API。新 API 提供相同的功能，但一致性更高。
• 向 GADRequest 添加了 neighboringContentURLStrings 属性。
• 添加了适用于 GADRewardedInterstitialAd 格式的 API。插页式激励广告目前处于非公开 Beta 版阶段。如需申请访问权限，请与您的客户经理联系。
• 修复了广告着陆页在有缺口的设备上被截断的 bug。

• 横幅广告：向 GADBannerViewDelegate 添加了 adViewDidRecordImpression: 委托方法。

• 要求应用针对 Xcode 11.0 或更高版本进行构建。
• 弃用了 GADInstreamAd 格式。
• 测试广告：现在，在 IDFA 不可用的情况下，支持添加测试设备。

• 适用于 iOS 14 的正式版。
  • 添加了对应用跟踪透明度的支持。如需了解详情，请参阅请求应用跟踪透明度授权。
  • 添加了对 SKAdNetwork 的支持。我们强烈建议您在应用中注册 Google 广告联盟。
• Google 移动广告 SDK 现已随 User Messaging Platform SDK 一起分发。
• 对于 CocoaPods 用户，最低部署目标平台现在为 9.0。
• 修复了导致 GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth() 返回错误屏幕方向的大小的 bug。
• 向 GADNativeAd 添加了 responseInfo 属性，并废弃了 adNetworkClassName 属性。
• 向 GADMobileAds 添加了 sdkVersion 属性，并在 GADRequest 中废弃了 sdkVersion 方法。

• 开屏广告：将 GADAppOpenAd 更改为全屏格式。开屏广告目前处于非公开 Beta 版阶段。请与您的客户经理联系，申请访问权限。
• 原生广告：添加了 mediaContent 属性，并废弃了 GADNativeCustomTemplateAd 的 videoController 属性。
• 插页式广告中介：中介适配器中的 interstitialDidDismissScreen: 回调现在已去重。

• 修复了以下 bug：由于取下耳机而暂停视频后，需要点击两次才能播放视频。

• 向 GADResponseInfo 添加了 dictionaryRepresentation 属性，以便更轻松地记录响应信息。
• 移除了 DFPCustomRenderedAd 类，这是一个未使用的广告格式类，应用不应引用。

• 激励广告：将 GADRewardedAd 的 serverSideVerificationOptions 属性修改为 strong，而不是 copy。
• 在 GADResponseInfo 和 GADAdNetworkResponseInfo 上实现了 description 方法，以便更轻松地进行日志记录。
• 所有呈现错误（例如rewardedAd:didFailToPresentWithError:）现在始终从 GADPresentationErrorCode 返回代码。 中介呈现错误会显示为底层错误。

• Open Measurement：已更新至 OM SDK 1.3.3。
• 插页式广告：修复了 iPad 上的插页式广告可能会旋转到不受支持的方向，进而导致界面问题的错误。
• 测试广告：将测试广告标签更新为显示“测试模式”（而非“测试广告”），并更新了标签界面。

• 最低 Xcode 版本支持已提高至 11.0。
• 向 GADResponseInfo 添加了 adNetworkInfoArray 属性。此属性会显示在此广告响应中调用的中介广告联盟的元数据。
• 为隐藏的广告元素停用了无障碍功能，以便 VoiceOver 等工具不会读出未启用的元素。

• 弃用了 GADRewardBasedVideoAd。所有客户端都应使用 GADRewardedAd。
• 改进了“找不到适配器”错误消息。错误消息现在包含适配器的名称。
• 修复了 GADRewardedAd 问题：在未加载激励广告的情况下，系统不会回调 rewardedAd:didFailToPresentWithError: 方法。
• 修复了广告素材尝试在 SafariViewController 中加载非 HTTP 网址时可能会发生的潜在崩溃问题。

• 针对 GADMobileAds 添加了 disableAutomatedInAppPurchaseReporting 和 enableAutomatedInAppPurchaseReporting 实例方法，并废弃了 disableAutomatedInAppPurchaseReporting 类方法。在初始化 Google 移动广告 SDK 或加载广告之前调用 disableAutomatedInAppPurchaseReporting，以停用自动 IAP 报告。
• 向 GADMobileAds 添加了 disableMediationInitialization 方法。请在初始化 Google 移动广告 SDK 之前调用此方法，以停用中介适配器初始化。
• 移除了 i386 架构。不再支持 32 位模拟器。

• 激励广告：修复了 rewardedAd:didFailToPresentWithError: 针对错误返回类型 NSString 而非 NSError 的 bug。

• 移除了对 UIWebView 的所有引用。 不再支持 UIWebView。

• Open Measurement：已更新至 OM SDK 1.3.1。
• 将 WKWebView 作为所有网页视图的默认 SDK。
• 添加了对从 IAB TCF v2.0 和 IAB us_privacy 字符串中读取意见征求参数的支持。

• 将 kGADErrorAppIDMissing 错误代码重命名为 kGADErrorApplicationIdentifierMissing。
• 激励广告中介：修复了使用 GADRewardedAd API 时出价不起作用的错误。

• Open Measurement：已更新为 OM SDK 1.2.21。
• 插页式广告/激励广告：添加了 canPresentFromViewController: 方法。多场景应用可使用此方法检查在场景改变大小时广告是否仍可展示。
• 插页式广告：现在，如果尝试呈现尚未准备就绪的广告或已呈现的广告，系统会调用 interstitialDidFailToPresentScreen:。
• 原生广告：修复了在后台线程上调用界面 API 的 bug。
• 修复了在加载广告时发生的 GADBlockSignalSource 内存泄漏问题。
• 原生中介：移除了 GADMediatedNativeAppInstallAd 和 GADMediatedNativeContentAd。
• 原生中介：向 GADMediatedUnifiedNativeAd 协议添加了 duration 和 currentTime 属性。

• 修复了不遵守请求中插播广告媒体宽高比的 bug。

• 支持的最低 iOS 版本已提高到 iOS 9。应用仍可针对 iOS 8 进行关联，但广告仅在 iOS 9 及更高版本中加载。
• 向 GADMediaContent 添加了 currentTime 和 duration 属性。
• 向 GADInstreamAd 添加了 mediaContent 属性，并移除了 videoController、duration、currentTime 和 aspectRatio 属性。
• 添加了自适应锚定横幅广告 API Beta 版。

• 支持 iOS 13 的正式版本。
• Open Measurement：已更新为 OM SDK 1.2.19。
• 添加了对多场景应用的支持。支持多场景的应用必须在 GADRequest 上设置 scene 属性，才能接收大小合适的广告。
• 移除了 SKStoreProductViewController 子类，因为 iOS 13 不允许使用该子类。
• 解决了在应用商店提交期间关于已废弃 API 使用情况的 Apple 警告。
• 向 GADMobileAds.requestConfiguration 添加了 testRequestIdentifiers 属性。弃用了 GADRequest 上的 testDevices 属性。
• 弃用了 kGADErrorMediationNoFill 错误代码。现在，所有无填充错误都会返回 kGADErrorNoFill 错误代码。
• 激励广告：现在，您可以在展示 GADRewardedAd 之前的任何时间设置 customRewardString 属性。以前，您需要在加载广告之前设置此属性。
• 中介：改进了找不到中介适配器或不符合正确协议时的公开错误消息。

• 添加了广告响应标识符 API，以便在 Ad Manager 广告审核中心内查找广告素材。

• Open Measurement：已更新至 OM SDK 1.2.17。
• 激励广告：修复了以下 bug：使用旧版激励视频广告 API（例如 GADRewardBasedVideoAd) 的中介报告中出现了展示次数下降的情况。

• 开放式衡量：已更新为 OM SDK 1.2.16。
• 改进了当应用在 Info.plist 中错误配置其应用 ID 时显示的日志消息。
• 修复了插页式广告和激励视频应用安装广告中的呈现错误。

• 在 GoogleMobileAds 框架中添加了 arm64e 架构，以支持在设备上进行测试。现在，必须使用 Xcode 10 进行构建。
• 原生广告：移除了之前废弃的 GADNativeAppInstallAd 和 GADNativeContentAd API。应用应使用统一的原生广告。
• 原生广告：修复了以下 bug：即使原生广告包含视频内容，也会返回 nil 媒体视图和宽高比为零。
• 中介：修复了中介适配器针对同一请求触发多个成功/失败回调时发生崩溃的问题。

• Open Measurement：已更新为 OM SDK 1.2.15。
• 修复了在极少数情况下关闭视频广告时发生的崩溃问题。
• 更新了 rewardedAdMetadataDidChange 回调，使其在元数据为 nil 时不调用。

• 支持应用衡量的正式版本。
• Open Measurement：已更新为 OM SDK 1.2.14。
• 移除了 GADCorrelator 及其关联的 API。此功能之前无法使用。
• GADNativeAdImageAdLoaderOptions 中的 preferredImageOrientation 属性已废弃。请改用 GADNativeAdMediaAdLoaderOptions。

• 将最低 iOS 版本要求更新为 8.0。
• 支持 Open Measurement 的官方发布版本。
• Open Measurement：包括 OM SDK 1.2.13。
• 开放式衡量：新增了对自定义原生广告格式的支持。
• 原生广告：向 GADMediaContent 添加了 videoController 和 hasVideoContent 属性。
• 原生广告：弃用了 GADUnifiedNativeAd 中的 videoController，以及 GADVideoController 中的 hasVideoContent 和 aspectRatio 方法。
• 原生广告：添加了带有 aspectRatio 属性的 GADNativeAdMediaAdLoaderOptions 类，使发布商能够请求采用特定宽高比的原生广告媒体素材资源。此选项的优先级高于 GADNativeAdImageAdLoaderOptions 中的 preferredImageOrientation 属性。
• 原生广告：GADMediaView 现在会在呈现图片时遵循 contentMode 属性。

• 激励广告中介（新版 API）：修复了以下 bug：激励广告中介适配器会在加载调用后自动取消分配。

• 修复了在取消分配视频广告时可能发生的罕见崩溃问题。

• Google 移动广告 SDK 现在依赖于应用衡量。您必须添加应用衡量框架和依赖项。您必须使用键 GADIsAdManagerApp。 如需了解详情，请参阅快速入门指南。
• SDK 框架大小已缩减至低于 GitHub 上限。
• tagForChildDirectedTreatment 已添加到 GADMobileAds.sharedInstance.requestConfiguration。 [GADRequest tagForChildDirectedTreatment] 已废弃。
• 修复了在元数据未更改时调用 rewardBasedVideoAdMetadataDidChange: 的错误。

• 激励广告：添加了新的 GADRewardedAd API（处于公开 Beta 版测试阶段），可让您同时加载多个激励广告。
• 激励广告：在 GADRewardBasedVideoAd 中添加了 admetadata 属性。使用 rewardbasedvideoadmetadatadidchange: 监听广告元数据更改。

• 提升了性能。

• 修复了在引用 GADCustomEventParametersServer 时会导致 build 错误的问题。
• 在 GADMediaContent 类中添加了 mainImage 属性，以便在没有视频时为原生广告设置主图片素材资源。

• 修复了表格视图中展示的自适应广告的呈现问题。
• 添加了新的 GADMediaContent 类以提供媒体内容信息。

• 改进了与 Crashlytics 的兼容性，提供的崩溃报告具备更新的堆栈轨迹符号化功能，因此更加实用。

• 修复了某些中介适配器可能针对同一插页式广告或激励广告的展示统计多次的问题。

• 修复了其他问题。

• 修复了其他 bug。

• 修复了在 rewardBasedVideoAdDidClose: 委托方法中加载新的激励广告后无法再加载激励广告的问题。
• 目前 Xcode 的最低版本为 9.2。

• 不再允许在展示一个激励广告时请求第二个激励广告。这修复了以下问题：请求第二个激励广告会破坏多个第三方中介适配器。呈现结束后，可以在 rewardBasedVideoAdDidClose: 中请求另一个广告。
• 已修复：CocoaPod 已更新，将文件大小减小到 100 MB 以下，允许将 SDK 文件推送到 GitHub 代码库。

• 原生广告：修复了视频广告有时无法正常播放的问题。
• 原生广告：修复了非视频广告的 GADMediaView 为空的问题。
• DFP 横幅广告：修复了调整大小方法行为不正确的 bug。

• 添加了对 iOS 12 的支持。
• 修正了一些错误并提升了性能。

• 激励广告：向 GADRewardBasedVideoAd 添加了 customRewardString 属性，以便发布商将自定义数据传递给服务器端验证请求。
• 原生广告：GADNativeAppInstallAd、GADNativeContentAd 和关联的 API 已废弃，取而代之的是 GADUnifiedNativeAd。有关使用新 API 的详细说明，请参阅原生高级广告（统一）指南。
• 原生广告：添加了“不再显示该广告”功能。
• 原生广告：修复了在集合视图中重复使用广告视图时移除了“广告选择”视图的 bug。
• 向 GADMobileAds 添加了 requestConfiguration 属性，该属性可用于为所有广告请求指定 maxAdContentRating 和 tagForUnderAgeOfConsent 参数。
• 中介：向 GADMediationAdRequest 添加了 maxAdContentRating 和 underAgeOfConsent 属性。

• GADNativeExpressAdView 已废弃，不再投放广告。原生快捷广告格式已被停用。
• 弃用了 GADRequest 上的出生日期和性别属性。

• MRAID v3 测试版。
• 修正了一些错误并提升了性能。

• 修复了 7.28.0 中引入的 bug，该 bug 会导致 GameKit 应用出现图形故障。

• 原生广告：添加了统一原生广告 API。这会将 GADNativeAppInstallAds 和 GADNativeContentAds 组合成一个新类型：GADUnifiedNativeAd。如需了解详情，请参阅统一原生广告指南。
• 激励视频：向 GADRewardBasedVideoAdDelegate 添加了 rewardBasedVideoAdDidCompletePlaying: 方法，以便在视频播放完毕时通知发布商。
• 激励视频中介：向 GADMRewardBasedVideoAdConnectorDelegate 添加了 connectorDidCompletePlayingRewardBasedVideoAd: 方法，以便中介适配器在视频播放完毕时调用。
• 原生中介：更新了 GADMediatedNativeAdDelegate.h，以便适配器访问原生广告中使用的各个视图。

  添加时间:

  -mediatedNativeAd:didRenderInView:clickableAssetViews:nonclickableAssetViews:viewController:

  已弃用：

  -mediatedNativeAd:didRenderInView:viewController:

• 新增了对原生视频广告中介的支持。原生广告中介适配器必须对 GADMediatedNativeAppInstallAd 和 GADMediatedNativeContentAd 实现 mediaView 方法，并返回其媒体视图。
• 为 QuartzCore 和 CFNetwork 框架添加了依赖项。

• 支持 iPhone X。
• 对于全屏广告，默认关闭按钮现在会在安全区域内呈现。
• 从 GADAdChoicesView 和 GADMediaView 中移除了 nativeAd 属性。
• 将 SDK 与 Apple 的 StoreServices 的互动限制为启动应用时每个会话一次。
• 现在，测试广告会在广告顶部显示一个标签。如需了解详情，请参阅测试指南。

• 原生广告中介：现在，只要原生广告与原生广告视图相关联，适配器就会调用 mediatedNativeAd:didRenderInView:viewController:，而不是等待系统显示相应的原生广告视图。
• 原生中介：现在，当被跟踪的视图被取消分配时，适配器会使用 nil 视图调用 mediatedNativeAdDidUntrackView:。

• 更新了 SDK 与 Apple 的 StoreServices 互动的方式。

• 官方版本支持 iOS 11。
• 移除了 GADAdDelegate。应改为使用 GADAudioVideoManager 管理广告音频。
• 修复了 iOS 11 中因内容内嵌而导致横幅视图向下偏移的 bug。
• 新增了对 Security 框架的依赖项。

• 现在，当原生广告被取消分配时，中介适配器会通过 mediatedNativeAd:didUntrackView: 收到通知。

• 修复了广告请求因应用在后台运行而被取消时不调用“广告未能加载”事件的问题。

• 对于选择停止展示视频广告的插页式广告单元来说，即使 MRAID 广告素材调用 useCustomClose，投放的插页式广告也会显示立即关闭选项。
• 向调试菜单添加了文本，以指明广告素材预览或问题排查模式是否处于活动状态。
• 添加了 GADMultipleAdsAdLoaderOptions 类，可让发布商指定一次请求要加载的广告数量。
• 向 GADAdLoader 添加了 loading 属性，用于指示广告加载器当前是否正在加载广告。
• 向 GADAdLoaderDelegate 添加了一个新的可选委托方法 -adLoaderDidFinishLoading:，该方法会在 GADAdLoader 完成返回请求的所有广告后调用。

• 移除了应用内购广告格式。
• 移除了 armv7s 架构。

• 修复了将不正确的广告尺寸转发到智能横幅广告中介的中介广告联盟的问题。

• 向 google_mobile_app_ads.js 添加了 openInlineBrowser() 方法，用于在 SFSafariViewController 中打开网址。
• 添加了 GADAudioVideoManagerDelegate，以便在音频和视频广告开始播放以及暂停/停止播放时提供通知。

• 向 GADVideoController 添加了 play、pause 和 setMute 方法。
• 向 GADVideoControllerDelegate 添加了与视频内容的开始、暂停、结束、静音和取消静音对应的新代理方法。
• 添加了对激励视频广告中介适配器的支持，以便在发出广告请求之前选择启用提前初始化。

• 向 GADNativeAdDelegate 添加了 nativeAdDidRecordImpression 和 nativeAdDidRecordClick。

• 向 DFPBannerView 对象添加了一个视频控制器。
• GADNativeExpressAdView、GADNativeContentAd、GADNativeCustomTemplateAd、GADNativeContentAd 和 GADNativeCustomTemplateAd 视频控制器属性现在为非 null 值。
• 原生中介：适配器现在可以在 GADMediatedNativeAppInstallAd 和 GADMediatedNativeContentAd 上设置 adChoicesView 属性，以呈现“广告选择”功能。

• 向 GADNativeContentAd 和 GADNativeCustomTemplateAd 添加了 GADMediaView 属性。

• 将中介适配器标头移到了框架和全局标头中。
• 对于 kGADAdSizeFluid 广告尺寸，更改横幅的尺寸不会再更改横幅广告视图的帧大小。

• 在 Google Ad Manager 中添加了对应用内预览和问题排查的支持。

• 添加了对 JavaScriptCore 框架的依赖项。
• 修复了其他问题。

• 纠正了 GADNativeAppInstallAd 和 GADNativeContentAd 的为空性注解。

• 修复了涉及 GADStringFromCGFloat 的崩溃问题。
• 添加了 GADNativeAdViewAdOptions，用于指定原生广告中的 AdChoices 的位置。
• 向 GADRewardBasedVideoAd 添加了 adNetworkClassName 属性。

• 移除了对 CoreBlueooth、EventKit 和 EventKitUI 框架的依赖项。
• 为 iOS 10 更新应用时，应用不再需要为 NSCalendarsUsageDescription 和 NSBluetoothPeripheralUsageDescription 提供文本。
• 移除了 MRAID 2.0 createCalendarEvent 和 storePicture 支持。

• 修复了涉及 GADStringFromCGFloat 的崩溃问题。

• 将原生广告与视图相关联时，视图的 userInteractionEnabled 属性会更改为 NO，以符合 SDK 的预期。
• 添加了对 MobileCoreServices 的依赖项。
• 添加了一个 API，用于告知广告联盟 SDK 版本是否至少为 major.minor.patch。

• 修复了会影响奖励视频中介的 bug。

• 添加了 GLKit、OpenGLES、CoreMotion 和 CoreVideo 框架依赖项，以改进和提升广告呈现效果和质量。
• 添加了 +[GADMobileAds configureWithApplicationID:] 方法。AdMob 发布商应使用其应用 ID 调用此方法。
• 使用 SDK 中介的 Google Ad Manager 发布商将不再收到“中介广告类型未知或无效”警告。

• 新增 SDK 支持，当用户明确启用应用的位置访问权限时，可自动使用位置数据。

• 新增了对 CoreBluetooth 和 SafariServices 框架的依赖项。
• 为 SDK 的主标头文件添加了为空性注释，以改进 Swift 的可选支持。
• 在大小为 kGADAdSizeFluid 的广告中，添加了对 GADAdSizeDelegate 的支持。

• 解决了在滚动视图中“原生广告”点击操作的问题。

• 新增了对激励视频广告的支持。
• 添加了对位码的支持。 虽然这增加了 SDK 下载的大小，但不会明显增加应用二进制文件的大小。 如需为您的应用更改此设置，请转到项目的 Build Settings，然后在 Build Options 部分下，将 Enable Bitcode 设置为 Yes。
• 新增了对 MediaPlayer 框架的依赖项。 您需要将此框架链接到应用的二进制文件。 如果您使用的是 CocoaPods，请运行 pod install --repo-update。
• 在基于奖励的视频 API 中移除了对 userID 的所有引用。
• 对 GADInterstitial 的 loadRequest: 方法的调用始终与异步 didFailToReceiveAd:withError: 或 interstitialDidReceiveAd: 委托调用配对。 修复了不支持此约定的个别情况。
• 原生中介： 新增了适配器处理与报告点击事件的能力。
• 搜索广告：新增了对动态高度的支持。

• 重新分组/移动了中介适配器的协议方法，以对其进行简化。
• 更正了 GADRewardBasedVideoAdDelegate 协议中 didFailToLoadWithError 消息的大写。

• 修复了一些 bug。

• 修复了 GADStatisticsCore 中的崩溃问题。

• SDK 不再在 iOS 9 设备上使用 UIApplication 的 canOpenURL 方法。
• 修复了不调用 GADNativeAdDelegate 方法的问题。
• 如果未请求任何广告类型，现在会调用 GADAdLoaderDelegate 的 adLoader:didFailToReceiveAdWithError 回调。

• 修复了当用户为标识符包含特殊字符的商品完成应用内购买时发生崩溃的问题。

• MRAID v2 测试版。
• 针对崩溃报告和应用内购买 (IAP) 自动跟踪添加了新的全局设置。如启用应用内购买自动跟踪，将会移除报告 IAP 转换的 Conversion Tracking SDK。
• GADInterstitial 上的 adUnitID 属性现在是 readonly。
• 新增了用于奖励视频中介的 API。
• 在 GADRequest 上废弃了 setLocationWithDescription:。请改用 setLocationWithLatitude:longitude:accuracy:。

• 新增了跨 AdMob、Ad Manager 和 Ad Exchange 对应用安装和内容原生广告格式的支持。
• 新增了对自定义原生广告格式的支持，可用于 Ad Manager 预订。
• 修复了 7.2.0 中引入的回归问题：智能横幅广告无法在运行 iOS 8 系统的横向设备上正确展示。

• 修复了上传到 App Store 时出现的以下警告：
  应用引用 Payload/(<app_id>):clientId,screenName,setScreenName 中的非公开选择器。

• 默认情况下，模拟器再次加载已投放的广告。在 GADRequest 的 testDevices 属性中添加 kGADSimulatorID，以在模拟器上获取测试广告。
• 添加了中介适配器的功能和自定义事件，以记录插页式广告的点击次数
• 对自定义事件 API 做出了一些小小的改进。
• 添加了 GADInterstitial initWithAdUnitID: 并废弃了 GADInterstitial init。
• 弃用了 DFPBannerView 中的 setValidAdSizesWithSizes 方法。请改用 DFPBannerView.validAdSizes。

• 需要链接到 CoreMedia.framework。
• 修复了其他问题。

• 不再支持 iOS 5。
• 发布了作为框架的 SDK。
• 移除了对 -ObjC 链接器标志的依赖项。
• 改善了 iOS 8 设备的广告加载时间。
• 向 GADRequest 添加了 requestAgent 属性。第三方集成应设置此属性，以指明请求的来源平台。
• 新增了 DFPRequest 类，支持自定义定位和类别排除。
• 将 publisherProvidedID 属性从 DFPExtras 移到了 DFPRequest。
• 将 GADAdMobExtras 和 DFPExtras 替换为了单个 GADExtras 类。
• 已废弃 GADBannerView 的 hasAutoRefreshed 属性。
• 移除了 GAD_SIMULATOR_ID 宏 - 使用 GADBannerView 和 GADInterstitial 时，系统会自动在模拟器中启用测试广告。
• 移除了 GADRequest 的 mediationExtras、additionalParameters 和测试属性。
• 废弃了 GADRequest 的 setBirthdayWithMonth:day:year:。
• 移除了 GADRequest 的 addKeyword: 方法。
• 移除了 DFPSwipeableBannerView 类。

• 关闭了横幅广告的跳出功能。
• 修复了 DumpViews 中发生的崩溃问题。

• 官方版本支持 iOS 8。
• 广告加载在 iOS 8 主线程中花费的时间减少。
• 智能横幅广告在运行 iOS 8 系统的横向设备上正确展示。
• 需要链接到两个新框架：EventKit 和 EventKitUI。如果启用模块和自动链接框架，则自动链接这些框架。
• 弃用了 GADBannerView 上的 mediatedAdView 属性。
• 移除了 GADInterstitial 中之前废弃的 loadAndDisplayRequest:usingWindow:initialImage: 方法。

• 广告现在默认用 Safari 打开而不是用应用内浏览器打开。指定 mraid.expand() 或 admob.opener.openOverlay() 时，广告素材可以重写此行为。
• DFPBannerView 上已停用滑动手势。
• DFPSwipeableBannerView 已废弃，取而代之的是 DFPBannerView。

• 已弃用 GADInterstitial 上的 loadAndDisplayRequest:usingWindow:initialImage 方法。
• SDK 中未捆绑的分析产品包使 SDK 的大小减少了 (9.6 -> 3.4)MB。分析 SDK 可在此处下载。
• DFPExtras 上的 contentURL 属性已移至 GADRequest。
• 修复了各种 bug。

• 不再支持 iOS 4.3。此 SDK 支持 iOS 5.0 及更高版本，现提供 ARC 弱引用。
• 新增了 320x100 大横幅格式，带有固定的 kGADAdSizeLargeBanner。
• 新增了可实现应用内购买的插页式广告格式。在 GADInterstitial 上设置了 inAppPurchaseDelegate 属性，用于处理应用内购买事件。

• 改进了广告定位。
• 需要链接到 CoreTelephony 框架。
• 修复了设备进入飞行模式时出现的崩溃问题。

• 提升了置于 UITableView 之内的广告效果。
• 修复了其他问题。

• 需要链接到 AVFoundation 框架。
• 添加了对 arm64 和 x86_64 架构的支持。
• 大大缩减了库大小。
• 在 GADBannerView 和 GADInterstitial 上添加了 adNetworkClassName 属性。
• 修复了未为插页式广告触发 Ad Manager 应用事件的 bug。
• Ad Exchange HTML 适配器直接捆绑到了库中。Ad Exchange 开发者不再需要另行链接 libAdapterHtml.a。

• 修复了 GADBannerView 调整大小 bug。
• 针对 GADRequest 中的 COPPA 字段进行了 API 更改。
• 在广告请求中传递 Apple 的 IDFA。
• 更新了链接器标志使用情况的中介警告消息。

• 修复了当应用在后台运行时 GADInterstitial 发生崩溃的问题。
• 修复了 GADMRAIDInterceptor 线程崩溃问题。
• 修复了一条错误，以便插页代理即时接收 interstitialWillLeaveApplication。
• 重命名了 MD5 符号，以防止出现重复符号错误。
• 新增了对通过中介使用 AdMob 时接收测试广告的支持。
• 测试广告只能用于搭载 iOS 6 及更高版本的设备。
• 已删除 UDID 的所有使用。

• 新增了一条日志语句，提供向 request.testDevices 传递的 ID，以便在特定设备上启用测试广告。
• 新增了对 iOS 6 上测试广告的支持。
• 修复了 GADMraidInterceptor 中发生的崩溃问题。

• 需要链接到 StoreKit 框架。
• 修复了当应用在收到第一个中介广告之前旋转时出现的崩溃问题。

• 为 ARMv7s 构建应用时不再需要 -all_load 标志，但仍需要 -ObjC 标志。
• 要求针对 AdSupport 框架进行链接。
• 要求使用 Xcode 4.5 并针对 iOS 6 执行构建。最低部署为 iOS 4.3。
• SDK 已移除 ARMv6 说明，现在包含 ARMv7s 说明。
• 针对 iOS 6 使用 Apple 的广告标识符 (IDFA)，针对低于 iOS 6 的版本使用 UDID。
• iOS 6 各种问题修复。
• 应用内浏览器对屏幕高度更大的 iPhone 5 的兼容性。
• 与 iOS 6 自动版式的兼容性。

• 修复了第三方点击/展示跟踪的相关问题。
• 无需初始大小即可创建 DFPBannerView。 务必在加载请求之前设定 validAdSizes。

6.1.5：此版本采用了通用设备标识符 (UDID)。利用此版本的应用必须获得适当用户同意，根据有关 iOS 政策发送设备标识符。

• 修复了 MRaid Interceptor 在访问 nil 键问题时崩溃的wen。
• 发布商在使用 SDK 时需要添加 -all_load 标记。
• 特意为 Ad Manager 发布商新增了 DFPBannerView、DFPInterstitial 和 DFPExtras 对象。
• Ad Manager 新功能：多种广告尺寸。
• Ad Manager 新功能：应用事件。
• 现在“加载项”子文件夹已包含 Ad Manager、Search 和 Mediation 标头，因此不再需要分别下载。
• 已知问题：将 GADBannerView 与 Interface Builder 搭配使用时，需要在加载请求之前明确设置框架大小。

6.1.2：此版本采用了通用设备标识符 (UDID)。利用此版本的应用必须获得适当用户同意，根据有关 iOS 政策发送设备标识符。

• 新增了频次上限。
• 修复了一些小错误。

6.0.4：此版本采用了通用设备标识符 (UDID)。使用此版本的应用必须遵守相关的 iOS 政策规定，在发送设备标识符信息之前先获得用户的同意。

• 添加了广告网络中介。
• 中介包含对自家广告和自定义事件进行中介的能力。
• 为所有版本的 iOS 平台新增了 MRAID v1.0 支持。
• 废弃了 GAD_SIZE_#x# 宏，取而代之的是 GADAdSize 常量。
• 通过新的 GADSize 常量（kGADAdSizeSmartBannerPortrait 和 kGADAdSizeSmartBannerLandscape）添加了对全宽广告的支持。
• GADRequest 现在使用 registerAdNetworkExtras: 设置额外项。additionalParameters 属性已废弃。

从 5.0.8 版开始，iOS SDK 不再引用 uniqueIdentifier。

• 移除了对 uniqueIdentifier（一个已弃用的 UIDevice 属性）做出的所有引用。
• testDevices 属性已弃用，由现在未被弃用的 testing 属性取代。

• 增加了对 iPhone 和 iPad 专用的额外富媒体插页式广告格式的支持。此更新可以向前兼容未来的所有插页式广告格式。
• 改进了插页展示跟踪。
• GADInterstitial 一直都是一次性对象，但现在它可以在第一次请求之后，针对加载或展示插页式广告的请求调用 didFailToReceiveAdWithError:，然后在不引起中断的情况下失败。

• 自定义搜索广告集成。
• iOS 5.0 支持。
• 插页式广告载入速度更快。
• 模态视图控制器广告演示修复。
• 修复了锚点标记行为。

• 通过 iOS 5.0 测试版 3 的额外认证。
• GTMStringEncoding 已指定了命名空间，以免链接器与其他内容库冲突。
• 若 App Store 广告配置错误，应用内浏览器会自行关闭。
• 修复了 SDK 中的内存泄漏问题。
• 修复了 DoubleClick for Advertisers (DFA) 横幅广告的点击跟踪问题。
• 修复了几个非常罕见的崩溃问题。
• Google Ad Manager 正式版。

• 在视图控制器堆栈中，当某个被遮盖的视图控制器通过 JavaScript 发出关闭通知时，所有视图控制器都会正确关闭。
• 增加了对由服务器提供的 AFMA 插页式广告超时的支持。
• 现在可通过将设备 ID 加入白名单来启用测试模式。
• 添加了在横幅广告和富媒体重叠式广告中重复使用同一个 UIWebView的方法。
• 已将设备子型号加入 onshow 字典。
• 修复了 GADBrowserController 和 UIWebViews 中的内存泄漏问题。
• “应用打开”插页式广告视图控制器会自行锁定为纵向，以便从控制台中移除某条警告记录。
• 现在，任何 5xx HTTP 响应代码都会返回“服务器错误”，而不是“广告网络错误”。