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 |
2 Integrasi bidding untuk format ini masih dalam versi beta tertutup.
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.
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
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 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 dalamPangleAdapter.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 propertiadConfiguration.childDirectedTreatment
yang tidak digunakan lagi dengan propertiGADMobileAds.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 protokolGADAdNetworkExtras
. - 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()
dansetCCPA()
dari classGADMediationAdapterPangle
menjadisetGDPRConsent()
dansetDoNotSell
. - 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.