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 dalam aplikasi Flutter.

Integrasi dan format iklan yang didukung

Adaptor mediasi AdMob untuk Pangle memiliki kemampuan berikut:

Integrasi
Bidding
Air Terjun
Format
Membuka Aplikasi
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 23 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.

Memperbarui app-ads.txt

app-ads.txt Penjual Resmi untuk Aplikasi adalah inisiatif IAB Tech Lab yang membantu memastikan inventaris iklan aplikasi Anda hanya dijual melalui saluran yang telah Anda identifikasi sebagai resmi. Untuk mencegah kerugian pendapatan iklan yang signifikan, Anda harus menerapkan file app-ads.txt. Jika Anda belum melakukannya, buat file app-ads.txt untuk Ad Manager.

Untuk menerapkan app-ads.txt untuk Pangle, lihat Cara menambahkan Pangle ke file app-ads.txt.

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.

Menambahkan DSP Pangle ke daftar partner iklan GDPR dan peraturan negara bagian AS

Ikuti langkah-langkah di setelan peraturan Eropa dan setelan peraturan negara bagian AS untuk menambahkan Pangle DSP ke daftar partner iklan peraturan Eropa dan negara bagian AS di UI AdMob.

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: ^

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: Terapkan setelan privasi di Pangle SDK

Berdasarkan Kebijakan Izin Pengguna Uni Eropa Google, Anda harus memastikan bahwa pengungkapan tertentu diberikan kepada, dan izin diperoleh dari, pengguna di Wilayah Ekonomi Eropa (EEA) terkait penggunaan ID perangkat dan data pribadi. Kebijakan ini mencerminkan persyaratan dalam ePrivacy Directive dan General Data Protection Regulation (GDPR) Uni Eropa. Saat meminta izin, Anda harus mengidentifikasi setiap jaringan iklan dalam rantai mediasi yang dapat mengumpulkan, menerima, atau menggunakan data pribadi dan memberikan informasi tentang penggunaan setiap jaringan. Saat ini Google tidak dapat meneruskan pilihan izin pengguna ke jaringan tersebut secara otomatis.

Plugin mediasi Google Mobile Ads untuk Pangle menyertakan metode Pangle.SetGDPRConsent(). Contoh kode berikut menunjukkan cara meneruskan informasi izin ke Pangle SDK. Tetapkan informasi izin sebelum Anda menginisialisasi Google Mobile Ads SDK untuk memastikan informasi tersebut diteruskan dengan benar ke Pangle SDK.

using GoogleMobileAds.Api.Mediation.Pangle;
// ...

Pangle.SetGDPRConsent(0);

Lihat panduan integrasi Pangle untuk mengetahui detail selengkapnya dan nilai yang dapat diberikan di setiap metode.

Hukum privasi negara bagian Amerika Serikat

Hukum privasi negara bagian Amerika Serikat mewajibkan perusahaan tersebut untuk memberikan hak kepada pengguna untuk memilih tidak ikut dalam "penjualan" "informasi pribadi" mereka (sebagaimana istilah tersebut didefinisikan dalam hukum), dengan pilihan tidak ikut yang ditawarkan melalui link "Jangan Jual Informasi Pribadi Saya" yang terlihat jelas di halaman beranda pihak "penjual". Panduan kepatuhan terhadap hukum privasi negara bagian Amerika Serikat menawarkan kemampuan untuk mengaktifkan pemrosesan data yang dibatasi untuk penayangan iklan Google, tetapi Google tidak dapat menerapkan setelan ini ke setiap jaringan iklan dalam rantai mediasi Anda. Oleh karena itu, Anda harus mengidentifikasi setiap jaringan iklan dalam rantai mediasi yang dapat berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhan.

Plugin mediasi Google Mobile Ads untuk Pangle menyertakan metode Pangle.SetPAConsent(). Contoh kode berikut menunjukkan cara meneruskan informasi izin ke Pangle SDK. Tetapkan informasi izin sebelum Anda menginisialisasi Google Mobile Ads SDK untuk memastikan informasi tersebut diteruskan dengan benar ke Pangle SDK.

using GoogleMobileAds.Api.Mediation.Pangle;
// ...

Pangle.SetPAConsent(0);

Lihat panduan integrasi Pangle untuk mengetahui detail selengkapnya dan nilai yang dapat diberikan di setiap metode.

Langkah 5: 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 6: 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 2.2.0

Versi 2.1.0

Versi 2.0.0

Versi 1.1.0

Versi 1.0.0