การย้ายข้อมูล SDK

本文介绍了现行版本和以往版本的迁移。

从 v22 迁移到 v23

最低 Android API 级别为 21

从 23.0.0 版本开始，Google 移动广告 SDK 要求所有应用支持的 Android API 级别最低必须为 21，这样才能正常运行。如需调整 API 级别，请将应用级 build.gradle 文件中的 minSdkVersion 值更改为 21 或更高。

可以链接继承自父类的 AdManagerAdRequest.Builder 方法

在版本 23.0.0 中，可以将从父级继承的 AdManagerAdRequest.Builder 方法链接在一起，以便使用单个调用构建 AdManagerAdRequest：

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
    .addCustomTargeting("age", "25") // AdManagerAdRequest.Builder method.
    .setContentUrl("https://www.example.com") // Method inherited from parent.
    .build(); // Builds an AdManagerAdRequest.

var request = AdManagerAdRequest.Builder()
  .addCustomTargeting("age", "25") // AdManagerAdRequest.Builder method.
  .setContentUrl("https://www.example.com") // Method inherited from parent.
  .build() // Builds an AdManagerAdRequest.

移除/替换了已废弃的方法

从 v21 迁移到 v22

使用 MobileAds.getVersion() 获取 Google 移动广告 SDK 版本

在版本 22.0.0 中，移除了 MobileAds.getVersionString() 方法，取而代之的是 MobileAds.getVersion()。

新方法将返回预期的外部版本号，例如 22.0.0。如需详细了解此次变更，请参阅使用新的 Google 移动广告 SDK getVersion() 方法。

移除了已废弃的 NativeCustomFormatAd.getVideoMediaView()

在版本 21 中，Google 移动广告 SDK 为您提供了 NativeCustomFormatAd.getVideoMediaView() 方法，用于为原生自定义广告格式获取媒体素材资源。

从版本 22 开始，您可以创建自己的 MediaView 并设置其媒体内容，然后使用 MediaContent.getVideoController() 获取视频控件。

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
    // Assumes you have a FrameLayout in your view hierarchy with the id media_placeholder.
    FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

    MediaContent mediaContent = ad.getMediaContent();
    if (mediaContent != null && mediaContent.hasVideoContent()) {
        // Create a MediaView and set its media content.
        MediaView mediaView = new MediaView(mediaPlaceholder.getContext());
        mediaView.setMediaContent(mediaContent);
        mediaPlaceholder.addView(mediaView);
    }
}

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
    // Assumes you have a FrameLayout in your view hierarchy with the id media_placeholder.
    FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

    VideoController videoController = ad.getVideoController();
    if (videoController.hasVideoContent()) {
        // Add the media view provided by the native ad.
        mediaPlaceholder.addView(ad.getVideoMediaView());
    }
}

如需了解详情，请参阅自定义原生广告指南。

移除或替换的方法

下表列出了版本 22.0.0 中的具体更改。

从 v20 迁移到 v21

将 minSdkVersion 更新为 19 或更高版本

从 21.0.0 版本开始，Google 移动广告 SDK 要求所有应用支持的 Android API 级别最低必须为 19，这样才能正常运行。如需调整 API 级别，请将应用的 build 文件中的 minSdkVersion 值更改为 19 或更高。

强制执行严格的可为 null 性限制

之前未明确定义可为 null 性的所有 API 中都新增了 @NonNull 注解，以便为强制执行严格的可为 null 性做好准备。

如果存在 null 安全性违规行为，且之前未以安全方式处理 null 值，那么这项变更可能会导致 Kotlin 应用和使用 Java null 检查框架的应用出错（请参阅关于 null 安全性的 Kotlin 文档）。

移除了 addNetworkExtras() 方法

addNetworkExtras() 方法可将额外参数以 NetworkExtras 实例的形式传递给特定广告联盟适配器，该方法在 SDK 版本 20.3.0 中已弃用，并将在版本 21.0.0 中移除。请改用同一 AdRequest.Builder 类中的 addNetworkExtrasBundle() 方法。

移除了地理位置方法

以下地理位置方法将在版本 21.0.0 中移除：

• AdRequest.Builder 类中的 setLocation(Location location) 方法，该方法可设置用户所在位置，以用于中介定位用途。
• AdRequest 类中的 getLocation() 方法，该方法会返回之前传递给 setLocation(Location location) 方法的用户地理位置定位信息。
• MediationAdConfiguration 类中的 getLocation() 方法，该方法会返回用户所在位置（如果已由 AdRequest 定义）。

Google 不会使用该位置数据来定位广告。如果需要，您可以使用第三方 API 向第三方广告联盟提供该信息。

弃用了自定义事件接口

借助自定义事件，使用 的发布商可以设置不属于 Ad Manager支持的广告来源的广告瀑布流来源。

所有自定义事件接口均已弃用，取而代之的是 Adapter 类和 MediationAdLoadCallback 接口。

下表列出了从版本 21.0.0 开始，应为每个自定义事件接口使用的相应类或接口：

从 v19 迁移到 v20

我们在版本 20.0.0 中进行了多项重大更改。为做好准备迎接版本 20.0.0，版本 19.7.0 中引入了许多新的 API，并弃用或重命名了许多类。本指南重点介绍了版本 20.0.0 中的主要变更。

关于全屏广告格式 API 的更新

从版本 20.0.0 开始，对插页式广告、激励广告、插页式激励广告和开屏广告格式进行了标准化处理，以采用一致的 API 设计。

所有全屏广告格式 API 均遵循以下设计原则：

• 静态加载方法
• 类似的加载回调函数或处理程序机制
• 展示回调函数需要依靠 FullScreenContentCallback 类

移除旧版 RewardedVideoAd API

较新版本的 RewardedAd API 于 2019 年 3 月首次推出，在之后超过 18 个月的时间里一直是首选激励广告 API。与旧版 RewardedVideoAd API 相比，新版 API 具备更多增强功能，其中包括一次加载多个激励广告的功能。

SDK 版本 20.0.0 中移除了旧版 RewardedVideoAd API。

弃用智能横幅广告，改用自适应横幅广告

弃用了智能横幅广告，现在使用的是自适应横幅广告。自适应横幅广告的效果更好，可以让您更灵活地设置广告宽度。如果您希望继续使用全宽横幅广告，仍然可以通过自适应横幅广告实现，如以下代码段所示：

public class MyActivity extends AppCompatActivity {
  ...
  private AdSize getFullWidthAdaptiveSize() {
    Display display = getWindowManager().getDefaultDisplay();
    DisplayMetrics outMetrics = new DisplayMetrics();
    display.getMetrics(outMetrics);

    float widthPixels = outMetrics.widthPixels;
    float density = outMetrics.density;

    int adWidth = (int) (widthPixels / density);
    return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth);
  }
}

class MyActivity : AppCompatActivity() {
  ...
  private val adaptiveAdSize: AdSize
    get() {
      val display = windowManager.defaultDisplay
      val outMetrics = DisplayMetrics()
      display.getMetrics(outMetrics)

      val density = outMetrics.density

      var adWidthPixels = ad_view_container.width.toFloat()
      if (adWidthPixels == 0f) {
        adWidthPixels = outMetrics.widthPixels.toFloat()
      }

      val adWidth = (adWidthPixels / density).toInt()
      return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth)
    }
}

移除退出应用回调函数

移除了所有广告格式的 onAdLeftApplication 回调函数，改为使用 ProcessLifecycleOwner。如果使用操作系统级 API，无论用户是否因广告互动而打开您的应用，只要他们退出应用，您都会收到通知。

请注意，千万不要将 onAdLeftApplication 回调函数用作广告点击处理程序，如果依赖此类回调函数来报告点击，将无法生成准确的指标。例如，用户点击“广告选择”图标时会启动外部浏览器，这时系统会调用该回调函数，但不会将其计为一次点击。

重命名类

下表列出了已更改或移除的具体类名称。步骤简述：

• 与 UnifiedNativeAd 相关的大多数类均已重命名为 NativeAd。
• 已移除 MobileAds.Settings、NativeExpressAdView、NativeAppInstallAd、NativeContentAd 和 InstreamAd 类及视图。
• 对于所有带 Publisher 前缀的类，其前缀均已替换为 AdManager。
• 更改了 InterstitialAd 软件包名称。

移除/替换的方法

下表列出了版本 20.0.0 中的具体更改。总结：

• 从 MobileAds 类中移除了过时的初始化方法。
• 移除了 AdRequest.Builder() 类中的部分方法，或将这些方法移到了 RequestConfiguration 类中。
• 更新了 RewardedAd 和 InterstitialAd API，以与所有全屏广告格式保持一致。
• 移除了 Correlator 功能。