Mengintegrasikan Pangle dengan Mediasi AdMob

Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK for React Native 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 React Native.

Integrasi dan format iklan yang didukung

Adaptor mediasi AdMob 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 (Negara Lainnya).

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

Prasyarat

  • Versi Google Mobile Ads SDK for React Native terbaru.
  • [Untuk bidding Pangle US]: Gunakan adaptor Pangle versi N/A atau yang lebih tinggi.
  • Framework React Native versi 0.85.0 atau yang lebih baru.
  • 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 React Native yang berfungsi dan dikonfigurasi dengan Google Mobile Ads SDK for React Native. Lihat Menyiapkan Google Mobile Ads SDK for React Native untuk mengetahui detailnya.
  • Siapkan Mediasi AdMob.

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 dan isi 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

Menemukan kunci API Pangle Reporting

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 Role ID dan Security Key.

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, siapkan file app-ads.txt untuk aplikasi Anda.

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 AdMob

Mengonfigurasi setelan mediasi untuk unit iklan Anda

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

Di direktori root project Anda, instal adaptor mediasi Google Mobile Ads SDK for React Native untuk Pangle. Selesaikan langkah-langkah berikut:

  1. Salin file tar adaptor Google Mobile Ads SDK for React Native dari direktori gma-sdk-react-native/adapters/pangle/ ke direktori local_packages/ project Anda. Jika Anda tidak memiliki folder adapters, lihat Prasyarat.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/pangle/gma-mediation-pangle-0.1.0.tgz local_packages/

    Ganti EXTRACT_DIR dengan jalur ke direktori tempat Anda mengekstrak arsip.

  2. Instal paket adaptor menggunakan pengelola paket pilihan Anda:

    npm

    npm install ./local_packages/gma-mediation-pangle-0.1.0.tgz

    benang

    yarn add ./local_packages/gma-mediation-pangle-0.1.0.tgz

  3. Jika Anda mem-build untuk Android, tambahkan repositori berikut ke file build.gradle di direktori android project Anda:

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

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.

Adaptor React Native Pangle versi 0.1.0 dan yang lebih baru mendukung penerusan sinyal izin GDPR dari UMP SDK dan platform pengelolaan izin yang terintegrasi dengan spesifikasi Izin Tambahan Google ke SDK Pangle.

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 Pangle SDK. Tetapkan informasi izin sebelum Anda menginisialisasi Google Mobile Ads SDK for React Native untuk memastikan informasi tersebut diteruskan dengan benar ke SDK Pangle.

import {
  PangleMediation,
  PanglePAConsentType,
} from '@google/gma-mediation-pangle';
// ...

PangleMediation.setPAConsent(PanglePAConsentType.CONSENT);

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 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 SDK Pangle 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 SDK Pangle tidak mendukung pengguna anak-anak.
-1-60000 Dikirim oleh Pangle SDK SDK Pangle menampilkan error. Lihat dokumentasi Pangle untuk mengetahui detail selengkapnya.

Versi 0.1.0

  • Rilis awal.