Panduan ini menunjukkan cara menggunakan Google Mobile Ads Flutter Plugin untuk memuat dan menampilkan iklan dari Moloco menggunakan mediasi, yang mencakup integrasi bidding. Panduan ini mencakup cara menambahkan Moloco ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan Moloco SDK dan adaptor ke dalam aplikasi Flutter.
Integrasi dan format iklan yang didukung
Adaptor mediasi Ad Manager untuk Moloco memiliki kemampuan berikut:
| Integrasi | |
|---|---|
| Bidding | |
| Air Terjun | |
| Format | |
| Membuka Aplikasi | |
| Banner | |
| Interstisial | |
| Reward | |
| Interstisial Reward | |
| Native | |
Persyaratan
- Terbaru Google Mobile Ads Flutter Plugin
- Flutter 3.7.0 atau yang lebih baru
- Untuk men-deploy di Android
- Android API level 23 atau yang lebih baru
- Untuk men-deploy di iOS
- Target deployment iOS 13.0 atau yang lebih baru
- Project Flutter yang berfungsi dan dikonfigurasi dengan Google Mobile Ads Flutter Plugin. Lihat Menyiapkan Google Mobile Ads Flutter Plugin untuk mengetahui detailnya.
- Menyiapkan mediasi
Langkah 1: Menyiapkan konfigurasi di UI Moloco
Login ke Portal Penayang Moloco.
Buka tab Overview > Apps, lalu klik tombol Add App untuk membuat aplikasi baru.
Pilih OS dan Privacy Settings untuk aplikasi Anda, isi bagian formulir lainnya, lalu klik Create.
Android
iOS
Setelah aplikasi dibuat, pilih aplikasi tersebut dari tab Apps untuk melihat detailnya dan catat App Key.
Android
iOS
Buka tab Overview > Ad Units, pilih aplikasi dari menu drop-down, lalu klik New Ad Unit.
Pilih In-app bidding sebagai Auction method dan isi bagian formulir lainnya. Kemudian, klik Create.
Buka unit iklan yang baru dibuat di tab Ad Units untuk melihat detailnya. Catat Ad Unit ID.
Langkah 2: Menyiapkan permintaan Moloco di UI Ad Manager
Mengonfigurasi setelan mediasi untuk unit iklan
Android
Untuk mengetahui petunjuknya, lihat langkah 2 di panduan untuk Android.
iOS
Untuk mengetahui petunjuknya, lihat langkah 2 di panduan untuk iOS.
Menambahkan Moloco Ads ke daftar partner iklan GDPR dan peraturan negara bagian Amerika Serikat
Ikuti langkah-langkah di Setelan peraturan Eropa dan Setelan peraturan negara bagian Amerika Serikat untuk menambahkan Moloco Ads ke daftar partner iklan peraturan Eropa dan negara bagian Amerika Serikat di UI Ad Manager.
Langkah 3: Mengimpor Moloco SDK dan adaptor
Integrasi melalui pub.dev
Tambahkan dependensi berikut dengan versi terbaru Moloco Ads SDK SDK dan adaptor di file pubspec.yaml paket Anda:
dependencies:
gma_mediation_moloco: ^3.4.0
Integrasi Manual
Download plugin mediasi Google Mobile Ads versi terbaru untuk
Moloco Ads SDK,
ekstrak file yang didownload, dan tambahkan folder plugin yang diekstrak
(dan kontennya) ke project Flutter Anda. Kemudian, referensikan plugin di file pubspec.yaml dengan menambahkan dependensi berikut:
dependencies:
gma_mediation_moloco:
path: path/to/local/package
Langkah 4: Menambahkan kode yang diperlukan
Tidak ada kode tambahan yang diperlukan untuk integrasi Moloco.
Langkah 5: Menguji penerapan Anda
Mengaktifkan iklan percobaan
Pastikan Anda mendaftarkan perangkat pengujian untuk Ad Manager.
Memverifikasi iklan percobaan
Untuk memverifikasi bahwa Anda menerima iklan percobaan dari Moloco Ads SDK, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan sumber iklan Moloco (Bidding).
Kode error
Jika adaptor gagal menerima iklan dari Moloco, penayang dapat memeriksa
error yang mendasarinya dari respons iklan menggunakan
ResponseInfo di bawah class berikut:
Android
com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter
iOS
MolocoSDK.MolocoError
GADMediationAdapterMoloco
Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh adaptor Moloco saat iklan gagal dimuat:
Android
| Kode error | Domain | Alasan |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | Moloco App Key tidak ada atau tidak valid. |
| 102 | com.google.ads.mediation.moloco | Moloco Ad unit ID tidak ada atau tidak valid. |
| 103 | com.google.ads.mediation.moloco | Objek iklan Moloco yang ditampilkan adalah null. |
| -1 hingga 5000 | com.moloco.sdk | Moloco SDK menampilkan error. Lihat dokumentasi Moloco untuk mengetahui detail selengkapnya. |
iOS
| Kode error | Domain | Alasan |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | Moloco SDK tidak mendukung penayangan iklan di iOS 12 dan yang lebih lama. |
| 102 | com.google.ads.mediation.moloco | Moloco App Key tidak ada atau tidak valid. |
| 103 | com.google.ads.mediation.moloco | Moloco Ad unit ID tidak ada atau tidak valid. |
| 104 | com.google.ads.mediation.moloco | Iklan belum siap ditampilkan. |
| 105 | com.google.ads.mediation.moloco | Iklan gagal ditampilkan. |
| 106 | com.google.ads.mediation.moloco | Data rendering tidak tersedia untuk merender iklan. |
| -1 hingga 5000 | Dikirim oleh Moloco SDK | Moloco SDK menampilkan error. Lihat dokumentasi Moloco untuk mengetahui detail selengkapnya. |
Verifikasi sisi server reward
Jika Anda
Memvalidasi callback verifikasi sisi server (SSV),
ID sumber iklan untuk Moloco adalah 8267622065755668722.
Log Perubahan Adaptor Mediasi Flutter Moloco
Versi 3.4.0
- Memperbarui versi Flutter minimum ke 3.38.1
- Diperbarui untuk mendukung Plugin Flutter Google Mobile Ads versi 8.0.0
- Mendukung adaptor Android Moloco versi 4.7.0.0.
- Mendukung adaptor iOS Moloco versi 4.5.1.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 8.0.0.
Versi 3.3.0
- Mendukung adaptor Android Moloco versi 4.5.0.0.
- Mendukung adaptor iOS Moloco versi 4.3.0.2.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 7.0.0.
Versi 3.2.0
- Mendukung adaptor Android Moloco versi 4.4.0.0.
- Mendukung adaptor iOS Moloco versi 4.2.0.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 7.0.0.
Versi 3.1.0
- Memperbarui versi Flutter minimum ke 3.35.1
- Mendukung adaptor Android Moloco versi 4.4.0.0.
- Mendukung adaptor iOS Moloco versi 4.1.2.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 7.0.0.
Versi 3.0.0
- Mendukung adaptor Android Moloco versi 4.3.1.0.
- Mendukung adaptor iOS Moloco versi 4.1.0.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.
Versi 2.1.0
- Mendukung adaptor Android Moloco versi 4.2.0.0.
- Mendukung adaptor iOS Moloco versi 3.13.0.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.
Versi 2.0.0
- Mendukung adaptor Android Moloco versi 4.0.0.0.
- Mendukung adaptor iOS Moloco versi 3.13.0.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.
Versi 1.6.0
- Mendukung adaptor Android Moloco versi 3.12.0.0.
- Mendukung adaptor iOS Moloco versi 3.12.0.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.
Versi 1.5.0
- Mendukung adaptor Android Moloco versi 3.11.0.0.
- Mendukung adaptor iOS Moloco versi 3.11.0.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.
Versi 1.4.0
- Mendukung adaptor Android Moloco versi 3.10.0.0.
- Mendukung adaptor iOS Moloco versi 3.10.0.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.
Versi 1.3.1
- Mendukung adaptor Android Moloco versi 3.9.0.0.
- Mendukung adaptor iOS Moloco versi 3.9.1.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.
Versi 1.3.0
- Mendukung adaptor Android Moloco versi 3.9.0.0.
- Mendukung adaptor iOS Moloco versi 3.9.0.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.
Versi 1.2.0
- Mendukung adaptor Android Moloco versi 3.8.0.1.
- Mendukung adaptor iOS Moloco versi 3.8.0.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.
Versi 1.1.0
- Mendukung adaptor Android Moloco versi 3.7.0.0.
- Mendukung adaptor iOS Moloco versi 3.6.0.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.3.1.
Versi 1.0.0
- Rilis awal.
- Mendukung adaptor Android Moloco versi 3.6.1.0.
- Mendukung adaptor iOS Moloco versi 3.6.0.0.
- Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.3.1.