Mengintegrasikan Pangle dengan bidding

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 iOS aplikasi.

Integrasi dan format iklan yang didukung

Adaptor mediasi untuk Pangle memiliki kemampuan berikut:

Integrasi
Bidding
Air Terjun  1
Format
Layar pembuka aplikasi  2
Banner
Interstisial
Reward
Interstisial Reward
Native
1 Integrasi waterfall dalam versi beta tertutup.

2 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.

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.

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 bagian formulir lainnya, lalu klik Kirim.

Setelah penempatan iklan dibuat, catat ID Penempatan Iklan.

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.

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.

Aktifkan mode pengujian

Ikuti petunjuk dalam panduan Cara menambahkan Iklan Percobaan Pangle tentang cara mengaktifkan iklan percobaan Pangle.

Langkah 2: Siapkan permintaan Pangle di Ad Manager UI

Langkah 3: Impor SDK dan adaptor Pangle

  • Tambahkan baris berikut ke Podfile project Anda:

    pod 'GoogleMobileAdsMediationPangle'
    
  • Dari command line, jalankan:

    pod install --repo-update

Integrasi manual

  • Download versi terbaru Pangle SDK for iOS dan tautkan semua file dan paket .framework dalam project Anda.
  • Download adaptor Pangle versi terbaru dari link download di Log Perubahan dan tautkan 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 Anda

Mengaktifkan iklan pengujian

Pastikan Anda mendaftarkan perangkat pengujian untuk AdMob dan mengaktifkan mode pengujian di UI Pangle.

Memverifikasi iklan percobaan

Untuk memastikan bahwa Anda menerima iklan percobaan dari Pangle, aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan sumber iklan Pangle (Bidding) dan Pangle (Waterfall).

Langkah Opsional

Iklan native

Rendering iklan

Adaptor Pangle menampilkan iklan native-nya sebagai objek GADNativeAd . Fungsi ini mengisi kolom berikut untuk GADNativeAd.

Kolom Aset yang selalu disertakan oleh adaptor Pangle
Judul
Gambar 1
Isi
Ikon
Pesan ajakan (CTA)
Rating bintang
Toko
Harga
Pengiklan

1 Adaptor Pangle tidak menyediakan 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 mendasarinya dari respons iklan menggunakan GADResponseInfo.adNetworkInfoArray di bawah 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 mengetahui detail selengkapnya.

Log Perubahan Adaptor Mediasi iOS Pangle

Versi 6.3.0.8.0

  • Kompatibilitas terverifikasi dengan Pangle SDK versi 6.3.0.8.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 11.11.0.
  • Pangle SDK versi 6.3.0.8.

Versi 6.3.0.6.0

  • Kompatibilitas terverifikasi dengan Pangle SDK versi 6.3.0.6.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 11.11.0.
  • Pangle SDK versi 6.3.0.6.

Versi 6.2.0.9.0

  • Kompatibilitas terverifikasi dengan Pangle SDK versi 6.2.0.9.

Dibangun dan diuji dengan:

  • Google Mobile Ads SDK versi 11.10.0.
  • Pangle SDK versi 6.2.0.9.

Versi 6.2.0.8.0

  • Kompatibilitas terverifikasi dengan Pangle SDK versi 6.2.0.8.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 11.10.0.
  • Pangle SDK versi 6.2.0.8.

Versi 6.2.0.7.0

  • Kompatibilitas terverifikasi dengan Pangle SDK versi 6.2.0.7.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 11.8.0.
  • Pangle SDK versi 6.2.0.7.

Versi 6.2.0.6.0

  • Kompatibilitas terverifikasi dengan Pangle SDK versi 6.2.0.6.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 11.8.0.
  • Pangle SDK versi 6.2.0.6.

Versi 6.2.0.5.0

  • Kompatibilitas terverifikasi dengan Pangle SDK versi 6.2.0.5.

Dibuat dan diuji dengan:

  • Google Mobile Ads SDK versi 11.8.0.
  • Pangle SDK versi 6.2.0.5.

Versi 6.1.0.6.0

  • Kompatibilitas terverifikasi dengan Pangle SDK versi 6.1.0.6.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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.
  • Mengupdate adaptor untuk menggunakan API pengumpulan sinyal Pangle SDK baru.

Dibuat 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.
  • Kini memerlukan iOS versi minimum 12.0.
  • Sekarang memerlukan Google Mobile Ads SDK versi 11.0 atau yang lebih tinggi.
  • Menyertakan Info.plist dalam framework dalam PangleAdapter.xcframework.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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 di iklan interstisial, reward, dan layar pembuka aplikasi.
  • Kompatibilitas terverifikasi dengan Pangle SDK versi 5.4.0.8.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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 format iklan layar pembuka aplikasi, banner (termasuk MREC), interstisial, reward, dan native.
  • Kompatibilitas terverifikasi dengan Pangle SDK versi 5.2.0.7.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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.
  • Kini memerlukan versi iOS minimum 12.0.
  • Sekarang memerlukan Google Mobile Ads SDK versi 10.0.0 atau yang lebih tinggi.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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 saat thread utama diblokir saat memuat gambar ikon iklan native.

Dibuat 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.

Dibuat 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.

Dibuat 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() dari class GADMediationAdapterPangle menjadi setGDPRConsent() dan setDoNotSell.
  • Kompatibilitas terverifikasi dengan Pangle SDK versi 4.6.2.2.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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.

Dibuat 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.