Menginstal GMA Next-Gen SDK

Untuk menerapkan peningkatan latensi dan stabilitas Android, gunakan GMA Next-Gen SDK. Panduan ini membahas cara mengonfigurasi Google Mobile Ads Unity Plugin untuk menggunakan GMA Next-Gen SDK untuk Android.

Prasyarat

Sebelum melanjutkan, lakukan hal berikut:

  • Instal Google Mobile Ads Unity Plugin versi 10.6.0 atau yang lebih tinggi.
  • Gunakan Unity versi 2019.4 atau yang lebih tinggi.
  • Siapkan Google Mobile Ads Unity Plugin.
  • Memiliki project Unity.

Mengupdate level API minimum ke 24

GMA Next-Gen SDK memerlukan level API minimum 24. Untuk mengupdate level API minimum, lakukan hal berikut:

  1. Dari panel menu, klik File > Build Profiles > Player Settings > Android > Other Settings > Identification.
  2. Tetapkan Minimum API Level ke Android 7.0 'Nougat' (API Level 24) atau yang lebih tinggi.

Mengubah file dependensi

Untuk mengaktifkan GMA Next-Gen SDK untuk build Android Anda, lakukan hal berikut:

  1. Di project Unity Anda, buka file Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml.

    • Jika Anda menggunakan Unity Package Manager, buka Packages > Google Mobile Ads for Unity > GoogleMobileAds > Editor > GoogleMobileAdsDependencies.xml.

  2. Temukan elemen <androidPackage> dengan spesifikasi com.google.android.gms:play-services-ads.

  3. Ganti elemen dengan versi terbaru com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk yang tersedia:

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

  4. Simpan file.

Selama proses build, Google Mobile Ads Unity Plugin mendeteksi keberadaan GMA Next-Gen SDK dan menggunakan implementasi Anda.

Integrasi mediasi

Jika Anda menggunakan mediasi, ikuti panduan migrasi Android untuk mengecualikan modul com.google.android.gms dalam integrasi mediasi Anda guna menghindari error class duplikat.

Melihat contoh lengkap

Contoh berikut menunjukkan file GoogleMobileAdsDependencies.xml yang telah diupdate:

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