Mengaktifkan pengukuran konversi

Pengukuran atribusi konversi dapat melibatkan beberapa pihak, mulai dari penayang, pengiklan, teknologi iklan penayangan (entitas yang menayangkan iklan), penyedia pengukuran, dan lainnya. Dalam dokumen ini, kami mengilustrasikan skenario pengukuran konversi umum, tetapi secara umum, pihak mana pun 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 — ini dapat mencakup pihak yang bertanggung jawab untuk menyediakan markup untuk materi iklan, pihak yang menyediakan tayangan iklan atau piksel pelacakan di 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 mungkin juga 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 unik, sehingga DSP atau server iklan harus 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 dan pemicu atribusi untuk tayangan 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 secara terpisah dengan API oleh teknologi iklan.

Skenario pengukuran konversi umum

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

Skenario 1: Teknologi iklan penayangan dan penyedia pengukuran pihak ketiga perlu 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 pada inventaris iklan. Hal ini umum terjadi pada DSP atau server iklan pengiklan (server iklan pihak ketiga — 3PAS) yang menyediakan markup untuk materi iklan, melakukan 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 memicu peristiwa klik dan tayangan dalam penyiapan saat ini. Teknologi iklan penayangan harus menetapkan attributionsrc baru di lokasi yang sesuai dan memastikan bahwa pengalihan dikonfigurasi dengan benar. Selain itu, teknologi iklan penayangan dan penyedia pengukuran pihak ketiga harus memastikan bahwa mereka terdaftar dan server mereka siap menerima serta merespons permintaan Attribution Reporting API.

Penyiapan kampanye standar dapat terlihat seperti ini:

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

  2. DSP menawarkan kemampuan untuk menambahkan piksel pelacakan klik dan tayangan pengukuran tambahan, serta harus memastikan attributionsrc disertakan dalam markup materi iklan akhir yang digunakan untuk mengajukan bid.

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 pada penayang, SSP, atau server iklan penayang yang menghosting materi iklan dan tidak berencana untuk menggunakan pelaporan atribusi 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 memicu peristiwa klik dan tayangan 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, ini dapat berupa SSP, teknologi iklan penayangan, atau penayang itu sendiri. Untuk peristiwa tayangan, biasanya ini adalah penyedia pengukuran pihak ketiga.

Dalam contoh penyiapan kampanye standar dari Skenario 1, server iklan penayang, SSP, atau penayang itu sendiri mungkin hanya perlu memastikan atribut attributionsrc yang disediakan oleh DSP muncul di halaman penayang.

Detail implementasi

Tabel berikut menjelaskan langkah-langkah penerapan Attribution Reporting API secara umum:

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

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

Untuk iklan video yang menggunakan format VAST, penayang dan SDK video akan menambahkan atribut.
Langkah 2: Aktifkan Pelaporan Atribusi untuk origin pihak ketiga Fitur ini berfungsi secara otomatis jika menggunakan jalur pengalihan yang 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: Siapkan respons untuk permintaan Attribution Reporting API Entitas apa pun yang ingin menerima laporan dari Attribution Reporting API DSP dan penyedia pengukuran pihak ketiga yang digunakan oleh pengiklan

Perhatikan bahwa detail setiap langkah bergantung pada cara materi iklan dirender dan ditayangkan di halaman penayang, serta 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 memicu peristiwa tayangan dan klik harus memperbarui materi iklan dengan atribut attributionsrc. attributionsrc harus ditambahkan ke peristiwa klik dan tayangan yang ada, dan dapat kosong atau tidak kosong.

Untuk peristiwa klik yang menggunakan pengalihan, atribut attributionsrc harus ditambahkan ke navigasi. Pengalihan 302 apa pun 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 dalam 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 Anda ingin permintaan Attribution Reporting API diarahkan ke server lain.

Contoh atribut attributionsrc kosong:

Penyiapan 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:

Penyiapan 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 menggunakan Fetch API harus menyertakan objek attributionReporting dalam argumen options yang diteruskan ke panggilan fetch API.

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

Acara Tag Penyiapan 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 di lelang Protected Audience

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

Untuk melaporkan sinyal Protected Audience, fungsi registerAdBeacon tersedia di dalam worklet pelaporan, dan registerAdMacro tersedia di dalam worklet pelaporan kemenangan pembeli. Kemudian, data peristiwa di dalam bingkai 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 frame, atau beacon otomatis dipicu oleh browser. Anda dapat menggunakan respons beacon untuk mendaftarkan sumber atribusi. Permintaan beacon dapat dialihkan untuk mengizinkan pengukuran pihak ketiga.

Untuk mengetahui informasi selengkapnya, lihat Dukungan untuk bagian Pelaporan Atribusi dalam 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> adalah peristiwa sumber atribusi potensial. Semua penerapan VAST harus memberikan cakupan kelayakan pendaftaran untuk peristiwa ini.

Adendum VAST menentukan atribut baru untuk elemen ini agar dapat menetapkan URL sekunder khusus untuk pendaftaran atribusi. Jika peristiwa berisi attributiontype="DOUBLE_PING" dan attributionsrc="[URL]", kode yang memicu 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 pendaftaran secara default saat mengaktifkan ping peristiwa. Misalnya, saat mengaktifkan URL peristiwa <Impression>, atribut attributionsrc (kosong) harus digunakan pada elemen <img> yang digunakan untuk mengirim permintaan (atau yang setara pada panggilan pengambilan), agar pihak penerima selalu dapat mendaftarkan peristiwa tersebut dengan Attribution Reporting API.

Langkah 2: Aktifkan Pelaporan Atribusi 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. Biasanya, setiap teknologi iklan memiliki pelacak tayangan iklan independennya sendiri, 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 ada sebagai rantai pengalihan 302 yang dibuat sebagai bagian dari navigasi ke halaman landing akhir. Setiap permintaan dalam rantai pengalihan memenuhi syarat untuk didaftarkan dengan Attribution Reporting API jika target klik asli dianotasi dengan attributionsrc atau terdaftar dengan registerAdBeacon/registerAdMacro di Protected Audience API. Teknologi iklan dalam rantai pengalihan juga harus terdaftar.

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

Dalam contoh berikut, kita 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 pelaporan 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 header Location kemungkinan sudah 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 origin 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 origin pelaporan.

Menggunakan attributionsrc untuk origin pihak ketiga yang tidak berada dalam rantai pengalihan

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

Penyiapan 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: Siapkan 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 Mendaftarkan sumber dan penjelasan untuk mempelajari cara membuat respons.

Mendaftarkan beberapa pemicu

Anda dapat mendaftarkan beberapa pemicu atribusi dengan menambahkan beberapa elemen piksel di sisi konversi (satu 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 di elemen attributionsrc dengan cara yang sama seperti untuk pendaftaran sumber. Peristiwa sumber dan peristiwa pemicu yang telah dihasilkan oleh origin yang sama akan dicocokkan.