Mengintegrasikan PubMatic dengan bidding

Panduan ini menunjukkan cara menggunakan GMA Next-Gen SDK untuk memuat dan menampilkan iklan dari PubMatic menggunakan mediasi, yang mencakup integrasi waterfall dan bidding. Bagian ini membahas cara menambahkan PubMatic OpenWrap SDK ke konfigurasi mediasi unit iklan, dan 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.

² Semua format iklan lain yang didukung selain banner masih dalam versi alfa.

Persyaratan

• Level API Android 24 atau yang lebih tinggi

• GMA Next-Gen SDK terbaru.

• Selesaikan Panduan memulai mediasi.

Langkah 1: Siapkan konfigurasi di UI PubMatic

Daftar atau Login ke akun PubMatic Anda, lalu 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 Integration Path, pilih Android (Java / Kotlin) dan pilih AdMob - SDK Bidding sebagai Sub-integration Path. Kemudian, klik tombol Tambahkan Aplikasi.

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

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

ID Profil

Setelah aplikasi Anda dibuat, buka tab Aplikasi dan catat ID Profil aplikasi yang baru dibuat.

Buat unit iklan

Di tab Unit Iklan, pilih aplikasi yang Anda buat di bagian sebelumnya dan 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

Mengaktifkan 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 Amerika Serikat

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

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:pubmatic:5.0.0.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 diteruskan ke setiap sumber iklan dalam rantai mediasi Anda.

PubMatic secara otomatis membaca izin GDPR yang ditetapkan oleh platform pengelolaan izin yang mendukung spesifikasi Izin Tambahan Google, termasuk UMP SDK. Untuk mengetahui informasi selengkapnya, lihat Meneruskan izin GDPR dan GDPR.

Hukum privasi negara bagian Amerika Serikat

Hukum privasi negara bagian AS mewajibkan pemberian hak kepada pengguna untuk memilih tidak ikut "penjualan" "informasi pribadi" mereka (sebagaimana istilah tersebut didefinisikan oleh 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 rangkaian mediasi yang dapat berpartisipasi dalam penjualan informasi pribadi dan mengikuti panduan dari setiap jaringan tersebut untuk memastikan kepatuhan.

PubMatic secara otomatis membaca set 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 ada kode tambahan yang diperlukan untuk integrasi PubMatic OpenWrap SDK.

Langkah 6: Uji penerapan Anda

Mengaktifkan iklan pengujian

Pastikan Anda mendaftarkan perangkat pengujian Anda untuk Ad Manager.

Memverifikasi iklan percobaan

Untuk memverifikasi bahwa Anda menerima iklan percobaan 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 berikut diisi untuk NativeAd.

Kode error

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