Mengintegrasikan Pangle dengan mediasi

Pilih platform: Android iOS Unity Flutter Android (Legacy)

Panduan ini menunjukkan cara menggunakan Google Mobile Ads Unity Plugin 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 Unity.

Integrasi dan format iklan yang didukung

Adaptor mediasi Ad Manager untuk Pangle memiliki kemampuan berikut:

Integrasi
Bidding  1
Air Terjun
Format
Membuka Aplikasi  2
Banner  2
Interstisial
Reward
Interstisial Reward
Native  2

1 Sumber iklan bidding Pangle yang tersedia mencakup Pangle US, Pangle KR, dan Pangle ROW.

2 Format ini tidak didukung untuk sumber iklan bidding Pangle berikut: Pangle AS.

Prasyarat

  • Versi Google Mobile Ads Unity Plugin terbaru.
  • [Untuk bidding Pangle AS]: Gunakan adaptor Pangle versi 5.1.0 atau yang lebih tinggi.
  • Unity Editor versi 5.6 atau yang lebih baru.
  • [Untuk bidding Pangle KR dan bidding Pangle ROW]: Untuk mengintegrasikan semua format iklan yang didukung dalam bidding, gunakan plugin mediasi Google Mobile Ads untuk Pangle 2.4.0 atau yang lebih baru (direkomendasikan versi terbaru).
  • Untuk men-deploy di Android
    • Android API level 24 atau yang lebih baru.
  • Untuk men-deploy di iOS
    • Target deployment iOS 13.0 atau yang lebih baru.
  • Project Unity yang berfungsi dan dikonfigurasi dengan Google Mobile Ads Unity Plugin. Lihat Menyiapkan Google Mobile Ads Unity Plugin untuk mengetahui detailnya.
  • Siapkan mediasi.

    • Langkah 1: Siapkan konfigurasi di UI Pangle

    Daftar atau Login ke akun Pangle Anda.

    Menambahkan aplikasi baru

    Buka tab Aplikasi, lalu klik tombol Tambahkan Aplikasi.

    Pilih Sistem Operasi yang ingin Anda buat aplikasinya dan isi bagian formulir lainnya. Kemudian, klik Kirim.

    Android

    iOS

    Catat ID Aplikasi aplikasi Anda.

    Android

    iOS

    Membuat penempatan iklan

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

    Android

    iOS

    Bidding

    Pilih Ad Format dan Ad Placement Name, lalu pilih In-App Bidding sebagai Pricing Type. Isi bagian formulir lainnya dan 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

    Memperbarui app-ads.txt

    Authorized Sellers for Apps app-ads.txt 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 Percobaan Pangle tentang cara mengaktifkan iklan percobaan Pangle.

    Langkah 2: Siapkan permintaan Pangle di UI Ad Manager

    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 peraturan negara bagian AS dan GDPR

    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 Ad Manager.

    Langkah 3: Impor SDK dan adaptor Pangle

    OpenUPM-CLI

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

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

    OpenUPM

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

    Di tab Scoped Registries, tambahkan OpenUPM sebagai scoped registry 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 plugin mediasi Google Mobile Ads versi terbaru untuk Pangle dari link download di Log Perubahan 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 telah dipilih, lalu klik Impor.

    Mengimpor dari Unity

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

    Paksa Penyelesaian

    Langkah 4: Terapkan setelan privasi di Pangle SDK

    Untuk mematuhi Kebijakan Izin Pengguna Uni Eropa Google, Anda harus membuat pengungkapan tertentu kepada pengguna di Wilayah Ekonomi Eropa (EEA), Inggris Raya, dan Swiss, serta mendapatkan izin mereka untuk penggunaan cookie atau penyimpanan lokal lainnya jika diwajibkan secara hukum, dan untuk pengumpulan, pembagian, serta penggunaan data pribadi untuk personalisasi iklan. Kebijakan ini mencerminkan persyaratan dalam ePrivacy Directive dan General Data Protection Regulation (GDPR) Uni Eropa. Anda bertanggung jawab untuk memverifikasi bahwa izin disebarkan ke setiap sumber iklan dalam rantai mediasi Anda.

    Di Pangle Unity Adapter versi 5.9.0 dan yang lebih baru, Pangle secara otomatis membaca izin GDPR yang ditetapkan oleh platform pengelolaan izin yang mendukung spesifikasi Izin Tambahan Google, termasuk UMP SDK.

    Hukum privasi negara bagian Amerika Serikat

    Hukum privasi negara bagian Amerika Serikat mewajibkan perusahaan tersebut untuk memberikan hak kepada pengguna guna menolak "penjualan" "informasi pribadi" mereka (sebagaimana kedua istilah tersebut didefinisikan dalam hukum), dengan pilihan tidak ikut yang disediakan 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 Anda yang mungkin berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhan.

    Kode contoh berikut menunjukkan cara meneruskan informasi izin ke SDK Pangle. Tetapkan informasi izin sebelum Anda melakukan inisialisasi Google Mobile Ads Unity Plugin 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 Ad Manager dan mengaktifkan mode pengujian di UI Pangle.

    Memverifikasi iklan pengujian

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

    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 sesuai dengan ukuran banner yang didukung Pangle.
    103 com.google.ads.mediation.pangle SDK Pangle tidak mendukung pengguna anak-anak.
    -1-60000 com.pangle.ads Pangle SDK menampilkan error. Lihat dokumentasi Pangle untuk mengetahui detail selengkapnya.

    iOS

    Kode error Domain Alasan
    101 com.google.mediation.pangle Parameter server tidak valid (misalnya, ID aplikasi atau ID penempatan tidak ada).
    102 com.google.mediation.pangle Ukuran iklan yang diminta tidak sesuai dengan ukuran banner yang didukung Pangle.
    104 com.google.mediation.pangle Pangle SDK tidak mendukung pengguna anak-anak.
    -1-60000 Dikirim oleh Pangle SDK SDK Pangle menampilkan error. Lihat dokumentasi Pangle untuk mengetahui detail selengkapnya.

    Log Perubahan Plugin Mediasi Unity Pangle

    Versi 7.2.2 (Dalam proses)

    Versi 7.2.1

    Versi 7.2.0

    Versi 7.1.1

    Versi 7.1.0

    Versi 7.0.0 (di-roll back)

    Versi 6.0.1

    Versi 6.0.0

    Versi 5.9.2

    Versi 5.9.1

    Versi 5.9.0

    Versi 5.8.5

    Versi 5.8.4

    Versi 5.8.3

    Versi 5.8.2

    Versi 5.8.1

    Versi 5.8.0

    Versi 5.7.1

    Versi 5.7.0

    Versi 5.6.0

    Versi 5.5.3

    Versi 5.5.2

    Versi 5.5.1

    Versi 5.5.0

    Versi 5.4.0

    Versi 5.3.0

    Versi 5.2.2

    Versi 5.2.1

    Versi 5.2.0

    Versi 5.1.1

    Versi 5.1.0

    Versi 5.0.0

    Versi 4.6.2

    Versi 4.6.1

    Versi 4.6.0

    Versi 4.5.4

    Versi 4.5.3

    Versi 4.5.2

    Versi 4.5.1

    Versi 4.5.0

    Versi 4.4.2

    Versi 4.4.1

    Versi 4.4.0

    Versi 4.3.3

    Versi 4.3.2

    Versi 4.3.1

    Versi 4.3.0

    Versi 4.2.1

    Versi 4.2.0

    Versi 4.1.0

    Versi 4.0.1

    Versi 4.0.0

    Versi 3.0.0

    Versi 2.8.1

    Versi 2.8.0

    Versi 2.7.0

    Versi 2.6.0

    Versi 2.5.0

    Versi 2.4.0

    Versi 2.3.0

    Versi 2.2.0

    Versi 2.1.0

    Versi 2.0.0

    Versi 1.5.1

    Versi 1.5.0

    Versi 1.4.0

    Versi 1.3.1

    Versi 1.3.0

    Versi 1.2.0

    Versi 1.1.0

    Versi 1.0.0