Panduan Integrasi Protected Audience (sebelumnya FLEDGE) untuk Penyedia Pengukuran

Sebagai bagian dari Privacy Sandbox, Chrome mengusulkan Audiens yang Dilindungi API—API dalam browser yang memungkinkan pengiklan dan perusahaan teknologi iklan menampilkan iklan bertarget grup minat tanpa mengandalkan cookie pihak ketiga, sekaligus melindungi pengguna dari pelacakan.

Di Protected Audience API, saat iklan pemasaran ulang memenangkan lelang, render URL iklan akan dikirim ke Pagar Frame untuk proses rendering. Bingkai dengan {i>fence<i} adalah elemen HTML yang diusulkan untuk konten yang disematkan, mirip dengan iframe. Tidak seperti iframe, frame dengan fence membatasi komunikasi dengan konteks embedding, agar frame dapat mengakses data lintas situs tanpa dan membagikannya dengan konteks embedding. Untuk detail selengkapnya, lihat Kasus penggunaan Fenced Frames penjelasan.

Layar & Video 360 mendukung daftar makro untuk pengukuran yang digunakan untuk pelacakan tayangan dan klik. Hanya sebagian kecil dari makro dapat diganti sebagai bagian dari rendering materi iklan, karena kurangnya dan sinyal lelang. Misalnya, ${PUBLISHER_ID} akan berhenti berfungsi tanpa perubahan ke tag penyedia pengukuran.

Panduan ini dirancang untuk partner pengukuran iklan yang melacak peristiwa bagi pengiklan yang gunakan Display & Video 360

Pendaftaran

Mulai Agustus 2023, penyedia pengukuran mungkin harus mengikuti langkah-langkah berikut di bawah ini untuk mendaftarkan diri agar dapat menggunakan Fenced Frame Reporting API di Protected API Audiens.

Detail tentang bagaimana dan siapa yang perlu daftar

Integrasi

Tag tayangan penyedia pengukuran

Petunjuk penyiapan:

Tag skrip Contoh 
<script src='https://tracking.com/a.js'>xxx</script>
 Tanggung jawab: Penyedia pengukuran untuk memperbarui tag skrip yang akan digunakan reportEvent API untuk pelacakan tayangan (lihat panduan di bawah).
Tag Img Contoh 
<img src='https://tracking.com/'>
 Tanggung jawab: Tampilan & Video 360 untuk memperbarui tag img src yang akan digunakan reportEvent API untuk pelacakan tayangan.

API reportEvent

API ini diusulkan untuk digunakan dalam pelacakan pasca-rendering saja. API ini berisi dua bagian: registerAdMacro dan reportEvent.

  • Layar & Video 360 memiliki fungsi registerAdMacro di reportWin. Tujuan akan mendaftarkan pasangan nilai kunci makro di browser sebelum proses rendering.
  • Tergantung pada jenis tag, kampanye Display & Video 360 atau penyedia pengukuran memiliki perubahan pada tag 3PAT untuk menggunakan reportEvent API.

reportEvent hanya menggunakan 1 input 'destinationURL', yang mengarah ke server penyedia pengukuran. Objek ini dapat berisi makro apa pun yang tercantum di Layar & Bantuan Video 360 Google. Contoh:

window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

Saat Chrome mengaktifkan ping URL dalam fungsi, Chrome akan mencari yang terdaftar makro dan menggantinya dengan nilai sebelum mengirim permintaan GET HTTP ke https://adtech.example.

Langkah-langkah untuk memperbarui tag skrip

Tidak akan ada perubahan pada tag materi iklan yang sudah ada. Layar & Gambar diam Video 360 merender tag penyedia pengukuran tanpa modifikasi sebagai bagian dari materi iklan payload. Saat penyedia pengukuran menerima ping tayangan iklan dari Konteks Audience API, mereka harus mengikuti langkah-langkah di bawah ini untuk tayangan pelacakan:

  1. Siapkan URL tayangan penyedia pengukuran untuk menerima ping tayangan. Contoh:

    https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123

  2. Menambahkan reportEvent JS saat merespons skrip dari Protected API Audiens. Contoh:

    window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

  3. Mencatat tayangan saat menerima ping dari URL tayangan yang dikonfigurasi di langkah 1.

Tag klik penyedia pengukuran

Tag klik penyedia pengukuran yang ada akan terus berfungsi untuk tayangan iklan Protected Audience. Layar & Video 360 akan menggunakan Fenced Frames Ads Reporting API reserved.top_navigation beacon untuk mendaftarkan klik, dan akan merangkai semua pelacak klik penyedia pengukuran sebagai pengalihan. Untuk detail selengkapnya, lihat Dokumentasi Chrome untuk Pelaporan Iklan Frame Berpagar Google Cloud Platform.