Mengintegrasikan PubMatic dengan Mediasi AdMob

Pilih platform: Android iOS Unity Flutter React Native Android (Lama)

Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK for React Native untuk memuat dan menampilkan iklan dari PubMatic menggunakan Mediasi AdMob, yang mencakup integrasi bidding. Panduan ini membahas cara menambahkan PubMatic ke konfigurasi mediasi unit iklan dan cara mengintegrasikan SDK dan adaptor PubMatic ke dalam aplikasi React Native.

Integrasi dan format iklan yang didukung

Adaptor mediasi AdMob untuk PubMatic memiliki kemampuan berikut:

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

¹ Format ini masih dalam versi beta. Hubungi pengelola akun Anda untuk meminta akses.

Prasyarat

Sebelum melanjutkan, pastikan hal berikut:

• Versi Google Mobile Ads SDK for React Native terbaru.
• 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.
  • Pastikan Anda telah mendownload dan mengekstrak folder adapters dari folder gma-sdk-react-native. Jika Anda tidak memiliki folder adapters, ikuti langkah satu, dua, dan tiga di Menginstal Google Mobile Ads SDK for React Native.
• Siapkan Mediasi AdMob.

Langkah 1: Siapkan konfigurasi di UI PubMatic OpenWrap SDK

Daftar atau Login ke akun PubMatic Anda, lalu pilih kartu OpenWrap SDK.

Menambahkan aplikasi baru

Buka tab Apps, lalu klik tombol Add App.

Pilih Platform, serta URL App Store dan Nama Aplikasi untuk aplikasi Anda.

Android

Di bagian Integration Path, pilih React Native dan pilih AdMob - Bidding dengan SDK sebagai Sub-integration Path. Lalu, klik tombol Add App.

iOS

Di bagian Integration Path, pilih React Native dan pilih AdMob - Bidding dengan SDK sebagai Sub-integration Path. Lalu, klik tombol Add App.

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.

Sebelum aplikasi Anda diselesaikan, Anda akan melihat entri yang sesuai untuk ditambahkan ke app-ads.txt.

Untuk informasi tambahan tentang cara menerapkan app-ads.txt untuk PubMatic, lihat Cara Menerapkan app-ads.txt.

ID Profil

Setelah aplikasi dibuat, buka tab Apps dan catat Profile ID aplikasi yang baru dibuat.

Buat unit iklan

Di tab Unit Iklan, pilih aplikasi yang Anda buat di bagian sebelumnya, lalu klik tombol Buat Unit Iklan.

Isi formulir dengan detail unit iklan Anda, lalu klik Simpan.

Catat ID Unit Iklan OpenWrap yang baru dibuat.

Mendapatkan ID Penayang Anda

Buka Dasbor Analytics. Arahkan kursor ke ikon profil dan catat ID Anda.

Langkah 2: Siapkan permintaan PubMatic OpenWrap SDK 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 PubMatic ke daftar partner iklan GDPR dan peraturan negara bagian AS

Penting: Pastikan Anda memiliki izin Pengelolaan Akun untuk menyelesaikan konfigurasi untuk Izin dan GDPR Uni Eropa, peraturan Negara Bagian AS, dan Platform Pesan Pengguna. Lihat Mengelola akses pengguna ke akun Anda untuk mengetahui detailnya.

Ikuti langkah-langkah di Setelan peraturan Eropa dan Setelan peraturan negara bagian AS untuk menambahkan PubMatic ke daftar partner iklan peraturan Eropa dan negara bagian AS di UI AdMob.

Langkah 3: Impor SDK dan adaptor PubMatic OpenWrap SDK

Catatan: Kegagalan dalam mengintegrasikan versi PubMatic dan Google Mobile Ads SDK for React Native yang kompatibel dapat menyebabkan masalah build.

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

1. Salin file tar adaptor Google Mobile Ads SDK for React Native dari direktori gma-sdk-react-native/adapters/pubmatic/ 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/pubmatic/gma-mediation-pubmatic-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-pubmatic-0.1.0.tgz
   

   benang

   yarn add ./local_packages/gma-mediation-pubmatic-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://repo.pubmatic.com/artifactory/public-repos")
       }
   }
   

Langkah 4: Terapkan setelan privasi di PubMatic OpenWrap SDK

Izin Uni Eropa dan GDPR

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.

PubMatic OpenWrap SDK React Native adapter versi 0.1.0 dan yang lebih baru mendukung penerusan sinyal izin GDPR dari platform pengelolaan izin yang terintegrasi dengan Transparency and Consent Framework (TCF) IAB ke PubMatic OpenWrap SDK. Untuk informasi selengkapnya, lihat Meneruskan GDPR dan izin GDPR.

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.

PubMatic otomatis membaca izin CCPA yang ditetapkan oleh platform pengelolaan izin yang mendukung spesifikasi Izin Tambahan Google, termasuk UMP SDK. Untuk mengetahui informasi selengkapnya, lihat Menetapkan String CCPA.

Langkah 5: Tambahkan kode yang diperlukan

Android

Tidak diperlukan kode tambahan untuk integrasi PubMatic.

iOS

Integrasi SKAdNetwork

Ikuti dokumentasi PubMatic OpenWrap SDK 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.

Penting: Nonaktifkan mode pengujian untuk AdMob dan PubMatic OpenWrap SDK sebelum merilis aplikasi Anda.

Memverifikasi iklan pengujian

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

Kode error

Jika adaptor gagal menerima iklan dari PubMatic, penayang dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo di bagian class berikut:

Android

com.pubmatic.sdk
com.google.ads.mediation.pubmatic

iOS

GADMediationAdapterPubMatic

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

Android

Kode error	Domain	Alasan
101	com.google.ads.mediation.pubmatic	Konfigurasi server tidak memiliki ID penayang yang diperlukan.
102	com.google.ads.mediation.pubmatic	Format iklan tidak didukung oleh PubMatic atau tidak ada dalam data sinyal RTB.
103	com.google.ads.mediation.pubmatic	Gagal menampilkan iklan karena iklan belum siap.
104	com.google.ads.mediation.pubmatic	ID Profil tidak ada atau tidak valid.
105	com.google.ads.mediation.pubmatic	ID Unit Iklan tidak ada atau kosong.
106	com.google.ads.mediation.pubmatic	Iklan Reward yang ditampilkan bernilai null.
107	com.google.ads.mediation.pubmatic	Ukuran iklan banner tidak valid.
1001-5002	Dikirim oleh PubMatic SDK	PubMatic SDK menampilkan error. Lihat dokumentasi PubMatic untuk mengetahui detail selengkapnya.

iOS

Kode error	Domain	Alasan
101	com.google.ads.mediation.pubmatic	Konfigurasi server tidak memiliki ID penayang yang diperlukan.
102	com.google.ads.mediation.pubmatic	Permintaan pengumpulan sinyal bidding gagal karena beberapa format, tidak ada format, atau format yang tidak didukung ditentukan dalam parameter permintaan.
103	com.google.ads.mediation.pubmatic	Konfigurasi iklan tidak valid untuk memuat iklan.
104	com.google.ads.mediation.pubmatic	Gagal menampilkan iklan interstisial karena iklan belum siap.
105	com.google.ads.mediation.pubmatic	Gagal menampilkan iklan reward karena iklan belum siap.
106	com.google.ads.mediation.pubmatic	Gagal memuat salah satu sumber gambar iklan native.
107	com.google.ads.mediation.pubmatic	Konfigurasi iklan tidak memiliki ID penayang.
108	com.google.ads.mediation.pubmatic	Konfigurasi iklan tidak memiliki ID profil.
109	com.google.ads.mediation.pubmatic	Konfigurasi iklan berisi ID profil yang bukan angka.
110	com.google.ads.mediation.pubmatic	Konfigurasi iklan tidak memiliki ID unit iklan.
111	com.google.ads.mediation.pubmatic	PubMatic OpenWrap SDK gagal membuat instance ukuran iklan.
1001-5002	Dikirim oleh PubMatic SDK	PubMatic SDK menampilkan error. Lihat dokumentasi PubMatic untuk mengetahui detail selengkapnya.

Versi 0.1.0

• Rilis awal.

• Mendukung adaptor Android PubMatic versi 5.3.0.1.
• Mendukung adaptor iOS PubMatic versi 5.3.0.0.
• Dibuat dan diuji dengan Plugin React Native Google Mobile Ads versi 0.1.0.