Mengintegrasikan Pangle dengan mediasi

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

Integrasi dan format iklan yang didukung

Adaptor mediasi untuk Pangle memiliki kemampuan berikut:

Integrasi
Bidding
Air Terjun  1
Format
Banner
Interstisial
Reward
Interstisial Reward
1 Integrasi waterfall dalam versi beta tertutup.

Persyaratan

  • Google Mobile Ads SDK terbaru
  • Flutter 3.7.0 atau yang lebih tinggi
  • Untuk men-deploy di Android
    • Android API level 21 atau yang lebih tinggi
  • Untuk men-deploy di iOS
    • Target deployment iOS 12.0 atau yang lebih tinggi
  • Project kerja yang dikonfigurasi dengan Google Mobile Ads SDK. Lihat Memulai untuk mengetahui detailnya.
  • Selesaikan mediasi Panduan memulai

Langkah 1: Siapkan konfigurasi di UI Pangle

Daftar atau Login ke akun Pangle Anda.

Menambahkan aplikasi baru

Arahkan ke tab Applications dan klik tombol Add App.

Pilih Sistem Operasi yang permohonannya ingin Anda buat dan isi formulir selanjutnya. Kemudian, klik Kirim.

Android

iOS

Catat ID Aplikasi aplikasi Anda.

Android

iOS

Membuat penempatan iklan

Setelah aplikasi dibuat, klik tombol Tambahkan untuk membuat penempatan iklan.

Android

iOS

Bidding

Pilih Format Iklan dan Nama Penempatan Iklan Anda, lalu pilih Bidding Dalam Aplikasi sebagai Jenis Penetapan Harga. Isi sisa formulir, lalu klik Submit.

Setelah penempatan iklan dibuat, catat ID Penempatan Iklan.

Android

iOS

Air Terjun

Pilih Format Iklan dan Nama Penempatan Iklan, serta CPM Global sebagai Jenis Penetapan Harga. Isi sisa formulir, lalu klik Submit.

Setelah penempatan iklan dibuat, catat ID Penempatan Iklan.

Android

iOS

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.

Mengaktifkan mode pengujian

Ikuti petunjuk dalam panduan Cara menambahkan Iklan Uji Pangle tentang cara mengaktifkan iklan uji Pangle.

Langkah 2: Siapkan permintaan Pangle di UI

Mengonfigurasi setelan mediasi untuk unit iklan

Android

Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk Android.

iOS

Untuk mengetahui petunjuknya, lihat langkah 2 dalam panduan untuk iOS.

Langkah 3: Impor Pangle SDK dan adaptor

OpenUPM-CLI

Jika sudah menginstal OpenUPM-CLI, Anda dapat menginstal Plugin Mediasi Google Mobile Ads Pangle untuk Unity ke project Anda dengan menjalankan perintah berikut dari direktori utama project:

openupm add com.google.ads.mobile.mediation.pangle

OpenUPM

Di editor project Unity, pilih Edit > Project Settings > Package Manager untuk membuka Unity Package Manager Settings.

Di tab Scoped Registries, tambahkan OpenUPM sebagai registry terbatas dengan detail berikut:

  • Nama: OpenUPM
  • URL: https://package.openupm.com
  • Cakupan: com.google

Detail OpenUPM

Kemudian, buka Window > Package Manager untuk membuka Unity Package Manager dan pilih My Registries dari menu drop-down.

Registry Unity

Pilih paket Google Mobile Ads Pangle Mediation, lalu klik Install.

Menginstal dari OpenUPM

Paket Unity

Download versi terbaru plugin mediasi Google Mobile Ads untuk Pangle dari link download di Changelog dan ekstrak GoogleMobileAdsPangleMediation.unitypackage dari file ZIP.

Di editor project Unity, pilih Assets > Import Package > Custom Package, lalu temukan file GoogleMobileAdsPangleMediation.unitypackage yang telah Anda download. Pastikan semua file dipilih, lalu klik Import.

Mengimpor dari Unity

Lalu, pilih Assets > External Dependency Manager > Android Resolver > Force Resolve. Library External Dependency Manager akan melakukan resolusi dependensi dari awal dan menyalin dependensi yang dideklarasikan ke direktori Assets/Plugins/Android aplikasi Unity Anda.

Paksa Selesaikan

Langkah 4: Tambahkan kode yang diperlukan

Android

Tidak perlu kode tambahan untuk integrasi Pangle.

iOS

Integrasi SKAdNetwork

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

Langkah 5: Uji penerapan Anda

Aktifkan iklan percobaan

Pastikan Anda mendaftarkan perangkat pengujian Anda untuk

Memverifikasi iklan percobaan

Untuk memverifikasi bahwa Anda menerima iklan pengujian dari , aktifkan pengujian sumber iklan tunggal di pemeriksa iklan menggunakan sumber iklan.

Kode error

Jika adaptor gagal menerima iklan dari Pangle, penayang dapat memeriksa error dasar dari respons iklan menggunakan ResponseInfo dalam class berikut:

Android

com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter

iOS

GADMediationAdapterPangle

Berikut adalah kode dan pesan yang menyertainya yang ditampilkan oleh adaptor Pangle saat iklan gagal dimuat:

Android

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.
103 com.google.ads.mediation.pangle Respons bid tidak ada atau tidak valid.
-1-60000 com.pangle.ads Pangle SDK menampilkan error. Lihat dokumentasi Pangle untuk detail selengkapnya.

iOS

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 Flutter Pangle

Versi Berikutnya

  • Di-build dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.2.0.

2.0.0

  • Kompatibilitas terverifikasi dengan adaptor Android Pangle versi 6.1.0.9.0.
  • Kompatibilitas terverifikasi dengan adaptor Pangle iOS versi 6.2.0.5.0.
  • Di-build dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.1.0.

1.1.0

  • Kompatibilitas terverifikasi dengan adaptor Android Pangle versi 5.9.0.4.0.
  • Kompatibilitas terverifikasi dengan adaptor iOS Pangle versi 5.9.0.7.0.
  • Dibangun dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.1.0.

1.0.0

  • Rilis awal.
  • Kompatibilitas terverifikasi dengan adaptor Android Pangle versi 5.8.0.9.0
  • Kompatibilitas terverifikasi dengan adaptor iOS Pangle versi 5.8.0.8.0
  • Di-build dan diuji dengan Plugin Flutter Google Mobile Ads versi 5.0.0.