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 Pangle SDK serta adaptor ke dalam Unity aplikasi.
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 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 Unity yang berfungsi dan dikonfigurasi dengan Google Mobile Ads SDK. Lihat Memulai untuk mengetahui detailnya.
- Selesaikan mediasi Panduan memulai
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 Add untuk membuat penempatan iklan.
Android
iOS
Bidding
Pilih Format Iklan dan Nama Penempatan Iklan Anda, lalu pilih Bidding Dalam Aplikasi sebagai Jenis Penetapan 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 sisa formulir, lalu klik Submit.
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.
Pada tab Scoped Registries, tambahkan OpenUPM sebagai registry cakupan dengan detail berikut:
- Nama:
OpenUPM - URL:
https://package.openupm.com - Cakupan:
com.google
Lalu, 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 versi terbaru plugin mediasi Google Mobile Ads untuk Pangle dari link download di Changelog 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
Aktifkan iklan percobaan
Pastikan Anda mendaftarkan perangkat pengujian Anda untuk AdMob dan mengaktifkan mode pengujian di Pangle UI.
Memverifikasi iklan percobaan
Untuk memverifikasi bahwa Anda menerima iklan pengujian dari Pangle, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan Pangle (Bidding) and Pangle (Waterfall) sumber iklan.
Kode error
Jika adaptor gagal menerima iklan dari Pangle, penayang dapat memeriksa
error dasar dari respons iklan menggunakan
ResponseInfo dalam
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 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 detail selengkapnya. |
Log Perubahan Plugin Mediasi Unity Pangle
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.
- Dibangun 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.
- Dibangun 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.
- Dibangun 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.
- Dibuat 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.
- Dibuat 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.
- Dibuat 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 Pangle iOS 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 Pangle iOS 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.
- Dibangun 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
- Konten adaptor dipindahkan ke
GoogleMobileAds/Mediation/Pangle/. - Namespace adaptor difaktorkan ulang 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.
- Dibangun 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.
- Dibangun 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.
- Dibangun 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.
- Dibuat 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.
- Dibangun 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.