Mengintegrasikan Pangle dengan mediasi

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
1 Integrasi bidding untuk format ini masih dalam versi beta tertutup.

Persyaratan

  • Target deployment iOS 10.0 atau yang lebih tinggi

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

  • 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 di PangleAdapter.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 properti adConfiguration.childDirectedTreatment yang tidak digunakan lagi dengan properti GADMobileAds.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 protokol GADAdNetworkExtras.
  • 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() dan setCCPA() masing-masing dari class GADMediationAdapterPangle menjadi setGDPRConsent() dan setDoNotSell.
  • 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.