Mengintegrasikan PubMatic OpenWrap (Beta) dengan mediasi

Panduan ini menunjukkan cara menggunakan Google Mobile Ads SDK (Legacy) untuk memuat dan menampilkan iklan dari PubMatic menggunakan mediasi, 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 waterfall masih dalam versi alfa.

Prasyarat

Sebelum Anda melanjutkan, verifikasi hal berikut:

• Level API Android 24 atau yang lebih baru.

• Versi Google Mobile Ads SDK (Legacy) terbaru.

• Menyiapkan mediasi.

Langkah 1: Siapkan konfigurasi di UI PubMatic

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

Menambahkan aplikasi baru

Buka tab Aplikasi, lalu klik tombol Tambahkan Aplikasi.

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

Di bagian Jalur Integrasi, pilih Android (Java / Kotlin) dan pilih AdMob - Bidding dengan SDK sebagai Jalur Sub-integrasi. 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, buat file app-ads.txt untuk Ad Manager.

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 di UI Ad Manager

Login ke akun Ad Manager Anda.

Menambahkan PubMatic OpenWrap SDK di Perusahaan

Aktifkan berbagi sinyal aman

Membagikan sinyal aman pada permintaan bid

Mengizinkan berbagi sinyal aman untuk Bidding dengan SDK

Mengonfigurasi bidding PubMatic OpenWrap SDK

Mengonfigurasi pemetaan unit iklan

Menambahkan PubMatic 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 PubMatic ke daftar partner iklan peraturan Eropa dan negara bagian AS di UI Ad Manager.

Langkah 3: Impor PubMatic OpenWrap SDK dan adaptor

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:pubmatic:5.4.1.0")
}

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.

PubMatic secara otomatis membaca setelan izin GDPR yang ditetapkan oleh platform pengelolaan izin yang mendukung spesifikasi Izin Tambahan Google, termasuk UMP 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 mengetahui 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 Ad Manager.

Memverifikasi iklan pengujian

Untuk memastikan 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. Fungsi ini mengisi kolom berikut untuk NativeAd.

Kode error

Jika adaptor gagal menerima iklan dari PubMatic, Anda dapat memeriksa error yang mendasarinya dari respons iklan menggunakan ResponseInfo.getAdapterResponses() 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:

Log Perubahan Adaptor Mediasi Android PubMatic

Versi 5.4.1.0

• Memperbarui 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 yang 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

• Memetakan 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 MediaView API PubMatic OpenWrapSDK.

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 yang 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 yang 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 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 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.