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 Anda melanjutkan, lakukan hal berikut:

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

Memperbarui level API minimum ke 24

GMA Next-Gen SDK memerlukan level API minimum 24. Untuk memperbarui 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.

Ubah file dependensi

11.1.0 dan yang lebih baru

Untuk mengaktifkan GMA Next-Gen SDK untuk build Android Anda, pilih Assets > Google Mobile Ads > Settings di Unity Editor:

Di dalam pemeriksa setelan GMA Next-Gen SDK, aktifkan Switch Google Mobile Ads Android Architecture dan GMA Next-Gen SDK.

11.0.0 - 10.6.0

Untuk mengaktifkan GMA Next-Gen SDK untuk build Android, ubah file dependensi:

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 com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk versi terbaru 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.

Peringatan: Mengupdate paket GMA Next-Gen SDK akan menimpa file dependensi Anda. Jika Anda mengupdate paket, ulangi langkah-langkah sebelumnya.

Contoh berikut menunjukkan file GoogleMobileAdsDependencies.xml yang diperbarui:

<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>

Integrasi mediasi

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