Mengintegrasikan PubMatic OpenWrap (Beta) dengan Mediasi AdMob

Panduan ini menunjukkan cara menggunakan GMA Next-Gen SDK untuk memuat dan menampilkan iklan dari PubMatic menggunakan Mediasi AdMob, yang mencakup integrasi waterfall dan bidding. Panduan ini membahas cara menambahkan PubMatic OpenWrap SDK ke konfigurasi mediasi unit iklan, serta cara mengintegrasikan PubMatic OpenWrap SDK dan adaptor ke dalam aplikasi Android.

Integrasi dan format iklan yang didukung

Adaptor mediasi untuk PubMatic memiliki kemampuan berikut:

Integrasi
Bidding
Air Terjun	^1
Format
Layar pembuka aplikasi
Banner
Interstisial
Reward
Interstisial Reward
Native

¹ Integrasi waterfall masih dalam versi alfa.

Prasyarat

Sebelum melanjutkan, pastikan hal berikut:

• Android API level 24 atau yang lebih baru.

• Versi GMA Next-Gen SDK terbaru.

• Siapkan Mediasi AdMob.

Langkah 1: Siapkan konfigurasi di UI PubMatic

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.

Di bagian Integration Path, pilih Android (Java / Kotlin) 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 Ad Units, pilih aplikasi yang Anda buat di bagian sebelumnya, lalu klik tombol Create Ad Unit.

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 di UI AdMob

Mengonfigurasi setelan mediasi untuk unit iklan Anda

Anda harus menambahkan PubMatic OpenWrap SDK ke konfigurasi mediasi untuk unit iklan Anda.

Pertama, login ke akun AdMob Anda. Selanjutnya, buka tab Mediasi. Jika Anda memiliki grup mediasi yang ingin diubah, klik nama grup mediasi tersebut untuk mengeditnya, dan lanjutkan ke Menambahkan PubMatic OpenWrap SDK sebagai sumber iklan.

Untuk membuat grup mediasi baru, pilih Buat Grup Mediasi.

Masukkan format dan platform iklan Anda, lalu klik Lanjutkan.

Beri nama grup mediasi Anda, lalu pilih lokasi yang akan ditarget. Selanjutnya, tetapkan status grup mediasi ke Aktif, lalu klik Tambahkan Unit Iklan.

Kaitkan grup mediasi ini dengan satu atau beberapa unit iklan AdMob yang ada. Kemudian, klik Done.

Sekarang Anda akan melihat kartu unit iklan diisi dengan unit iklan yang Anda pilih:

Menambahkan PubMatic OpenWrap SDK sebagai sumber iklan

Bidding

Di bagian Sumber Iklan, temukan kartu Bidding, lalu pilih Tambahkan sumber iklan. Lalu, pilih PubMatic OpenWrap SDK .

Klik Konfirmasi & setuju, lalu klik Simpan.



Jika sudah memiliki pemetaan untuk PubMatic OpenWrap SDK, Anda dapat memilihnya. Jika tidak, klik Tambahkan pemetaan.



Selanjutnya, masukkan ID Unit Iklan OpenWrap yang diperoleh di bagian sebelumnya. Kemudian, klik Done.

Penting: ID Penayang OpenWrap dan ID Profil OpenWrap harus dikaitkan dengan aplikasi yang ditargetkan seperti di UI PubMatic OpenWrap SDK.

Air Terjun

Di bagian kartu Waterfall di bagian Ad Sources, pilih Add Ad Source.

Pilih PubMatic OpenWrap SDK. Kemudian, masukkan nilai eCPM untuk PubMatic OpenWrap SDK, lalu klik Lanjutkan.

Catatan: Anda hanya perlu menyiapkan pengoptimalan sumber iklan sekali per jaringan.

Jika sudah memiliki pemetaan untuk PubMatic OpenWrap SDK, Anda dapat memilihnya. Jika tidak, klik Tambahkan pemetaan.



Selanjutnya, masukkan ID Unit Iklan OpenWrap yang diperoleh di bagian sebelumnya. Kemudian, klik Done.

Penting: ID Penayang OpenWrap dan ID Profil OpenWrap harus dikaitkan dengan aplikasi yang ditargetkan seperti di UI PubMatic OpenWrap SDK.

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 PubMatic OpenWrap SDK dan adaptor

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

Integrasi Android Studio (direkomendasikan)

Dalam file settings.gradle.kts level project, tambahkan repositori berikut:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://repo.pubmatic.com/artifactory/public-repos")
    }
  }
}

Kemudian, di file build.gradle.kts level aplikasi, tambahkan dependensi dan konfigurasi implementasi berikut. Gunakan SDK dan adaptor PubMatic OpenWrap SDK versi terbaru:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0")
    implementation("com.google.ads.mediation:pubmatic:5.4.1.0")
}

configurations {
    all {
        exclude(group = "com.google.android.gms", module = "play-services-ads")
        exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
    }
}

Langkah 4: Terapkan setelan privasi di PubMatic

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 Android PubMatic OpenWrap SDK versi 4.7.0.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 GPP yang ditetapkan oleh platform pengelolaan izin yang mendukung spesifikasi Izin Tambahan Google, termasuk UMP SDK. Untuk informasi selengkapnya, lihat Meneruskan izin GPP.

Langkah 5: Tambahkan kode yang diperlukan

Tidak diperlukan kode tambahan untuk integrasi PubMatic OpenWrap SDK.

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.

Langkah Opsional

Iklan native

Rendering iklan

Adaptor PubMatic menampilkan iklan native-nya sebagai objek NativeAd . Kolom ini mengisi kolom berikut untuk NativeAd.

Kolom	Aset yang selalu disertakan oleh adaptor PubMatic
Judul
Gambar
Isi
Ikon
Pesan ajakan (CTA)
Rating bintang
Toko
Harga
Pengiklan

Kode error

Jika adaptor gagal menerima iklan dari PubMatic, Anda dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo.getAdSourceResponses() di class berikut:

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

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

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.

Log Perubahan Adaptor Mediasi Android PubMatic

Versi Berikutnya

• Mengupdate adaptor untuk menggunakan InitializationCompleteCallback.onInitializationFailed(AdError) API.

Versi 5.4.1.0

• Mengupdate level API Android minimum yang diperlukan menjadi 24.
• Kompatibilitas terverifikasi dengan Pubmatic SDK 5.4.1.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 25.5.0.
• Google Mobile Ads Next-Gen SDK versi 1.5.0.
• Pubmatic SDK versi 5.4.1

Versi 5.4.0.0

• Kompatibilitas terverifikasi dengan Pubmatic SDK 5.4.0.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 25.4.0.
• Google Mobile Ads Next-Gen SDK versi 1.4.0.
• Pubmatic SDK versi 5.4.0

Versi 5.3.0.1

• Sematkan dependensi Kotlin adaptor ke 1.9.0 (versi Kotlin minimum yang didukung oleh GMA NextGen SDK).

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 25.4.0.
• Google Mobile Ads Next-Gen SDK versi 1.4.0.
• Pubmatic SDK versi 5.3.0

Versi 5.3.0.0

• Kompatibilitas terverifikasi dengan Pubmatic SDK 5.3.0.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 25.4.0.
• Google Mobile Ads Next-Gen SDK versi 1.4.0.
• Pubmatic SDK versi 5.3.0

Versi 5.2.0.0

• Kompatibilitas terverifikasi dengan Pubmatic SDK 5.2.0.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 25.4.0.
• Google Mobile Ads Next-Gen SDK versi 1.3.0.
• Pubmatic SDK versi 5.2.0

Versi 5.1.2.2

• Dipetakan AgeRestrictedTreatment ke COPPA API PubMatic.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 25.4.0.
• Google Mobile Ads Next-Gen SDK versi 1.2.1.
• Pubmatic SDK versi 5.1.2

Versi 5.1.2.1

• Menambahkan dukungan video iklan native(VAST) menggunakan PubMatic OpenWrapSDK MediaView API.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 25.2.0.
• Google Mobile Ads Next-Gen SDK versi 1.2.1.
• Pubmatic SDK versi 5.1.2

Versi 5.1.2.0

• Kompatibilitas terverifikasi dengan Pubmatic SDK 5.1.2.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 25.2.0.
• Google Mobile Ads Next-Gen SDK versi 1.1.0.
• Pubmatic SDK versi 5.1.2

Versi 5.1.1.0

• Kompatibilitas terverifikasi dengan Pubmatic SDK 5.1.1.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 25.2.0.
• Google Mobile Ads Next-Gen SDK versi 1.0.1.
• Pubmatic SDK versi 5.1.1

Versi 5.1.0.0

• Kompatibilitas terverifikasi dengan Pubmatic SDK 5.1.0.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 25.2.0.
• Pubmatic SDK versi 5.1.0

Versi 5.0.0.1

• Menambahkan properti untuk mem-build adaptor dengan dependensi GMA Next-Gen SDK.
• Memperbaiki bug yang menyebabkan objek mediationUtils tidak diinisialisasi.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 25.1.0.
• Pubmatic SDK versi 5.0.0

Versi 5.0.0.0

• Kompatibilitas terverifikasi dengan Pubmatic SDK 5.0.0.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 25.0.0.
• Pubmatic SDK versi 5.0.0

Versi 4.12.0.0

• Kompatibilitas terverifikasi dengan Pubmatic SDK 4.12.0.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.9.0.
• Pubmatic SDK versi 4.12.0

Versi 4.11.0.1

• Menambahkan dukungan untuk meneruskan parameter tagForUnderAgeOfConsent Google Mobile Ads SDK ke PubMatic SDK.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.9.0.
• Pubmatic SDK versi 4.11.0

Versi 4.11.0.0

• Kompatibilitas terverifikasi dengan Pubmatic SDK 4.11.0.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.9.0.
• Pubmatic SDK versi 4.11.0

Versi 4.10.0.1

• Menambahkan daftar aset untuk format iklan native waterfall.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.7.0.
• Pubmatic SDK versi 4.10.0

Versi 4.10.0.0

• Kompatibilitas terverifikasi dengan Pubmatic SDK 4.10.0.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.7.0.
• Pubmatic SDK versi 4.10.0

Versi 4.9.1.0

• Kompatibilitas terverifikasi dengan Pubmatic SDK 4.9.1.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.6.0.
• Pubmatic SDK versi 4.9.1

Versi 4.8.0.1

• Menambahkan dukungan untuk iklan interstisial waterfall.
• Menambahkan dukungan untuk iklan reward waterfall.
• Menambahkan dukungan untuk iklan banner waterfall.
• Menambahkan dukungan untuk iklan native waterfall.
• Kompatibilitas yang terverifikasi dengan Pubmatic SDK 4.8.0.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.6.0.
• Pubmatic SDK versi 4.8.0

Versi 4.8.0.0

• Kompatibilitas yang terverifikasi dengan Pubmatic SDK 4.8.0.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.4.0.
• Pubmatic SDK versi 4.8.0.

Versi 4.7.1.1

• Ukuran Tetap Ikon AdChoices

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.4.0.
• Pubmatic SDK versi 4.7.1.

Versi 4.7.1.0

• Kompatibilitas terverifikasi dengan Pubmatic SDK 4.7.1.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.4.0.
• Pubmatic SDK versi 4.7.1.

Versi 4.7.0.1

• Memperbaiki dependensi internal.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.4.0.
• Pubmatic SDK versi 4.7.0.

Versi 4.7.0.0

• Rilis awal.
• Menambahkan dukungan bidding untuk format iklan banner, interstisial, reward, dan native.
• Kompatibilitas terverifikasi dengan Pubmatic SDK 4.7.0.

Dibuat dan diuji dengan:

• Google Mobile Ads SDK versi 24.4.0.
• Pubmatic SDK versi 4.7.0.