安裝 GMA Next-Gen 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)」以上版本。

修改依附元件檔案

如要為 Android 版本啟用 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:0.25.0-beta01">
      <repositories>
        <repository>https://maven.google.com/</repository>
      </repositories>
    </androidPackage>
    
  4. 儲存檔案。

在建構程序中,Google Mobile Ads Unity Plugin 會偵測 GMA Next-Gen SDK,並使用您的導入項目。

查看完整範例

以下範例是更新後的 GoogleMobileAdsDependencies.xml 檔案:

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