Halaman ini diterjemahkan oleh Cloud Translation API.

Mengintegrasikan Pangle dengan mediasi

Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK untuk memuat dan menampilkan iklan dari Pangle menggunakan mediasi, yang mencakup integrasi dan waterfall dan bidding. Panduan ini membahas cara menambahkan Pangle ke konfigurasi mediasi unit iklan, serta cara mengintegrasikan Adaptor dan SDK Pangle ke dalam aplikasi iOS .

Integrasi dan format iklan yang didukung

Adaptor mediasi AdMob untuk Pangle memiliki kemampuan berikut:

Integrasi
Bidding
Air Terjun	¹
Format
Layar pembuka aplikasi	²
Banner
Interstisial
Diberikan sebagai reward
Interstisial Reward
Native	³	¹

¹ Integrasi waterfall masih dalam versi beta tertutup.

² Tidak didukung dalam bidding (hanya didukung untuk mediasi waterfall).

³ Iklan native memerlukan adaptor Pangle versi 4.6.1.8.0 atau yang lebih tinggi.

Persyaratan

Target deployment iOS 10.0 atau yang lebih tinggi

Google Mobile Ads SDK terbaru
Selesaikan mediasi Panduan memulai

Langkah 1: Siapkan Pangle

Daftar atau Login ke akun Pangle Anda.

Tambahkan aplikasi baru

Buka tab Applications, lalu klik tombol Add App.

Pilih iOS sebagai Sistem Operasi dan isi formulir. Setelah itu, klik Kirim.

Catat ID Aplikasi aplikasi Anda.

Membuat penempatan iklan

Setelah aplikasi dibuat, klik tombol Tambahkan seperti yang ditunjukkan di bawah untuk membuat penempatan iklan.

Bidding

Pilih Format Iklan dan Nama Penempatan Iklan Anda, lalu pilih Bidding dalam Aplikasi sebagai Jenis Harga. Isi formulir lainnya dan klik Kirim.

Setelah penempatan iklan dibuat, catat ID Penempatan Iklan.

Air Terjun

Pilih Format Iklan dan Nama Penempatan Iklan, dan CPM Global sebagai Jenis Harga. Isi formulir lainnya dan 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 User-ID di sudut kiri bawah halaman.

Klik Integrations > SDK & API > Pangle Reporting API 2.0. Catat ID Peran dan Kunci Keamanan.

Langkah 2: Konfigurasikan setelan mediasi untuk unit iklan AdMob

Anda harus menambahkan Pangle ke konfigurasi mediasi unit iklan Anda. Pertama, login ke akun AdMob Anda.

Buka tab Mediasi. Jika Anda sudah memiliki grup mediasi yang ingin diubah, klik nama grup mediasi tersebut untuk mengeditnya, lalu lanjutkan ke Menambahkan Pangle sebagai sumber iklan.

Untuk membuat grup mediasi baru, pilih Buat Grup Mediasi.

Detail mediasi

Masukkan format dan platform iklan Anda, lalu klik Lanjutkan.

Beri nama grup mediasi Anda dan pilih lokasi yang akan ditargetkan. Selanjutnya, tetapkan status grup mediasi ke Aktif. Kemudian, klik Tambahkan Unit Iklan, yang akan membuka overlay pilihan unit iklan.

Kaitkan grup mediasi ini dengan unit iklan AdMob Anda yang ada. Kemudian, klik Done.

Sekarang Anda akan melihat kartu unit iklan diisi dengan unit iklan yang Anda pilih.

Menambahkan Pangle sebagai sumber iklan

Bidding

Di kartu Bidding di bagian Sumber Iklan, pilih Tambahkan Sumber Iklan. Lalu 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 cukup memilihnya. Jika tidak, klik Tambahkan pemetaan.

Selanjutnya, masukkan Nama pemetaan, ID Aplikasi, dan ID Penempatan Iklan yang diperoleh di bagian sebelumnya. Kemudian, klik Done.

Air Terjun

Di kartu Waterfall di bagian Sumber Iklan, pilih Tambahkan Sumber Iklan.

Pilih Pangle, lalu aktifkan tombol Optimize. Masukkan ID pengguna Reporting API, ID peran Reporting API, dan Kunci Rahasia yang diperoleh di bagian sebelumnya. Lalu, masukkan nilai eCPM untuk Pangle dan klik Lanjutkan.

Jika sudah memiliki pemetaan untuk Pangle, Anda cukup memilihnya. Jika tidak, klik Tambahkan pemetaan.

Selanjutnya, masukkan Nama pemetaan, ID Aplikasi, dan ID Penempatan Iklan. Lalu, klik Done.

Langkah 3: Impor SDK dan adaptor Pangle

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 di project Anda.
Download versi terbaru adaptor Pangle dari link download di Changelog dan tautkan PangleAdapter.xcframework di project Anda.

Langkah 4: Kode tambahan diperlukan

Integrasi SKAdNetwork

Ikuti dokumentasi Pangle untuk menambahkan ID SKAdNetwork ke file Info.plist project Anda.

Langkah 5: Uji penerapan Anda

Lihat panduan Cara menambahkan Iklan Percobaan untuk mengetahui petunjuk mendetail tentang cara mengaktifkan iklan percobaan Pangle. Kemudian, Anda dapat menggunakan Ad Inspector untuk memverifikasi apakah penerapan Anda sudah benar.

Selesai. Anda kini memiliki integrasi mediasi yang berfungsi dengan Pangle.

Langkah Opsional

Iklan native

Rendering iklan

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

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

¹ 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 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.mediasi.pangle	Parameter server tidak valid (misalnya, ID aplikasi atau ID penempatan tidak ada).
102	com.google.ads.mediasi.pangle	Ukuran iklan yang diminta tidak cocok dengan ukuran banner yang didukung Pangle.
103	com.google.ads.mediasi.pangle	Respons bid tidak ada atau tidak valid.
-1-60000	com.pangle.ads	Pangle SDK menampilkan error. Lihat dokumentasi Pangle untuk mengetahui detail selengkapnya.
101	com.google.ads.mediasi.pangle	Parameter server tidak valid (misalnya, ID aplikasi atau ID penempatan tidak ada).
102	com.google.ads.mediasi.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 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 di iklan interstisial, reward, dan 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 format iklan di 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.
Kini mewajibkan iOS minimum versi 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() dari class GADMediationAdapterPangle menjadi setGDPRConsent() dan setDoNotSell.
Kompatibilitas terverifikasi dengan Pangle SDK versi 4.6.2.2.

Dibangun dan diuji dengan: