Untuk menerapkan peningkatan stabilitas dan latensi Android, gunakan GMA Next-Gen SDK. Panduan ini membahas cara mengonfigurasi Google Mobile Ads Flutter Plugin untuk menggunakan GMA Next-Gen SDK untuk Android.
Prasyarat
Sebelum Anda melanjutkan, lakukan hal berikut:
- Instal Google Mobile Ads Flutter Plugin versi 9.0.0 atau yang lebih baru.
- Siapkan Google Mobile Ads Flutter Plugin.
- Memiliki project Flutter.
Mengonfigurasi setelan Android Gradle
Untuk menggunakan GMA Next-Gen SDK di Android, Anda harus mengupdate konfigurasi Gradle:
- Tetapkan level API Android minimum dan kompilasi.
- Jika Anda menggunakan mediasi, ikuti langkah-langkah migrasi untuk
mengecualikan modul
com.google.android.gmsguna menghindari error class duplikat.
Menjalankan dengan deklarasi lingkungan
Untuk menggunakan GMA Next-Gen SDK saat membangun dan menjalankan aplikasi Android Anda,
Anda harus memberikan set deklarasi lingkungan USE_NEXT_GEN_SDK yang ditetapkan ke nilai
true.
Setiap kali Anda mem-build atau menjalankan aplikasi, jalankan perintah berikut:
flutter run --dart-define USE_NEXT_GEN_SDK=true
Menjalankan dengan konfigurasi IDE
Jika menjalankan aplikasi menggunakan Lingkungan Pengembangan Terintegrasi (IDE), Anda dapat mengonfigurasi deklarasi lingkungan dalam konfigurasi peluncuran, bukan meneruskan tanda menggunakan command line.
Misalnya, Anda dapat menentukan variabel ini dalam file JSON dan menambahkannya ke penyiapan IDE. Untuk mengetahui detailnya, lihat menentukan deklarasi lingkungan.
Memperbarui template iklan native
Jika Anda menggunakan template iklan native, lakukan pembaruan berikut untuk mendukung GMA Next-Gen SDK:
Memperbarui impor paket NativeAdFactory
Untuk Android, perbarui pernyataan impor untuk class NativeAdFactory:
Java
// Replace this import:
import io.flutter.plugins.googlemobileads.GoogleMobileAdsPlugin.NativeAdFactory;
// With this import:
import io.flutter.plugins.googlemobileads.NativeAdFactory;
Kotlin
// Replace this import:
import io.flutter.plugins.googlemobileads.GoogleMobileAdsPlugin.NativeAdFactory
// With this import:
import io.flutter.plugins.googlemobileads.NativeAdFactory
Memperbarui tampilan XML tata letak penayangan iklan native
Dalam file XML tata letak untuk iklan native, perbarui class tampilan iklan native:
<!-- Replace this element: -->
<com.google.android.gms.ads.nativead.NativeAdView ... />
<!-- With this element: -->
<com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView ... />
Mengonfigurasi dependensi untuk kedua penyiapan
Jika project Anda harus mendukung Google Mobile Ads SDK dan
GMA Next-Gen SDK, Anda dapat mengonfigurasi file android/app/build.gradle
untuk menentukan dependensi secara bersyarat berdasarkan deklarasi lingkungan.
Google Mobile Ads Flutter Plugin menyediakan contoh konfigurasi dalam
file build.gradle aplikasi contoh.