安装 GMA 新一代 SDK

如需采用 Android 延迟和稳定性方面的改进，请使用 GMA 新一代 SDK。本指南介绍了如何配置 Google 移动广告 Unity 插件，以使用适用于 Android 的 GMA 新一代 SDK。

前提条件

在继续操作之前，请先完成以下事项：

  • 安装 Google 移动广告 Unity 插件 10.6.0 版或更高版本。

  • 使用 Unity 6.0 或更高版本。

  • 完成入门指南的学习。

  • 准备一个 Unity 项目。

将最低 API 级别更新为 24

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

  1. 在菜单栏中，依次点击 File（文件）> Build Profiles（build 配置文件）> Player Settings（玩家设置）> Android > Other Settings（其他设置）> Identification（身份）。
  2. 将 Minimum API Level（最低 API 级别）设置为 Android 7.0 'Nougat' (API Level 24)（Android 7.0 'Nougat' [API 级别 24]）或更高级别。

修改依赖项文件

如需为 Android build 启用 GMA 新一代 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:0.21.0-beta01">
  <repositories>
    <repository>https://maven.google.com/</repository>
  </repositories>
</androidPackage>

  4. 保存文件。

在构建过程中，Google 移动广告 Unity 插件会检测到 GMA 新一代 SDK 的存在，并转而使用该 SDK。

查看完整示例

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

<dependencies>
  <androidPackages>
    <androidPackage spec="com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01">
      <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>