Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari Pangle menggunakan mediasi, yang mencakup integrasi bidding . Panduan ini membahas cara menambahkan Pangle ke konfigurasi mediasi unit iklan dan cara mengintegrasikan SDK dan adaptor Pangle ke dalam aplikasi Flutter .
Integrasi dan format iklan yang didukung
Adaptor mediasi Ad Manager untuk Pangle memiliki kemampuan berikut:
| Integrasi | |
|---|---|
| Bidding | |
| Air Terjun | 1 |
| Format | |
| Banner | |
| Interstisial | |
| Reward | |
| Interstisial Reward | |
| Native | |
Persyaratan
- Google Mobile Ads SDK terbaru
- Flutter 3.7.0 atau yang lebih tinggi
- Untuk men-deploy di Android
- Android API level 21 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 Memulai untuk mengetahui detailnya.
- Selesaikan Panduan memulai mediasi
Langkah 1: Siapkan konfigurasi di UI Pangle
Daftar atau Login ke akun Pangle Anda.
Menambahkan aplikasi baru
Buka tab Applications, lalu klik tombol Add App.
Pilih Sistem Operasi yang ingin Anda buat aplikasinya, lalu isi formulir lainnya. Kemudian, klik Kirim.
Android
iOS
Catat ID Aplikasi aplikasi Anda.
Android
iOS
Membuat penempatan iklan
Setelah aplikasi dibuat, klik tombol Tambahkan untuk membuat penempatan iklan.
Android
iOS
Bidding
Pilih Format Iklan dan Nama Penempatan Iklan, lalu pilih Bidding Dalam Aplikasi sebagai Jenis Harga. Isi bagian formulir lainnya, lalu klik Kirim.
Setelah penempatan iklan dibuat, catat ID Penempatan Iklan.
Android
iOS
Air Terjun
Pilih Format Iklan dan Nama Penempatan Iklan, serta CPM Global sebagai Jenis Harga. Isi bagian formulir lainnya, lalu klik Kirim.
Setelah penempatan iklan dibuat, catat ID Penempatan Iklan.
Android
iOS
Menemukan kunci Pangle Reporting API
Bidding
Langkah ini tidak diperlukan untuk integrasi bidding.
Air Terjun
Catat ID Pengguna di sudut kiri bawah halaman.
Klik Integrations > SDK & API > Pangle Reporting API 2.0. Catat ID Peran dan Kunci Keamanan.
Mengaktifkan mode pengujian
Ikuti petunjuk dalam panduan Cara menambahkan Iklan Uji Pangle tentang cara mengaktifkan iklan uji Pangle.
Langkah 2: Siapkan permintaan Pangle di Ad Manager 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.
Langkah 3: Impor SDK dan adaptor Pangle
Integrasi melalui pub.dev
(Khusus Android) Tambahkan repositori berikut ke file build.gradle di dalam
direktori android project Anda:
repositories {
google()
mavenCentral()
maven {
url = uri("https://artifact.bytedance.com/repository/pangle/")
}
}
Tambahkan dependensi berikut dengan versi terbaru
Pangle SDK dan adaptor dalam file
pubspec.yaml paket Anda:
dependencies:
gma_mediation_pangle: ^1.0.0
Integrasi Manual
Download plugin mediasi Google Mobile Ads versi terbaru untuk
Pangle,
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_pangle:
path: path/to/local/package
Langkah 4: Tambahkan kode yang diperlukan
Android
Tidak diperlukan kode tambahan untuk integrasi Pangle.
iOS
Integrasi SKAdNetwork
Ikuti dokumentasi Pangle
untuk menambahkan ID SKAdNetwork ke file Info.plist project Anda.
Langkah 5: Uji penerapan Anda
Mengaktifkan iklan pengujian
Pastikan Anda mendaftarkan perangkat pengujian untuk AdMob dan mengaktifkan mode pengujian di UI Pangle.
Memverifikasi iklan percobaan
Untuk memverifikasi bahwa Anda menerima iklan pengujian dari Pangle, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan sumber iklan Pangle (Bidding) dan Pangle (Waterfall).
Kode error
Jika adaptor gagal menerima iklan dari Pangle, penayang dapat memeriksa
error yang mendasarinya dari respons iklan menggunakan
ResponseInfo di bawah
class berikut:
Android
com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter
iOS
GADMediationAdapterPangle
Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh adaptor Pangle saat iklan gagal dimuat:
Android
| Kode error | Domain | Alasan |
|---|---|---|
| 101 | com.google.ads.mediation.pangle | Parameter server tidak valid (misalnya, ID aplikasi atau ID penempatan tidak ada). |
| 102 | com.google.ads.mediation.pangle | Ukuran iklan yang diminta tidak cocok dengan ukuran banner yang didukung Pangle. |
| 103 | com.google.ads.mediation.pangle | Respons bid tidak ada atau tidak valid. |
| -1-60000 | com.pangle.ads | Pangle SDK menampilkan error. Lihat dokumentasi Pangle untuk mengetahui detail selengkapnya. |
iOS
| Kode error | Domain | Alasan |
|---|---|---|
| 101 | com.google.ads.mediation.pangle | Parameter server tidak valid (misalnya, ID aplikasi atau ID penempatan tidak ada). |
| 102 | com.google.ads.mediation.pangle | Ukuran iklan yang diminta tidak cocok dengan ukuran banner yang didukung Pangle. |
| -1-60000 | Dikirim oleh Pangle SDK | Pangle SDK menampilkan error. Lihat dokumentasi Pangle untuk mengetahui detail selengkapnya. |
Log Perubahan Adaptor Mediasi Flutter Pangle
Versi Berikutnya
- Di-build dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.2.0.
2.0.0
- Kompatibilitas terverifikasi dengan adaptor Android Pangle versi 6.1.0.9.0.
- Kompatibilitas terverifikasi dengan adaptor iOS Pangle versi 6.2.0.5.0.
- Di-build dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.1.0.
1.1.0
- Kompatibilitas terverifikasi dengan adaptor Android Pangle versi 5.9.0.4.0.
- Kompatibilitas terverifikasi dengan adaptor iOS Pangle versi 5.9.0.7.0.
- Di-build dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.1.0.
1.0.0
- Rilis awal.
- Kompatibilitas terverifikasi dengan adaptor Android Pangle versi 5.8.0.9.0
- Kompatibilitas terverifikasi dengan adaptor iOS Pangle versi 5.8.0.8.0
- Di-build dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.0.0.