Untuk menerapkan peningkatan latensi dan stabilitas 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 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 memperbarui konfigurasi Gradle:
- Tetapkan level API Android minimum dan kompilasi.
- Jika Anda menggunakan mediasi, ikuti langkah-langkah migrasi untuk
mengecualikan
com.google.android.gmsmodul guna menghindari error class duplikat.
Menjalankan dengan deklarasi lingkungan
Untuk menggunakan GMA Next-Gen SDK saat mem-build dan menjalankan aplikasi Android,
Anda harus memberikan deklarasi lingkungan USE_NEXT_GEN_SDK yang ditetapkan ke
true nilai.
Setiap kali Anda mem-build atau menjalankan aplikasi, jalankan hal berikut:
flutter run --dart-define USE_NEXT_GEN_SDK=true
Menjalankan dengan konfigurasi IDE
Jika menjalankan aplikasi menggunakan Integrated Development Environment (IDE), Anda dapat mengonfigurasi deklarasi lingkungan dalam konfigurasi peluncuran, bukan meneruskan flag 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 tampilan 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 kedua Google Mobile Ads SDK (Legacy) dan
GMA Next-Gen SDK, Anda dapat mengonfigurasi android/app/build.gradle
file untuk menentukan dependensi secara kondisional berdasarkan deklarasi lingkungan.
Google Mobile Ads Flutter Plugin menyediakan contoh konfigurasi dalam
file build.gradle aplikasi contoh.