Aktifkan pengukuran konversi

Pengukuran atribusi konversi dapat melibatkan banyak pihak, mulai dari penayang, pengiklan, teknologi iklan penayangan (entitas yang menayangkan iklan), penyedia pengukuran, dan lainnya. Dalam dokumen ini, kami menggambarkan skenario pengukuran konversi yang umum, tetapi secara umum, setiap pihak yang ingin menerima laporan atribusi dari Attribution Reporting API (ARA) harus memastikan bahwa langkah-langkah integrasi yang dijelaskan dalam dokumen ini diikuti.

Misalnya, umumnya penayang memiliki satu atau beberapa teknologi iklan yang bertanggung jawab untuk menayangkan iklan — hal ini dapat mencakup pihak yang bertanggung jawab menyediakan markup untuk materi iklan, pihak yang menyediakan tayangan iklan atau piksel pelacakan pada materi iklan, dan pihak yang menyediakan SDK atau tag untuk slot iklan di halaman penayang. Teknologi iklan ini mungkin ingin atau tidak ingin menerima laporan atribusi dari ARA, tetapi diposisikan untuk memastikan teknologi iklan downstream dapat menerima laporan atribusi.

Selain itu, pengiklan juga dapat menggunakan penyedia pengukuran konversi pihak ketiga untuk atribusi lintas jaringan serta kemampuan pelaporan lainnya. Pengiklan menggunakan data tersebut untuk memahami laba atas investasi iklan di beberapa penayang dan saluran yang unik, jadi penting bagi DSP atau server iklan untuk memahami cara mengaktifkan Attribution Reporting API untuk mendukung kasus penggunaan ini. Pengiklan yang ingin menggunakan pihak ketiga dapat terus melakukannya, baik dengan menggunakan penyedia pengukuran pihak ketiga atau dengan menyiapkan server internal untuk mendaftarkan dan menerima laporan dari API.

Attribution Reporting API memungkinkan beberapa teknologi iklan mendaftarkan sumber atribusi dan pemicu untuk tayangan iklan atau konversi yang sama dan menerima laporan terpisah dari API. Misalnya, DSP dapat menerima laporan atribusinya sendiri dari Attribution Reporting API serta mengizinkan pelaporan terpisah untuk penyedia pengukuran pihak ketiga pengiklan. Teknologi iklan harus mendaftarkan sumber atribusi dan pemicu untuk menerima laporan dari API, dan atribusi dilakukan di antara sumber atribusi dan pemicu yang telah didaftarkan satu per satu oleh teknologi iklan dengan API.

Skenario pengukuran konversi yang umum

Di bagian ini, kita akan memeriksa dua skenario umum untuk pengukuran konversi.

Skenario 1: Teknologi iklan penayangan dan penyedia pengukuran pihak ketiga harus menerima laporan dari Attribution Reporting API

Pengiklan ingin mengatribusikan konversi pada inventaris iklan menggunakan penyedia pengukuran pihak ketiga, dan teknologi iklan yang menghosting materi iklan ingin mengatribusikan konversi di inventaris iklan. Hal ini umum terjadi bagi DSP atau server iklan pengiklan (server iklan pihak ketiga — 3PAS) yang menyediakan markup untuk materi iklan, menjalankan pelaporan atribusi mereka sendiri, dan bekerja sama dengan pengiklan yang berintegrasi dengan penyedia pengukuran atau analisis pihak ketiga.

Dalam hal ini, teknologi iklan penayangan juga merupakan pihak yang bertanggung jawab untuk mengaktifkan peristiwa klik dan tayangan dalam penyiapan saat ini. Teknologi iklan penayangan harus menetapkan attributionsrc baru di lokasi yang sesuai dan memastikan pengalihan telah dikonfigurasi dengan benar. Selain itu, teknologi iklan penayangan dan penyedia pengukuran pihak ketiga harus memastikan bahwa keduanya terdaftar dan servernya siap menerima dan merespons permintaan Attribution Reporting API.

Penyiapan kampanye umum dapat terlihat seperti:

  1. Server iklan pengiklan (3PAS) menyediakan markup untuk materi iklan ke DSP, yang mencakup piksel pelacakan klik dan tayangan penyedia pengukuran pihak ketiga. Server iklan harus memastikan attributionsrc disertakan dalam markup materi iklan.

  2. DSP menawarkan kemampuan untuk menambahkan tayangan pengukuran dan piksel pelacakan klik tambahan, serta harus memastikan attributionsrc disertakan dalam markup materi iklan final yang digunakannya untuk bidding.

Skenario 2: Hanya penyedia pengukuran pihak ketiga yang perlu menerima laporan dari Attribution Reporting API

Pengiklan ingin mengatribusikan konversi pada inventaris iklan menggunakan penyedia pengukuran pihak ketiga, tetapi teknologi iklan yang menghosting materi iklan tidak memiliki persyaratan pengukuran atribusi. Hal ini umum terjadi bagi penayang, SSP, atau server iklan penayang yang menghosting materi iklan dan tidak berencana menggunakan pelaporan atribusi itu sendiri, tetapi ingin mengaktifkan Attribution Reporting API untuk partner DSP mereka, atau untuk perusahaan pemberian tag pengukuran seperti server iklan pihak ketiga, penyedia pengukuran, atau analisis.

Dalam hal ini, pihak yang bertanggung jawab untuk mengaktifkan peristiwa klik dan tayangan iklan dalam penyiapan saat ini harus menambahkan atribut attributionsrc baru ke materi iklan dan memastikan pengalihan berfungsi sebagaimana mestinya. Hal ini sangat bergantung pada integrasi setiap penayang, tetapi untuk peristiwa klik, hal ini bisa berupa SSP, teknologi iklan penayangan, atau penayang itu sendiri. Untuk peristiwa tayangan iklan, penyedia ini biasanya adalah penyedia pengukuran pihak ketiga.

Pada contoh penyiapan kampanye standar dari Skenario 1, server iklan penayang, SSP, atau penayang itu sendiri mungkin hanya perlu memastikan bahwa atribut attributionsrc yang diberikan oleh DSP masuk ke halaman penayang.

Detail implementasi

Tabel berikut menjelaskan langkah-langkah penerapan Attribution Reporting API di tingkat tinggi:

Langkah Tanggung jawab pekerjaan Contoh
Langkah 1: Aktifkan sumber atribusi untuk materi iklan dan kode pengukuran yang ada Entitas yang bertanggung jawab untuk mengaktifkan peristiwa tayangan atau menangani peristiwa klik menambahkan atribut attributionsrc. Untuk peristiwa klik, biasanya pembeli (server iklan DSP/pengiklan) yang merender materi iklan akan menambahkan atribut tersebut.

Untuk peristiwa tayangan, platform sisi permintaan (DSP), platform sisi suplai (SSP), penayang, server iklan, atau penyedia pengukuran akan menambahkan atribut tersebut, dan hal tersebut bergantung pada penyiapan penayang.

Untuk iklan video yang menggunakan format VAST, SDK video dan penayang menambahkan atribut ini.
Langkah 2: Aktifkan Attribution Reporting untuk origin pihak ketiga Cara ini akan langsung berfungsi jika menggunakan jalur pengalihan yang sudah ada dengan pengalihan 302.

Jika pengalihan 302 tidak dapat digunakan, atribut attributionsrc dapat digunakan untuk mencantumkan beberapa server teknologi iklan.

 Umumnya, selama atribut attributionsrc ditambahkan ke materi iklan, pengalihan pihak ketiga akan menerima panggilan Attribution Reporting API.
Langkah 3: Menyiapkan respons untuk permintaan Attribution Reporting API Setiap entitas yang ingin menerima laporan dari Attribution Reporting API DSP dan penyedia pengukuran pihak ketiga yang digunakan oleh pengiklan

Perlu diperhatikan bahwa detail setiap langkah bergantung pada cara materi iklan dirender dan ditayangkan di halaman penayang, dan entitas teknologi iklan mana yang menerima laporan yang dikirim oleh Attribution Reporting API.

Langkah 1: Aktifkan sumber atribusi untuk materi iklan dan kode pengukuran yang ada

Pada langkah pertama, sumber atribusi diaktifkan.

Cara kerja atribut attributionsrc

Atribut attributionsrc baru menentukan tujuan pengiriman permintaan Attribution Reporting API. Entitas yang bertanggung jawab untuk mengaktifkan peristiwa klik dan tayangan iklan harus memperbarui materi iklan dengan atribut attributionsrc. attributionsrc harus ditambahkan ke peristiwa klik dan tayangan yang ada, serta dapat kosong atau tidak kosong.

Untuk peristiwa klik yang menggunakan pengalihan, atribut attributionsrc harus ditambahkan ke navigasi. Semua pengalihan 302 setelah navigasi tidak perlu menambahkan atribut attributionsrc dan akan memenuhi syarat untuk ARA selama navigasi awal telah menambahkan attributionsrc.

Jika attributionsrc kosong, permintaan ARA akan dikirim ke URL yang ditentukan di atribut href tag anchor (URL klik-tayang). Saat atribut attributionsrc ditentukan, permintaan ARA akan dikirim ke URL yang ditentukan dalam atribut attributionsrc. URL klik-tayang juga memenuhi syarat untuk mendaftarkan sumber.

Umumnya, gunakan atribut attributionsrc kosong jika server yang menghosting URL klik-tayang dapat menerima dan merespons permintaan Attribution Reporting API. Tentukan URL attributionsrc Anda sendiri jika ingin permintaan Attribution Reporting API mengarah ke server lain.

Contoh atribut attributionsrc kosong:

Konfigurasi yang ada Dengan integrasi ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>

Jika atribut attributionsrc kosong, permintaan Attribution Reporting API akan dikirim ke URL yang ditentukan oleh atribut href tag anchor.

Contoh atribut attributionsrc yang tidak kosong:

Konfigurasi yang ada Dengan integrasi ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc="[ATTRIBUTION_SRC_URL]">...</a>

Jika attributionsrc tidak kosong, permintaan Attribution Reporting API akan dikirim ke URL yang ditentukan oleh tag attributionsrc. URL klik-tayang juga memenuhi syarat untuk mendaftarkan sumber.

Menambahkan attributionsrc untuk peristiwa klik dan tayangan

  • Peristiwa klik:
    • Entitas yang bertanggung jawab untuk menambahkan attributionsrc biasanya adalah teknologi iklan penayangan.
    • Tag anchor dengan peristiwa klik harus memiliki atribut attributionsrc yang ditambahkan.
    • Klik yang menggunakan window.open harus menggunakan argumen windowFeatures dari panggilan window.open untuk menentukan sumber atribusi.
  • Peristiwa tayangan:
    • Entitas yang bertanggung jawab untuk menambahkan attributionsrc biasanya adalah teknologi iklan penayangan dan penyedia pengukuran.
    • Peristiwa tayangan yang diaktifkan dari tag <img> atau tag <script> harus menyertakan atribut attributionsrc.
    • Peristiwa tayangan yang menggunakan Fetch API harus menyertakan objek attributionReporting dalam argumen options yang diteruskan ke panggilan API pengambilan.

Lihat tabel berikut untuk ringkasan perubahan yang diperlukan untuk peristiwa klik dan tayangan:

Acara Tag Konfigurasi yang ada Setelah integrasi ARA
Klik HTML <a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
JavaScript window.open("[CLICKTHROUGH_URL]", "_blank"); window.open("[CLICKTHROUGH_URL]", "_blank", "attributionsrc");
Tayangan Tag <img> HTML <img src="[IMPRESSION_URL]"> <img src="[IMPRESSION_URL]" attributionsrc>
Tag <script> HTML <script src="[IMPRESSION_URL]"></script> <script src="[IMPRESSION_URL]" attributionsrc></script>
JavaScript const options = {...}
window.fetch("[IMPRESSION_URL]", options); 		const options = {
  attributionReporting: {
    eventSourceEligible: true,
    triggerEligible: false,
  },
  ...
};
window.fetch("[IMPRESSION_URL]", options);

Mengaktifkan pendaftaran sumber atribusi dalam lelang Protected Audience

Untuk mengukur konversi di lelang Protected Audience, daripada menggunakan attributionsrc, Anda dapat menggunakan registerAdBeacon/registerAdMacro dan setReportEventDataForAutomaticBeacons/reportEvent untuk mengaktifkan pendaftaran sumber atribusi.

Untuk melaporkan sinyal Protected Audience, fungsi registerAdBeacon tersedia di dalam worklet pelaporan, dan registerAdMacro tersedia dalam worklet pelaporan kemenangan pembeli. Kemudian, data peristiwa di dalam frame iklan dapat ditambahkan ke beacon dan makro terdaftar dengan fungsi reportEvent dan setReportEventDataForAutomaticBeacons dari Fenced Frame Ads Reporting API. Hal ini memungkinkan sinyal worklet pelaporan Protected Audience dan payload peristiwa frame materi iklan dikaitkan satu sama lain.

Header HTTP Attribution-Reporting-Eligible ditambahkan ke permintaan saat beacon dan makro dipicu oleh panggilan reportEvent dari sebuah frame, atau beacon otomatis dipicu oleh browser. Anda dapat menggunakan respons beacon untuk mendaftarkan sumber atribusi. Permintaan beacon mungkin dialihkan untuk mengizinkan pengukuran pihak ketiga.

Untuk mempelajari lebih lanjut, lihat bagian Dukungan untuk Attribution Reporting dari penjelasan Fenced Frame Ad Reporting API.

Mengaktifkan pelaporan atribusi untuk format VAST

VAST adalah format umum untuk menayangkan dan mengukur inventaris iklan video, dan banyak peristiwa yang ditentukan dalam standar tersebut harus dianggap sebagai peristiwa sumber potensial yang memenuhi syarat untuk didaftarkan dengan Attribution Reporting API. Adendum VAST untuk Dukungan Pelaporan Atribusi membahas hal ini secara mendetail, tetapi secara singkat, semua peristiwa <Tracking>, <Impression>, <*ClickThrough>, dan <*ClickTracking> merupakan peristiwa sumber atribusi potensial. Semua penerapan VAST harus menyediakan cakupan kelayakan pendaftaran untuk peristiwa ini.

Adendum VAST menentukan atribut baru untuk elemen ini guna memungkinkan setelan URL sekunder khusus untuk pendaftaran atribusi. Saat peristiwa berisi attributiontype="DOUBLE_PING" dan attributionsrc="[URL]", kode yang mengaktifkan peristiwa tersebut harus menggunakan [URL] sebagai nilai atribut attributionsrc saat mengaktifkan Attribution Reporting API. Adendum VAST berisi contoh untuk setiap skenario.

Untuk memastikan cakupan maksimum, penerapan VAST harus membuat semua peristiwa yang tercantum memenuhi syarat secara default saat mengaktifkan ping peristiwa. Misalnya, saat mengaktifkan URL peristiwa <Impression>, atribut attributionsrc (kosong) harus digunakan di elemen <img> yang digunakan untuk mengirim permintaan (atau yang setara pada panggilan ambil), agar selalu memungkinkan pihak penerima mendaftarkan peristiwa tersebut secara potensial dengan Attribution Reporting API.

Langkah 2: Aktifkan Attribution Reporting untuk origin pihak ketiga

Untuk mengizinkan pihak ketiga menggunakan Attribution Reporting API, Anda dapat menggunakan pengalihan yang ada atau menambahkan daftar pihak ketiga ke atribut attributionsrc. Pada umumnya, setiap teknologi iklan memiliki pelacak tayangan iklan independen, sehingga pengalihan lebih relevan untuk pelacak klik.

Menangani origin pihak ketiga dalam rantai pengalihan yang ada

Dalam klik-tayang iklan biasa, banyak pelacak klik mungkin ditampilkan sebagai rangkaian pengalihan 302 yang dibuat sebagai bagian dari navigasi ke halaman landing akhir. Setiap permintaan dalam rantai pengalihan memenuhi syarat untuk didaftarkan ke Attribution Reporting API jika target klik asli dianotasikan dengan attributionsrc atau didaftarkan ke registerAdBeacon/registerAdMacro di Protected Audience API. Teknologi iklan dalam rantai pengalihan juga harus terdaftar.

Perhatikan bahwa isi permintaan awal tidak dikirim saat pengalihan. Untuk lelang Protected Audience, jika eventData diteruskan ke reportEvent dan setReportEventDataForAutomaticBeacons harus digunakan sebagai bagian dari pengalihan, URL tersebut harus diteruskan secara eksplisit sebagai bagian dari URL alihan.

Pada contoh berikut, kami akan menggunakan teknologi iklan penayangan (serving-adtech.example) dan penyedia pengukuran pihak ketiga (3p-measurement.example) sebagai dua entitas berbeda yang ingin membuat dan menerima laporan atribusi. Teknologi iklan penayangan dalam contoh ini dapat berupa DSP yang merender materi iklan di situs penayang, dan memiliki produk pelaporannya sendiri. Penyedia pengukuran pihak ketiga dapat berupa entitas yang digunakan pengiklan untuk pelaporan konversi.

Diagram yang menjelaskan cara pihak pertama mendaftarkan sumber, lalu pihak ketiga mendaftarkan

Pada waktu pendaftaran sumber, langkah-langkah berikut akan dilakukan:

  1. serving-adtech.example menetapkan atribut attributionsrc di materi iklan.Pengguna mengunjungi halaman penayang, dan browser mengirim permintaan ke serving-adtech.example.
  2. serving-adtech.example merespons dengan header Attribution-Reporting-Register-Source dan header Location.
    1. serving-adtech.example menggunakan header Attribution-Reporting-Register-Source untuk merespons dengan metadata tentang sumber yang akan didaftarkan.
    2. serving-adtech.example menggunakan header Location untuk menyertakan pengalihan ke 3p-measurement.example. Perhatikan bahwa kemungkinan header Location telah digunakan dalam alur pelacakan klik yang ada untuk mendukung pengalihan 302 ke pihak ketiga.
  3. Browser menerima respons dari serving-adtech.example dan mengurai header Attribution-Reporting-Register-Source. Browser menyimpan peristiwa sumber, menggunakan serving-adtech.example sebagai asal pelaporan.
  4. Karena permintaan ini adalah pengalihan, browser juga membuat permintaan baru ke 3p-measurement.example.
  5. 3p-measurement.example merespons dengan respons yang berisi header Attribution-Reporting-Register-Source.
  6. Browser menerima respons ini dari 3p-measurement.example dan membaca Attribution-Reporting-Register-Source. Browser menyimpan peristiwa sumber, menggunakan 3p-measurement.example sebagai asal pelaporan.

Gunakan attributionsrc untuk origin pihak ketiga yang tidak ada dalam rantai pengalihan

Jika beberapa asal reporter ingin mendaftarkan sumber pada peristiwa navigasi, tetapi tidak dapat muncul di rantai pengalihan karena alasan apa pun, Anda dapat mencantumkan beberapa situs sebagai sumber atribusi di attributionsrc sebagai solusi alternatif.

Konfigurasi yang ada Dengan modifikasi ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc="[REPORTING_URL_1] [REPORTING_URL_2]">...</a>

Dalam contoh ini, permintaan yang memenuhi syarat Attribution Reporting API akan dikirim ke REPORTING_URL_1 dan REPORTING_URL_2. Permintaan navigasi yang dikirim ke URL klik-tayang juga memenuhi syarat untuk mendaftarkan sumber atribusi.

Langkah 3: Menyiapkan respons untuk permintaan Attribution Reporting API

Untuk semua origin yang menerima permintaan Attribution Reporting API, pastikan server merespons dengan header Attribution-Reporting-Register-Source yang sesuai. Lihat panduan Sumber pendaftaran dan penjelasan untuk mempelajari cara menyusun respons.

Mendaftarkan beberapa pemicu

Anda dapat mendaftarkan beberapa pemicu atribusi dengan menambahkan beberapa elemen piksel di sisi konversi (satu elemen per pemicu). Elemen attributionsrc bersifat opsional untuk pendaftaran pemicu.

Anda juga dapat mendaftarkan beberapa pemicu dari satu elemen piksel menggunakan permintaan pengalihan atau mencantumkan beberapa URL dalam elemen attributionsrc dengan cara yang sama seperti untuk pendaftaran sumber. Peristiwa sumber dan peristiwa pemicu yang telah dibuat oleh origin yang sama akan dicocokkan.