Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari maio menggunakan mediasi, yang mencakup integrasi waterfall. Panduan ini mencakup cara menambahkan maio ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan SDK dan adaptor maio ke dalam aplikasi Flutter.
Antarmuka dasbor untuk maio menggunakan teks Jepang untuk label, tombol, dan deskripsinya, dan screenshot dalam panduan ini belum diterjemahkan. Namun, dalam deskripsi dan petunjuk di sini, label dan tombol disebut dengan padanannya dalam bahasa Inggris. "URL スキーム", misalnya, adalah "URL Scheme".
Integrasi dan format iklan yang didukung
Adaptor mediasi untuk maio memiliki kemampuan berikut:
| Integrasi | |
|---|---|
| Bidding | |
| Air Terjun | |
| Format | |
| Banner | |
| Interstisial | |
| Reward | |
| Native | |
Persyaratan
- Google Mobile Ads SDK terbaru
- Flutter 3.7.0 atau yang lebih tinggi
- Untuk men-deploy di Android
- Level API Android 23 atau yang lebih tinggi
- Untuk men-deploy di iOS
- Target deployment iOS 12.0 atau yang lebih tinggi
- Project Flutter yang berfungsi dan dikonfigurasi dengan Google Mobile Ads SDK. Lihat Mulai untuk mengetahui detailnya.
- Selesaikan Panduan memulai mediasi
Langkah 1: Siapkan konfigurasi di UI maio
Pertama, daftar atau login ke akun maio Anda. Klik tombol Pengelolaan aplikasi di sidebar kiri, lalu klik Aplikasi baru.
Pilih tab yang sesuai dengan Jenis Iklan yang Anda inginkan.
Interstisial
Masukkan Nama aplikasi Anda, pilih platform, dan berikan URL Aplikasi Anda. Pilih Interstisial video sebagai Jenis Iklan, lalu klik Perbarui.
Android
iOS
Reward
Masukkan Nama aplikasi Anda, pilih platform, dan berikan URL Aplikasi Anda. Pilih Reward Video sebagai Jenis Iklan, lalu klik Perbarui.
Android
iOS
Di halaman Application Management, catat Media ID. ID ini diperlukan untuk menyiapkan unit iklan AdMob di bagian berikutnya.
Android
iOS
Di halaman Zone Management, catat Zone ID. ID ini juga diperlukan untuk menyiapkan unit iklan AdMob di bagian berikutnya.
Android
iOS
Langkah 2: Siapkan permintaan maio di UI AdMob
Mengonfigurasi setelan mediasi untuk unit iklan
Android
Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk Android.
iOS
Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk iOS.
Langkah 3: Impor SDK dan adaptor maio
Integrasi melalui pub.dev
Tambahkan dependensi berikut dengan versi terbaru SDK dan adaptor maio di file pubspec.yaml paket Anda:
dependencies:
gma_mediation_maio: ^
Integrasi Manual
Download plugin mediasi Google Mobile Ads versi terbaru untuk
maio,
ekstrak file yang didownload, dan tambahkan folder plugin yang diekstrak
(dan isinya) ke project Flutter Anda. Kemudian, referensikan plugin di file
pubspec.yaml dengan menambahkan dependensi berikut:
dependencies:
gma_mediation_maio:
path: path/to/local/package
Langkah 4: Tambahkan kode yang diperlukan
Android
Tidak ada kode tambahan yang diperlukan untuk integrasi MAIO.
iOS
Integrasi SKAdNetwork
Ikuti dokumentasi maio
untuk menambahkan ID SKAdNetwork ke file Info.plist project Anda.
Langkah 5: Uji penerapan Anda
Mengaktifkan iklan percobaan
Pastikan Anda mendaftarkan perangkat pengujian untuk AdMob.
Penayang yang menggunakan Google Mobile Ads SDK versi 7.26.0 atau yang lebih tinggi akan otomatis menerima iklan percobaan dari maio di ponsel dan tablet yang terdaftar sebagai perangkat pengujian saat membuat permintaan.
Memverifikasi iklan percobaan
Untuk memverifikasi bahwa Anda menerima iklan percobaan dari maio, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan sumber iklan maio (Waterfall).
Kode error
Jika adaptor gagal menerima iklan dari maio, penayang dapat memeriksa
error yang mendasarinya dari respons iklan menggunakan
ResponseInfo di bawah
class berikut:
Android
| Format | Nama kelas |
|---|---|
| Interstisial | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
| Reward | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
iOS
| Format | Nama kelas |
|---|---|
| Interstisial | GADMMaioInterstitialAdapter |
| Reward | GADMMaioRewardedAdapter |
Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh adaptor MAIO saat iklan gagal dimuat:
Android
| Kode error | Alasan |
|---|---|
| 0-10 | maio menampilkan error khusus SDK. Lihat kode dan dokumentasi maio untuk mengetahui detail selengkapnya. |
| 101 | Maio tidak memiliki iklan yang tersedia. |
| 102 | Parameter server tidak valid (misalnya, ID Penempatan tidak ada). |
| 103 | Konteks yang digunakan untuk memuat iklan bukan instance `Activity`. |
iOS
| Kode error | Alasan |
|---|---|
| 0-10 | maio menampilkan error khusus SDK. Lihat kode maio untuk mengetahui detail selengkapnya. |
| 101 | maio belum memiliki iklan yang tersedia. |
| 102 | Parameter server tidak valid (misalnya, ID Penempatan tidak ada). |
| 103 | Adaptor maio tidak mendukung format iklan yang diminta. |
| 104 | Iklan sudah dimuat untuk konfigurasi jaringan ini. |
Log Perubahan Adaptor Mediasi Flutter maio
Versi 1.0.3
- Mendukung maio Android adapter versi 2.0.5.0.
- Mendukung maio iOS adapter versi 2.1.6.1.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.
Versi 1.0.2
- Mendukung maio Android adapter versi 2.0.4.0.
- Mendukung maio iOS adapter versi 2.1.6.1.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.
Versi 1.0.1
- Mendukung adaptor Android maio versi 2.0.3.1.
- Mendukung maio iOS adapter versi 2.1.6.1.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.
Versi 1.0.0
- Rilis awal.
- Mendukung adaptor Android maio versi 2.0.3.0.
- Mendukung maio iOS adapter versi 2.1.6.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.3.1.