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 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, sudah umum bagi penayang untuk memiliki satu atau beberapa teknologi iklan yang bertanggung jawab untuk menayangkan iklan - ini dapat mencakup pihak yang bertanggung jawab menyediakan markup untuk materi iklan, pihak yang menyediakan tayangan atau pelacakan piksel 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 siap 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 unik. Oleh karena itu, 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 maupun 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 ke API oleh teknologi iklan.

Skenario pengukuran konversi yang umum

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

Skenario 1: Baik penyedia teknologi iklan penayangan maupun 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 pada inventaris iklan. Hal ini umum terjadi bagi DSP atau server iklan pengiklan (server iklan pihak ketiga - 3PAS) yang memberikan 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 yang melakukan 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 bahwa pengalihan dikonfigurasi dengan benar. Selain itu, teknologi iklan penayangan dan penyedia pengukuran pihak ketiga harus memastikan bahwa mereka terdaftar dan servernya siap menerima serta merespons permintaan Attribution Reporting API.

Penyiapan kampanye standar dapat terlihat seperti:

  1. Server iklan pengiklan (3PAS) menyediakan markup untuk materi iklan ke DSP, yang menyertakan 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 iklan pengukuran dan piksel pelacakan klik tambahan, serta harus memastikan attributionsrc disertakan dalam markup materi iklan akhir yang digunakan untuk bidding.

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

Seorang 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 untuk menggunakan pelaporan atribusi sendiri, tetapi ingin mengaktifkan Attribution Reporting API untuk partner DSP mereka, atau untuk perusahaan pemberian tag pengukuran seperti penyedia analisis, pengukuran, atau server iklan pihak ketiga.

Dalam hal ini, pihak yang bertanggung jawab untuk mengaktifkan peristiwa klik dan tayangan dalam penyiapan saat ini perlu 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 dapat berupa SSP, teknologi iklan yang menayangkan, atau penayang itu sendiri. Untuk peristiwa tayangan iklan, penyedia pengukuran ini lebih sering digunakan oleh penyedia pengukuran pihak ketiga.

Dalam contoh penyiapan kampanye umum dari Skenario 1, server iklan penayang, SSP, atau penayang mungkin hanya perlu memastikan atribut attributionsrc yang disediakan 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 (DSP/server iklan 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, penayang dan SDK video menambahkan atribut.

Langkah 2: Aktifkan Attribution Reporting untuk asal pihak ketiga Tindakan ini dapat langsung difungsikan 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 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, 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 akan diaktifkan.

Cara kerja atribut attributionsrc

Atribut attributionsrc yang baru menentukan tujuan pengiriman permintaan Attribution Reporting API. Entitas yang bertanggung jawab untuk mengaktifkan tayangan dan peristiwa klik harus memperbarui materi iklan dengan atribut attributionsrc. attributionsrc harus ditambahkan ke peristiwa klik dan tayangan yang ada, dan boleh 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 ditetapkan 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 Anda ingin permintaan Attribution Reporting API dikirim ke server lain.

Contoh atribut attributionsrc yang 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 di tag anchor.

Contoh atribut atribusisrc 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:

Event 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 HTML <img> <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 untuk mengaktifkan pendaftaran sumber atribusi.attributionsrc

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 yang terdaftar dengan fungsi reportEvent dan setReportEventDataForAutomaticBeacons dari Fenced Frame Ads Reporting API. Dengan demikian, sinyal worklet pelaporan Protected Audience dan payload peristiwa bingkai materi iklan dapat 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 mungkin akan dialihkan untuk mengizinkan pengukuran pihak ketiga.

Untuk mempelajari lebih mendalam, lihat bagian Dukungan untuk Attribution Reporting di 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 singkatnya, semua peristiwa <Tracking>, <Impression>, <*ClickThrough>, dan <*ClickTracking> merupakan kemungkinan peristiwa sumber atribusi. Semua penerapan VAST harus menyediakan cakupan kelayakan pendaftaran untuk peristiwa ini.

Adendum VAST menentukan atribut baru untuk elemen ini agar dapat menyetel URL sekunder secara khusus untuk pendaftaran atribusi. Jika 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 pendaftaran 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 di panggilan pengambilan), agar selalu memungkinkan pihak penerima untuk mendaftarkan peristiwa tersebut dengan Attribution Reporting API.

Langkah 2: Aktifkan Attribution Reporting untuk asal pihak ketiga

Untuk mengizinkan pihak ketiga menggunakan Attribution Reporting API, Anda dapat menggunakan pengalihan yang ada atau menambahkan daftar pihak ketiga ke atribut attributionsrc. Dalam sebagian besar kasus, 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 muncul sebagai rangkaian pengalihan 302 yang dibuat sebagai bagian dari navigasi ke halaman landing akhir. Setiap permintaan di rantai pengalihan memenuhi syarat untuk pendaftaran dengan Attribution Reporting API jika target klik asli dianotasi dengan attributionsrc atau didaftarkan dengan registerAdBeacon/registerAdMacro di Protected Audience API. Teknologi iklan di rantai pengalihan juga harus didaftarkan.

Perhatikan bahwa isi permintaan awal tidak dikirim saat pengalihan. Untuk lelang Protected Audience, jika eventData yang 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, 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 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 dalam 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. Perlu diketahui bahwa kemungkinan header Location 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 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 di 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 perubahan 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 dikirimkan 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 Mendaftarkan sumber dan penjelasan untuk mempelajari cara membuat respons.

Mendaftarkan beberapa pemicu

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

Anda juga dapat mendaftarkan beberapa pemicu dari elemen piksel tunggal dengan 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 dibuat oleh asal yang sama akan dicocokkan.