Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari Pangle menggunakan Mediasi AdMob, yang mencakup integrasi waterfall dan bidding. Artikel ini membahas cara menambahkan Pangle ke konfigurasi mediasi unit iklan, dan cara mengintegrasikan Pangle SDK serta adaptor ke dalam aplikasi iOS .
Integrasi dan format iklan yang didukung
Adaptor mediasi untuk Pangle memiliki kemampuan berikut:
Integrasi | |
---|---|
Bidding | |
Air Terjun | |
Format | |
Iklan di layar pembuka aplikasi | 1 |
Banner | |
Interstisial | |
Reward | |
Interstisial Reward | |
Native |
Persyaratan
- Target deployment iOS 10.0 atau yang lebih tinggi
Google Mobile Ads SDK terbaru
Selesaikan mediasi Panduan memulai
Langkah 1: Siapkan konfigurasi di UI Pangle
Daftar atau Login ke akun Pangle Anda.
Tambahkan aplikasi baru
Buka tab Applications dan klik tombol Add App.
Pilih Sistem Operasi yang ingin Anda buatkan permohonan dan isi isi formulir lainnya. Selanjutnya, klik Kirim.
Catat ID Aplikasi aplikasi Anda.
Membuat penempatan iklan
Setelah aplikasi dibuat, klik tombol Tambahkan untuk membuat penempatan iklan.
Bidding
Pilih Format Iklan dan Nama Penempatan Iklan, lalu pilih Bidding dalam Aplikasi sebagai Jenis Harga. Isi seluruh formulir, lalu klik Submit.
Setelah penempatan iklan dibuat, catat ID Penempatan Iklan.
Waterfall
Pilih Format Iklan dan Nama Penempatan Iklan, serta CPM Global sebagai Jenis Harga. Isi seluruh formulir, lalu klik Kirim.
Setelah penempatan iklan dibuat, catat ID Penempatan Iklan.
Menemukan kunci Pangle Reporting API
Bidding
Langkah ini tidak diperlukan untuk integrasi bidding.
Waterfall
Catat User ID di sudut kiri bawah halaman.
Klik Integrations > SDK & API > Pangle Reporting API 2.0. Catat Role ID dan Kunci Keamanan.
Aktifkan mode pengujian
Ikuti petunjuk dalam panduan Cara menambahkan Iklan Percobaan Pangle tentang cara mengaktifkan iklan pengujian Pangle.
Langkah 2: Siapkan permintaan Pangle di AdMob UI
Mengonfigurasi setelan mediasi untuk unit iklan
Anda harus menambahkan Pangle ke konfigurasi mediasi untuk unit iklan Anda.
Pertama, login ke akun AdMob Anda. Selanjutnya, buka tab Mediasi. Jika Anda sudah memiliki grup mediasi yang ingin diubah, klik nama grup mediasi tersebut untuk mengeditnya, lalu lanjutkan ke bagian Tambahkan Pangle sebagai sumber iklan.
Untuk membuat grup mediasi baru, pilih Buat Grup Mediasi.
Masukkan platform dan format iklan Anda, lalu klik Lanjutkan.
Berikan nama pada grup mediasi Anda, lalu pilih lokasi yang akan ditarget. Selanjutnya, tetapkan status grup mediasi ke Diaktifkan, lalu klik Tambahkan Unit Iklan.
Kaitkan grup mediasi ini dengan satu atau beberapa AdMob unit iklan Anda yang ada. Kemudian, klik Done.
Sekarang Anda akan melihat kartu unit iklan diisi dengan unit iklan yang dipilih:
Tambahkan Pangle sebagai sumber iklan
Bidding
Di kartu Bidding di bagian Sumber Iklan, pilih Tambahkan Sumber Iklan. Selanjutnya, pilih Pangle.
Klik Cara menandatangani perjanjian kemitraan dan siapkan kemitraan bidding dengan Pangle.
Klik Paham & setuju, lalu klik Lanjutkan.
Jika sudah memiliki pemetaan untuk Pangle, Anda dapat memilihnya. Jika tidak, klik Tambahkan pemetaan.
Selanjutnya, masukkan App ID and Ad Placement ID yang diperoleh di bagian sebelumnya. Kemudian, klik Done.
Penting: App ID harus dikaitkan dengan aplikasi yang ditargetkan seperti pada UIPangle .Waterfall
Pada kartu Waterfall di bagian Sumber Iklan, pilih Tambahkan Sumber Iklan. Selanjutnya, pilih Pangle.
Pilih Pangle. Kemudian, masukkan nilai eCPM untuk Pangle dan klik Lanjutkan.Jika sudah memiliki pemetaan untuk Pangle, Anda dapat memilihnya. Jika tidak, klik Tambahkan pemetaan.
Selanjutnya, masukkan App ID and Ad Placement ID yang diperoleh di bagian sebelumnya. Kemudian, klik Done.
Langkah 3: Impor Pangle SDK dan adaptor
Menggunakan CocoaPods (direkomendasikan)
Tambahkan baris berikut ke Podfile project Anda:
pod 'GoogleMobileAdsMediationPangle'
Dari command line, jalankan:
pod install --repo-update
Integrasi manual
- Download versi terbaru
Pangle SDK untuk iOS
dan tautkan semua file dan paket
.framework
dalam project Anda. - Download versi terbaru adaptor Pangle dari link download di
Log perubahan dan link
PangleAdapter.xcframework
di project Anda.
Langkah 4: Tambahkan kode yang diperlukan
Integrasi SKAdNetwork
Ikuti dokumentasi Pangle
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 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.
Langkah Opsional
Iklan native
Rendering iklan
Adaptor Pangle menampilkan iklan native sebagai
GADNativeAd
objek terstruktur dalam jumlah besar. Kolom ini mengisi hal-hal berikut
kolom
untuk
GADNativeAd
.
Kolom | Aset selalu disertakan oleh adaptor Pangle |
---|---|
Judul | |
Gambar | 1 |
Isi | |
Ikon | |
Pesan ajakan (CTA) | |
Rating bintang | |
Toko | |
Harga | |
Pengiklan |
1 Adaptor Pangle tidak
memberikan akses langsung ke aset gambar utama untuk iklan native-nya. Sebagai gantinya,
adaptor mengisi
GADMediaView
dengan video atau gambar.
Kode error
Jika adaptor gagal menerima iklan dari Pangle, Anda dapat memeriksa
error yang mendasar dari respons iklan dengan menggunakan
GADResponseInfo.adNetworkInfoArray
dalam class berikut:
GADMediationAdapterPangle
Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh adaptor Pangle saat iklan gagal dimuat:
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 Adaptor Mediasi iOS Pangle
Versi 6.1.0.6.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 6.1.0.6.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 11.7.0.
- Pangle SDK versi 6.1.0.6.
Versi 6.1.0.5.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 6.1.0.5.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 11.6.0.
- Pangle SDK versi 6.1.0.5.
Versi 6.1.0.4.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 6.1.0.4.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 11.6.0.
- Pangle SDK versi 6.1.0.4.
Versi 6.0.0.6.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 6.0.0.6.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 11.6.0.
- Pangle SDK versi 6.0.0.6.
Versi 6.0.0.5.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 6.0.0.5.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 11.5.0.
- Pangle SDK versi 6.0.0.5.
Versi 6.0.0.4.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 6.0.0.4.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 11.5.0.
- Pangle SDK versi 6.0.0.4.
Versi 5.9.0.9.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.9.0.9.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 11.5.0.
- Pangle SDK versi 5.9.0.9.
Versi 5.9.0.8.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.9.0.8.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 11.4.0.
- Pangle SDK versi 5.9.0.8.
Versi 5.9.0.7.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.9.0.7.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 11.3.0.
- Pangle SDK versi 5.9.0.7.
Versi 5.8.0.8.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.8.0.8.
- Memperbarui adaptor untuk menggunakan API pengumpulan sinyal Pangle SDK yang baru.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 11.2.0.
- Pangle SDK versi 5.8.0.8.
Versi 5.8.0.7.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.8.0.7.
- Sekarang memerlukan versi iOS minimum 12.0.
- Sekarang memerlukan Google Mobile Ads SDK versi 11.0 atau yang lebih tinggi.
Info.plist
telah disertakan dalam framework diPangleAdapter.xcframework
.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 11.0.1.
- Pangle SDK versi 5.8.0.7.
Versi 5.7.0.7.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.7.0.7.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.14.0.
- Pangle SDK versi 5.7.0.7.
Versi 5.7.0.6.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.7.0.6.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.14.0.
- Pangle SDK versi 5.7.0.6.
Versi 5.6.0.8.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.6.0.8.
- Memfaktorkan ulang metode
+setCOPPA
dengan mengganti propertiadConfiguration.childDirectedTreatment
yang tidak digunakan lagi dengan propertiGADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment
baru.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.14.0.
- Pangle SDK versi 5.6.0.8.
Versi 5.5.0.9.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.5.0.9.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.13.0.
- Pangle SDK versi 5.5.0.9.
Versi 5.5.0.7.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.5.0.7.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.12.0.
- Pangle SDK versi 5.5.0.7.
Versi 5.5.0.5.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.5.0.5.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.11.0.
- Pangle SDK versi 5.5.0.5.
Versi 5.4.1.1.0
- Menambahkan dukungan bidding untuk format iklan di layar pembuka aplikasi.
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.4.1.1.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.10.0.
- Pangle SDK versi 5.4.1.1.
Versi 5.4.0.9.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.4.0.9.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.9.0.
- Pangle SDK versi 5.4.0.9.
Versi 5.4.0.8.0
- Memperbaiki masalah saat
GADPangleNetworkExtras
tidak sesuai dengan protokolGADAdNetworkExtras
. - Menerapkan metode protokol
adDidShowFail
dalam iklan interstisial, reward, dan iklan di layar pembuka aplikasi. - Kompatibilitas terverifikasi dengan Pangle SDK versi 5.4.0.8.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.9.0.
- Pangle SDK versi 5.4.0.8.
Versi 5.3.1.2.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.3.1.2.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.8.0.
- Pangle SDK versi 5.3.1.2.
Versi 5.3.1.0.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.3.1.0.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.8.0.
- Pangle SDK versi 5.3.1.0.
Versi 5.2.1.1.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.2.1.1.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.7.0.
- Pangle SDK versi 5.2.1.1.
Versi 5.2.0.9.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.2.0.9.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.5.0.
- Pangle SDK versi 5.2.0.9.
Versi 5.2.0.8.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.2.0.8.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.5.0.
- Pangle SDK versi 5.2.0.8.
Versi 5.2.0.7.0
- Menambahkan dukungan waterfall untuk layar pembuka aplikasi, banner (termasuk MREC), interstisial, reward, dan format iklan native.
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.2.0.7.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.5.0.
- Pangle SDK versi 5.2.0.7.
Versi 5.2.0.6.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.2.0.6.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.5.0.
- Pangle SDK versi 5.2.0.6.
Versi 5.1.1.0.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.1.1.0.
- Menambahkan dukungan untuk arsitektur simulator
arm64
. - Sekarang memerlukan Google Mobile Ads SDK versi 10.4.0 atau yang lebih tinggi.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.4.0.
- Pangle SDK versi 5.1.1.0.
Versi 5.1.0.6.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.1.0.6.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.3.0.
- Pangle SDK versi 5.1.0.6.
Versi 5.0.1.0.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.0.1.0.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.2.0.
- Pangle SDK versi 5.0.1.0.
Versi 5.0.0.8.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.0.0.8.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.2.0.
- Pangle SDK versi 5.0.0.8.
Versi 5.0.0.7.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.0.0.7.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.1.0.
- Pangle SDK versi 5.0.0.7.
Versi 5.0.0.6.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 5.0.0.6.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.1.0.
- Pangle SDK versi 5.0.0.6.
Versi 4.9.1.0.0
- Menghapus dukungan untuk arsitektur
armv7
. - Kompatibilitas terverifikasi dengan Pangle SDK versi 4.9.1.0.
- Sekarang memerlukan versi iOS minimum 12.0.
- Sekarang memerlukan Google Mobile Ads SDK versi 10.0.0 atau yang lebih tinggi.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 10.0.0.
- Pangle SDK versi 4.9.1.0.
Versi 4.9.0.8.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 4.9.0.8.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.14.0.
- Pangle SDK versi 4.9.0.8.
Versi 4.9.0.7.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 4.9.0.7.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.14.0.
- Pangle SDK versi 4.9.0.7.
Versi 4.9.0.6.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 4.9.0.6.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.14.0.
- Pangle SDK versi 4.9.0.6.
Versi 4.8.1.0.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 4.8.1.0.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.14.0.
- Pangle SDK versi 4.8.1.0.
Versi 4.8.0.9.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 4.8.0.9.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.13.0.
- Pangle SDK versi 4.8.0.9.
Versi 4.8.0.7.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 4.8.0.7.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.13.0.
- Pangle SDK versi 4.8.0.7.
Versi 4.8.0.6.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 4.8.0.6.
- Memperbaiki masalah thread utama yang diblokir saat memuat gambar ikon iklan native.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.13.0.
- Pangle SDK versi 4.8.0.6.
Versi 4.7.0.7.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 4.7.0.7.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.11.0.
- Pangle SDK versi 4.7.0.7.
Versi 4.7.0.6.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 4.7.0.6.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.11.0.
- Pangle SDK versi 4.7.0.6.
Versi 4.7.0.5.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 4.7.0.5.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.11.0.
- Pangle SDK versi 4.7.0.5.
Versi 4.7.0.4.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 4.7.0.4.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.10.0.
- Pangle SDK versi 4.7.0.4.
Versi 4.6.2.2.0
- Mengganti nama metode
setGDPR()
dansetCCPA()
masing-masing dari classGADMediationAdapterPangle
menjadisetGDPRConsent()
dansetDoNotSell
. - Kompatibilitas terverifikasi dengan Pangle SDK versi 4.6.2.2.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.10.0.
- Pangle SDK versi 4.6.2.2.
Versi 4.6.1.8.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 4.6.1.8.
- Menambahkan dukungan bidding untuk format iklan native.
- Mengupdate adaptor untuk menggunakan
didRewardUser
API. - Sekarang memerlukan Google Mobile Ads SDK versi 9.8.0 atau yang lebih tinggi.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.9.0.
- Pangle SDK versi 4.6.1.8.
Versi 4.5.2.8.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 4.5.2.8.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.7.0.
- Pangle SDK versi 4.5.2.8.
Versi 4.5.2.7.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 4.5.2.7.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.7.0.
- Pangle SDK versi 4.5.2.7.
Versi 4.5.2.5.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 4.5.2.5.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.6.0.
- Pangle SDK versi 4.5.2.5.
Versi 4.5.2.4.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 4.5.2.4.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.6.0.
- Pangle SDK versi 4.5.2.4.
Versi 4.5.2.3.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 4.5.2.3.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.6.0.
- Pangle SDK versi 4.5.2.3.
Versi 4.5.1.3.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 4.5.1.3.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.5.0.
- Pangle SDK versi 4.5.1.3.
Versi 4.3.1.9.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 4.3.1.9.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.3.0.
- Pangle SDK versi 4.3.1.9.
Versi 4.3.0.5.0
- Kompatibilitas terverifikasi dengan Pangle SDK versi 4.3.0.5.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.2.0.
- Pangle SDK versi 4.3.0.5.
Versi 4.3.0.4.0
- Rilis awal!
- Menambahkan dukungan bidding untuk format iklan banner (termasuk MREC), interstisial, dan reward.
Dibangun dan diuji dengan:
- Google Mobile Ads SDK versi 9.1.0.
- Pangle SDK versi 4.3.0.4.