Mengintegrasikan PubMatic dengan mediasi

Panduan ini menunjukkan cara menggunakan Google Mobile Ads Flutter Plugin untuk memuat dan menampilkan iklan dari PubMatic menggunakan mediasi, 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 Flutter.

Integrasi dan format iklan yang didukung

Adaptor mediasi Ad Manager untuk PubMatic memiliki kemampuan berikut:

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

Prasyarat

Sebelum melanjutkan, verifikasi hal berikut:

• Versi Google Mobile Ads Flutter Plugin terbaru.
• Framework Flutter versi 3.7.0 atau yang lebih baru.
• Untuk men-deploy di Android
  • Level API Android 24 atau yang lebih baru.
• Untuk men-deploy di iOS
  • Target deployment iOS 13.0 atau yang lebih baru.
• Project Flutter yang berfungsi dan dikonfigurasi dengan Google Mobile Ads Flutter Plugin. Lihat Menyiapkan Google Mobile Ads Flutter Plugin untuk mengetahui detailnya.

Langkah 1: Siapkan konfigurasi di UI PubMatic OpenWrap SDK

Daftar atau Login ke akun PubMatic Anda dan 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.

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

Mengonfigurasi setelan mediasi untuk unit iklan Anda

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

Integrasi melalui pub.dev

(Khusus Android) Tambahkan repositori berikut ke file build.gradle di dalam direktori android project Anda:

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

Tambahkan dependensi berikut dengan versi terbaru SDK dan adaptor PubMatic OpenWrap SDK di file pubspec.yaml paket Anda:

dependencies:
  gma_mediation_pubmatic: ^2.5.0

Integrasi Manual

Download plugin mediasi Google Mobile Ads versi terbaru untuk PubMatic OpenWrap SDK, ekstrak file yang didownload, dan tambahkan folder plugin yang diekstrak (dan kontennya) ke project Flutter Anda. Kemudian, referensikan plugin di file pubspec.yaml Anda dengan menambahkan dependensi berikut:

dependencies:
  gma_mediation_pubmatic:
    path: path/to/local/package

Langkah 4: Terapkan setelan privasi di SDK 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 diteruskan 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 pemberian hak kepada pengguna untuk menolak "penjualan" "informasi pribadi" mereka (sebagaimana istilah tersebut didefinisikan oleh hukum ini), 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 otomatis membaca izin CCPA yang ditetapkan oleh platform pengelolaan izin yang mendukung spesifikasi Izin Tambahan Google, termasuk UMP SDK. Untuk mengetahui informasi selengkapnya, lihat Menyetel String CCPA.

Langkah 5: Tambahkan kode yang diperlukan

Langkah 6: Uji penerapan Anda

Mengaktifkan iklan pengujian

Pastikan Anda mendaftarkan perangkat pengujian 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.

Kode error

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

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

GADMediationAdapterPubMatic

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

Log Perubahan Adaptor Mediasi Flutter Pubmatic

Versi 2.5.1 (Dalam proses)

Versi 2.5.0

• Mendukung adaptor Android PubMatic versi 5.4.0.0.
• Mendukung adaptor iOS PubMatic versi 5.4.0.0.
• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 9.1.0.

Versi 2.4.0

• Mendukung adaptor Android PubMatic versi 5.3.0.0.
• Mendukung adaptor iOS PubMatic versi 5.3.0.0.
• Dibuat dan diuji dengan Plugin Google Mobile Ads Flutter versi 9.1.0.

Versi 2.3.1

• Diupdate untuk mendukung Plugin Flutter Google Mobile Ads versi 9.1.0.
• Menambahkan dukungan Swift Package Manager.
• Mendukung PubMatic Android adapter versi 5.2.0.0.
• Mendukung adaptor iOS PubMatic versi 5.2.0.0.
• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 9.1.0.

Versi 2.3.0

• Mendukung PubMatic Android adapter versi 5.2.0.0.
• Mendukung adaptor iOS PubMatic versi 5.2.0.0.
• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 9.1.0.

Versi 2.2.0

• Mendukung adaptor Android PubMatic versi 5.2.0.0.
• Mendukung PubMatic iOS adapter versi 5.1.1.0.
• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 9.0.0.

Versi 2.1.0

• Diperbarui untuk mendukung Plugin Flutter Google Mobile Ads versi 9.0.0
• Mendukung adaptor PubMatic Android versi 5.1.2.0.
• Mendukung adaptor iOS PubMatic versi 5.1.1.0.
• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 9.0.0.

Versi 2.0.0

• Memperbarui versi Flutter minimum ke 3.38.1
• Diperbarui untuk mendukung Plugin Flutter Google Mobile Ads versi 8.0.0
• Mendukung adaptor Android PubMatic versi 5.0.0.1.
• Mendukung adaptor iOS PubMatic versi 5.0.1.0.
• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 8.0.0.

Versi 1.6.0

• Mendukung adaptor Android PubMatic versi 4.12.0.0.
• Mendukung adaptor iOS PubMatic versi 4.12.0.0.
• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 7.0.0.

Versi 1.5.0

• Memperbarui versi Flutter minimum menjadi 3.35.1
• Diupdate untuk mendukung Plugin Flutter Google Mobile Ads versi 7.0.0
• Mendukung adaptor Android PubMatic versi 4.11.0.1.
• Mendukung PubMatic iOS adapter versi 4.11.0.1.
• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 7.0.0.

Versi 1.4.1

• Mendukung adaptor Android PubMatic versi 4.10.0.1.
• Mendukung adaptor iOS PubMatic versi 4.10.0.0.
• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

Versi 1.4.0

• Mendukung adaptor PubMatic Android versi 4.10.0.0.
• Mendukung adaptor iOS PubMatic versi 4.10.0.0.
• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

Versi 1.3.0

• Mendukung adaptor Android PubMatic versi 4.9.1.0.
• Mendukung adaptor iOS PubMatic versi 4.9.0.0.
• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

Versi 1.2.0

• Mendukung PubMatic Android Adapter versi 4.9.1.0.
• Mendukung PubMatic iOS adapter versi 4.8.0.0.
• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

Versi 1.1.0

• Mendukung PubMatic Android adapter versi 4.8.0.0.
• Mendukung adaptor iOS PubMatic versi 4.8.0.0.
• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.

Versi 1.0.0

• Rilis awal.
• Mendukung PubMatic Android adapter versi 4.7.1.1.
• Mendukung adaptor iOS PubMatic versi 4.7.0.0.
• Dibuat dan diuji dengan Plugin Flutter Google Mobile Ads versi 6.0.0.