Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari Pangle menggunakan mediasi, yang mencakup integrasi waterfall dan bidding . Panduan ini membahas cara menambahkan Pangle ke konfigurasi mediasi unit iklan dan cara mengintegrasikan SDK dan adaptor Pangle ke dalam aplikasi Unity .
Integrasi dan format iklan yang didukung
Adaptor mediasi AdMob untuk Pangle memiliki kemampuan berikut:
| Integrasi | |
|---|---|
| Bidding | |
| Air Terjun | |
| Format | |
| Banner | |
| Interstisial | |
| Reward | |
| Interstisial Reward | |
Persyaratan
- Google Mobile Ads SDK terbaru
- Unity 5.6 atau yang lebih tinggi
- [Untuk bidding]: Untuk mengintegrasikan semua format iklan yang didukung dalam bidding, gunakan plugin mediasi Google Mobile Ads untuk Pangle 2.4.0 atau yang lebih tinggi (versi terbaru direkomendasikan)
- 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 Unity 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 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.
Langkah 3: Impor SDK dan adaptor Pangle
OpenUPM-CLI
Jika telah menginstal OpenUPM-CLI, Anda dapat menginstal Plugin Mediasi Pangle Google Mobile Ads untuk Unity ke project dengan menjalankan perintah berikut dari direktori utama project:
openupm add com.google.ads.mobile.mediation.pangle
OpenUPM
Di editor project Unity, pilih Edit > Project Settings > Package Manager untuk membuka Unity Package Manager Settings.
Di tab Scoped Registries, tambahkan OpenUPM sebagai registry terbatas dengan detail berikut:
- Nama:
OpenUPM - URL:
https://package.openupm.com - Cakupan:
com.google
Kemudian, buka Window > Package Manager untuk membuka Unity Package Manager dan pilih My Registries dari menu drop-down.
Pilih paket Google Mobile Ads Pangle Mediation, lalu klik Install.
Paket Unity
Download plugin mediasi Google Mobile Ads versi terbaru untuk Pangle dari link download di Log Perubahan dan ekstrak GoogleMobileAdsPangleMediation.unitypackage dari file zip.
Di editor project Unity, pilih Assets > Import Package >
Custom Package, lalu temukan
file
GoogleMobileAdsPangleMediation.unitypackage yang telah Anda download. Pastikan semua file dipilih, lalu klik
Import.
Kemudian, pilih Assets > External Dependency Manager >
Android Resolver > Force Resolve. Library External Dependency Manager
akan melakukan resolusi dependensi dari awal dan menyalin
dependensi yang dideklarasikan ke direktori Assets/Plugins/Android
aplikasi Unity Anda.
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 percobaan
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 Plugin Mediasi Unity Pangle
Versi 4.4.1
- Mendukung adaptor Android Pangle versi 6.3.0.4.0.
- Mendukung Adaptor iOS Pangle versi 6.3.0.8.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.3.0.
Versi 4.4.0
- Mendukung Adaptor Android Pangle versi 6.3.0.2.0.
- Mendukung Adaptor iOS Pangle versi 6.3.0.6.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.3.0.
Versi 4.3.3
- Mendukung adaptor Android Pangle versi 6.2.0.7.0.
- Mendukung adaptor iOS Pangle versi 6.2.0.9.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.2.1.
Versi 4.3.2
- Mendukung Adaptor Android Pangle versi 6.2.0.6.0.
- Mendukung Adaptor iOS Pangle versi 6.2.0.8.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.2.0.
Versi 4.3.1
- Mendukung Adaptor Android Pangle versi 6.2.0.5.0.
- Mendukung Adaptor iOS Pangle versi 6.2.0.7.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.2.0.
Versi 4.3.0
- Mendukung adaptor Android Pangle versi 6.2.0.4.0.
- Mendukung Adaptor iOS Pangle versi 6.2.0.5.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.2.0.
Versi 4.2.1
- Mendukung adaptor Android Pangle versi 6.1.0.7.0.
- Mendukung adaptor iOS Pangle versi 6.1.0.6.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.2.0.
Versi 4.2.0
- Mengganti nama
DummyClientmenjadiPlaceholderClient. - Mendukung Adaptor Android Pangle versi 6.1.0.6.0.
- Mendukung Adaptor iOS Pangle versi 6.1.0.5.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.2.0.
Versi 4.1.0
- Mendukung Adaptor Android Pangle versi 6.0.0.8.0.
- Mendukung Adaptor iOS Pangle versi 6.1.0.5.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.1.1.
Versi 4.0.1
- Mendukung adaptor Android Pangle versi 6.0.0.5.0.
- Mendukung Adaptor iOS Pangle versi 6.0.0.6.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.1.0.
Versi 4.0.0
- Mendukung adaptor Android Pangle versi 6.0.0.5.0.
- Mendukung Adaptor iOS Pangle versi 6.0.0.5.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.1.0.
Versi 3.0.0
- Mendukung Adaptor Android Pangle versi 6.0.0.3.0.
- Mendukung Adaptor iOS Pangle versi 5.9.0.9.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.1.0.
Versi 2.8.1
- Mendukung Adaptor Android Pangle versi 5.9.0.6.0.
- Mendukung Adaptor iOS Pangle versi 5.9.0.8.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.1.0.
Versi 2.8.0
- Mendukung Adaptor Android Pangle versi 5.9.0.4.0.
- Mendukung Adaptor iOS Pangle versi 5.9.0.7.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.1.0.
Versi 2.7.0
- Mendukung Adaptor Android Pangle versi 5.9.0.2.0.
- Mendukung Adaptor iOS Pangle versi 5.8.0.8.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.1.0.
Versi 2.6.0
- Mendukung Adaptor Android Pangle versi 5.8.0.9.0.
- Mendukung Adaptor iOS Pangle versi 5.8.0.8.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 9.0.0.
Versi 2.5.0
- Mendukung Adaptor Android Pangle versi 5.7.0.1.0.
- Mendukung Adaptor iOS Pangle versi 5.7.0.7.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 8.6.0.
Versi 2.4.0
- Mendukung Adaptor Android Pangle versi 5.5.0.9.0.
- Mendukung Adaptor iOS Pangle versi 5.5.0.9.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 8.6.0.
Versi 2.3.0
- Mendukung Adaptor Android Pangle versi 5.3.0.6.0.
- Mendukung Adaptor iOS Pangle versi 5.3.1.2.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 8.4.1.
Versi 2.2.0
- Mendukung Adaptor Android Pangle versi 5.2.0.6.0.
- Mendukung Adaptor iOS Pangle versi 5.2.0.9.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 8.3.0.
Versi 2.1.0
- Mendukung Adaptor Android Pangle versi 5.1.0.9.0.
- Mendukung Adaptor iOS Pangle versi 5.1.1.0.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 8.1.0.
Versi 2.0.0
- Memindahkan konten adaptor ke
GoogleMobileAds/Mediation/Pangle/. - Memfaktorkan ulang namespace adaptor untuk menggunakan
GoogleMobileAds.Mediation.Pangle. - Mendukung Adaptor Android Pangle versi 5.0.0.7.0.
- Mendukung Adaptor iOS Pangle versi 5.0.0.6.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 7.4.1.
Versi 1.5.1
- Mendukung Adaptor Android Pangle versi 4.9.0.7.0.
- Mendukung Adaptor iOS Pangle versi 4.9.0.8.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 7.4.0.
Versi 1.5.0
- Mendukung Adaptor Android Pangle versi 4.9.0.6.0.
- Mendukung Adaptor iOS Pangle versi 4.9.0.7.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 7.3.1.
Versi 1.4.0
- Mendukung adaptor Android Pangle versi 4.8.1.0.0.
- Mendukung Adaptor iOS Pangle versi 4.8.1.0.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 7.3.1.
Versi 1.3.1
- Mendukung adaptor Android Pangle versi 4.7.0.6.0.
- Mendukung Adaptor iOS Pangle versi 4.7.0.6.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 7.2.0.
Versi 1.3.0
- Mengganti nama metode berikut di class
Pangle:SetGDPR()->SetGDPRConsent()SetCCPA()->SetDoNotSell()
- Mendukung adaptor Android Pangle versi 4.7.0.5.0.
- Mendukung Adaptor iOS Pangle versi 4.7.0.5.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 7.2.0.
Versi 1.2.0
- Mendukung Adaptor Android Pangle versi 4.5.0.6.1.
- Mendukung Adaptor iOS Pangle versi 4.5.2.8.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 7.1.0.
Versi 1.1.0
- Mendukung adaptor Android Pangle versi 4.5.0.3.0.
- Mendukung Adaptor iOS Pangle versi 4.5.1.3.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 7.0.2.
Versi 1.0.0
- Rilis awal!
- Mendukung adaptor Android Pangle versi 4.3.0.8.0.
- Mendukung Adaptor iOS Pangle versi 4.3.0.5.0.
- Di-build dan diuji dengan Plugin Google Mobile Ads Unity versi 7.0.0.