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 waterfall dan bidding. Panduan ini membahas cara menambahkan Pangle ke konfigurasi mediasi unit iklan dan cara mengintegrasikan SDK dan adaptor Pangle ke aplikasi Flutter.

Integrasi dan format iklan yang didukung

Adaptor mediasi AdMob untuk Pangle memiliki kemampuan berikut:

Integrasi
Bidding
Air Terjun
Format
Banner
Interstisial
Reward
Interstisial Reward
Native

Persyaratan

  • Google Mobile Ads SDK Terbaru
  • Flutter 3.7.0 atau yang lebih tinggi
  • [Untuk bidding]: Untuk mengintegrasikan semua format iklan yang didukung dalam bidding, gunakan plugin mediasi Google Mobile Ads untuk Pangle 2.4.0 atau yang lebih tinggi (versi terbaru direkomendasikan)
  • 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 Flutter yang berfungsi dan dikonfigurasi dengan Google Mobile Ads SDK. Lihat Memulai untuk mengetahui detailnya.
  • Selesaikan Panduan memulai mediasi

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.

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, lalu pilih Bidding Dalam Aplikasi sebagai Jenis Harga. Isi bagian formulir lainnya, lalu klik Kirim.

Setelah penempatan iklan dibuat, catat ID Penempatan Iklan.

Android

iOS

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.

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 AdMob

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 SDK dan adaptor Pangle

Integrasi melalui pub.dev

(Khusus Android) Tambahkan repositori berikut ke file build.gradle di dalam direktori android project Anda:

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://artifact.bytedance.com/repository/pangle/")
      }
  }

Tambahkan dependensi berikut dengan versi terbaru adaptor dan Pangle SDK di file pubspec.yaml paket Anda:

dependencies:
  gma_mediation_pangle: ^1.0.0

Integrasi Manual

Download plugin mediasi Google Mobile Ads versi terbaru untuk Pangle, ekstrak file yang didownload, dan tambahkan folder plugin yang diekstrak (dan kontennya) ke project Flutter Anda. Kemudian, referensikan plugin di file pubspec.yaml dengan menambahkan dependensi berikut:

dependencies:
  gma_mediation_pangle:
    path: path/to/local/package

Langkah 4: Tambahkan kode yang diperlukan

Android

Tidak diperlukan 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

Mengaktifkan iklan pengujian

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

Memverifikasi iklan percobaan

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

Kode error

Jika adaptor gagal menerima iklan dari Pangle, penayang dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo di bawah 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 mengetahui 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 iOS Pangle 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.
  • Di-build 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.