安装 GMA 新一代 SDK

如需采用 Android 延迟和稳定性方面的改进，请使用 GMA Next-Gen SDK。本指南介绍了如何配置 Google Mobile Ads Unity Plugin，以使用适用于 Android 的 GMA Next-Gen SDK。

前提条件

在继续之前，请执行以下操作：

将最低 API 级别更新为 24

GMA Next-Gen SDK 要求最低 API 级别为 24。如需更新最低 API 级别，请执行以下操作：

  1. 在菜单栏中，依次点击 File > Build Profiles > Player Settings > Android > Other Settings > Identification。
  2. 将 Minimum API Level 设置为 Android 7.0 'Nougat' (API Level 24) 或更高级别。

修改依赖项文件

11.1.0 及更高版本

如需为 Android build 启用 GMA Next-Gen SDK，请在 Unity 编辑器中依次选择 Assets > Google Mobile Ads > Settings：

在 GMA Next-Gen SDK 设置检查器中，同时启用 Switch Google Mobile Ads Android Architecture 和 GMA Next-Gen SDK。

11.0.0 - 10.6.0

如需为 Android build 启用 GMA Next-Gen SDK，请修改依赖项文件：

  1. 在 Unity 项目中，找到 Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml 文件。

    • 如果您使用 Unity Package Manager，请依次前往 Packages > Google Mobile Ads for Unity > GoogleMobileAds > Editor > GoogleMobileAdsDependencies.xml。

  2. 找到具有 com.google.android.gms:play-services-ads 规范的 <androidPackage> 元素。

  3. 将该元素替换为最新可用版本的 com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk：

    <androidPackage spec="com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.1.1">
  <repositories>
    <repository>https://maven.google.com/</repository>
  </repositories>
</androidPackage>

  4. 保存文件。

在构建流程中，Google Mobile Ads Unity Plugin会检测到 GMA Next-Gen SDK 的存在，并转而使用该 SDK。

以下示例展示了更新后的 GoogleMobileAdsDependencies.xml 文件：

<dependencies>
<androidPackages>
  <androidPackage spec="com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.1.1">
    <repositories>
      <repository>https://maven.google.com/</repository>
    </repositories>
  </androidPackage>
  <androidPackage spec="androidx.constraintlayout:constraintlayout:2.1.4">
    <repositories>
      <repository>https://maven.google.com/</repository>
    </repositories>
  </androidPackage>
  <androidPackage spec="androidx.lifecycle:lifecycle-process:2.6.2">
      <repositories>
          <repository>https://maven.google.com/</repository>
      </repositories>
  </androidPackage>
</androidPackages>

<iosPods>
  <iosPod name="Google-Mobile-Ads-SDK" version="~> 12.11.0">
    <sources>
      <source>https://github.com/CocoaPods/Specs</source>
    </sources>
  </iosPod>
</iosPods>
</dependencies>

中介集成

如果您使用中介，请按照 Android 迁移指南中的说明在配置中介集成时排除 com.google.android.gms 模块，以避免出现重复类错误。