Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari Mintegral menggunakan mediasi, yang mencakup integrasi waterfall dan bidding. Panduan ini membahas cara menambahkan Mintegral ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan SDK Mintegral dan adaptor ke dalam Flutter aplikasi.
Integrasi dan format iklan yang didukung
Adaptor mediasi AdMob untuk Mintegral memiliki kemampuan berikut:
| Integrasi | |
|---|---|
| Bidding | |
| Air Terjun | |
| Format | |
| Membuka Aplikasi | 1 |
| Banner | |
| Interstisial | |
| Reward | |
| Interstisial Reward | |
| Native | 2 |
1 Bidding dan waterfall integrasi untuk format iklan di layar pembuka aplikasi masih dalam versi beta tertutup.
2 Bidding dan waterfall integrasi untuk format iklan native masih dalam versi beta terbuka.
Persyaratan
- Google Mobile Ads SDK terbaru
- Flutter 3.7.0 atau yang lebih baru
- Untuk men-deploy di Android
- Android API level 21 atau yang lebih tinggi
- Untuk men-deploy di iOS
- Target deployment iOS 12.0 atau versi yang lebih tinggi
- Project Flutter yang berfungsi yang dikonfigurasi dengan Google Mobile Ads SDK. Lihat Mulai untuk mengetahui detailnya.
- Selesaikan mediasi Panduan memulai
Langkah 1: Siapkan konfigurasi di UI Mintegral
Daftar atau Login ke akun Mintegral Anda.
Menemukan Kunci Aplikasi
Buka tab Setelan APLIKASI dan catat Kunci APLIKASI.
Tambahkan aplikasi baru
Dari tab Setelan APLIKASI, klik tombol Tambahkan APLIKASI.
Pilih Platform dan isi formulir lainnya. Lalu, klik Simpan.
Android
iOS
Catat ID APLIKASI untuk aplikasi Anda.
Android
iOS
Membuat penempatan iklan
Setelah aplikasi dibuat, buka tab Penempatan & Unit, lalu klik tombol Tambahkan Penempatan seperti yang ditunjukkan di bawah untuk membuat penempatan iklan Anda.
Android
iOS
Masukkan Nama Penempatan dan Format Iklan.
Bidding
Pilih Bidding Header sebagai Jenis Bidding. Isi semua bagian formulir, lalu klik Simpan.
Waterfall
Pilih Tradisional sebagai Jenis Bidding. Isi semua bagian formulir, lalu klik Simpan.
Setelah penempatan iklan dibuat, catat ID Penempatan.
Android
iOS
Klik drop-down 1 Unit IKLAN dan catat ID Unit IKLAN.
Android
iOS
Menemukan Kunci Mintegral Reporting API
Bidding
Langkah ini tidak diperlukan untuk integrasi bidding.
Waterfall
Anda memerlukan Kunci Mintegral Reporting API untuk menyiapkan AdMob ID unit iklan. Buka Account > API Tools. Catat Skey dan Secret Anda.
Langkah 2: Siapkan permintaan Mintegral di AdMob UI
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.
Tambahkan Mintegral ke daftar partner iklan peraturan negara bagian Amerika Serikat dan GDPR
Ikuti langkah-langkah di Setelan GDPR dan Setelan peraturan negara bagian AS untuk menambahkan Mintegral ke daftar partner iklan peraturan negara bagian AS dan GDPR di UI AdMob .
Langkah 3: Impor Mintegral SDK dan adaptor
Integrasi melalui pub.dev
Tambahkan dependensi berikut dengan versi terbaru
Mintegral SDK dan adaptor dalam paket
File pubspec.yaml:
dependencies:
gma_mediation_mintegral: ^1.0.0
Integrasi Manual
Download versi terbaru plugin mediasi Google Mobile Ads untuk
Mintegral,
ekstrak file yang didownload, dan tambahkan folder plugin yang diekstrak
(dan isinya) ke project Flutter Anda. Kemudian, rujuk plugin di
pubspec.yaml dengan menambahkan dependensi berikut:
dependencies:
gma_mediation_mintegral:
path: path/to/local/package
Langkah 4: Tambahkan kode yang diperlukan
Android
Tidak ada kode tambahan yang diperlukan untuk integrasi Mintegral.
iOS
Integrasi SKAdNetwork
Ikuti dokumentasi Mintegral
untuk menambahkan ID SKAdNetwork ke file Info.plist project Anda.
Langkah 5: Uji penerapan
Aktifkan iklan percobaan
Pastikan Anda mendaftarkan perangkat pengujian Anda untuk AdMob
Guna mendapatkan iklan percobaan Mintegral untuk format iklan banner, interstisial, reward, dan native, Mintegral merekomendasikan penggunaan Kunci Aplikasi, ID Aplikasi, ID Penempatan, dan ID Unit Iklan yang diberikan di Halaman ID Pengujian Mintegral.
Memverifikasi iklan percobaan
Untuk memverifikasi bahwa Anda menerima iklan pengujian dari Mintegral, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan Mintegral (Bidding) and Mintegral (Waterfall) sumber iklan.
Kode error
Jika adaptor gagal menerima iklan dari Mintegral, penayang dapat memeriksa
error yang mendasar dari respons iklan dengan menggunakan
ResponseInfo dalam class berikut:
Android
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
iOS
GADMediationAdapterMintegral
Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh adaptor Mintegral saat iklan gagal dimuat:
Android
| Kode error | Domain | Alasan |
|---|---|---|
| 101 | com.google.ads.mediation.mintegral | Parameter server tidak valid (misalnya, ID aplikasi atau ID penempatan tidak ada). |
| 102 | com.google.ads.mediation.mintegral | Ukuran iklan yang diminta tidak cocok dengan ukuran spanduk yang didukung Mintegral. |
| 103 | com.google.ads.mediation.mintegral | Respons bid tidak ada atau tidak valid. |
| 104 | com.google.ads.mediation.mintegral | Mintegral SDK menampilkan error tidak ada pengisian. |
iOS
| Kode error | Domain | Alasan |
|---|---|---|
| 101 | com.google.mediation.mintegral | Parameter server tidak valid (misalnya, ID aplikasi atau ID penempatan tidak ada). |
| 102 | com.google.mediation.mintegral | Mintegral SDK menampilkan error tidak ada pengisian. |
| 103 | com.google.mediation.mintegral | Mintegral SDK gagal menampilkan iklan. |
| 104 | com.google.mediation.mintegral | Ukuran iklan yang diminta tidak cocok dengan ukuran spanduk yang didukung Mintegral. |
Log Perubahan Adaptor Mediasi Flutter Mintegral
1.0.0
- Rilis awal.
- Kompatibilitas yang diverifikasi dengan adaptor Android Mintegral versi 16.7.21.0.
- Kompatibilitas yang diverifikasi dengan adaptor Mintegral iOS versi 7.6.3.0.
- Dibangun dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.1.0.