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 telah 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 untuk menyediakan markup 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 hilir 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, jadi penting bagi DSP atau server iklan untuk memahami cara mengaktifkan Attribution Reporting API guna 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 secara terpisah dengan API oleh teknologi iklan.

Skenario umum pengukuran konversi

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 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 sendiri, dan bekerja sama dengan pengiklan yang terintegrasi 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 iklan dalam penyiapan saat ini. Teknologi iklan penayangan harus menyetel attributionsrc baru di lokasi yang sesuai dan memverifikasi bahwa pengalihan dikonfigurasi dengan benar. Selain itu, teknologi iklan penayangan dan penyedia pengukuran pihak ketiga harus memverifikasi bahwa mereka terdaftar dan server mereka 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 mencakup piksel pelacakan tayangan dan klik penyedia pengukuran pihak ketiga. Server iklan harus memastikan bahwa attributionsrc disertakan dalam markup materi iklan.

  2. DSP menawarkan kemampuan untuk menambahkan piksel pelacakan tayangan iklan dan klik pengukuran tambahan, dan harus memastikan attributionsrc disertakan dalam markup materi iklan akhir yang mereka ajukan bid-nya.

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 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 iklan dalam penyiapan saat ini perlu menambahkan atribut attributionsrc baru ke materi iklan dan memverifikasi bahwa pengalihan berfungsi sebagaimana mestinya. Hal ini sangat bergantung pada integrasi setiap penayang, tetapi untuk peristiwa klik, hal ini bisa berupa SSP, teknologi penayangan iklan, atau penayang itu sendiri. Untuk peristiwa tayangan iklan, biasanya penyedia pengukuran pihak ketiga.

Dalam contoh penyiapan kampanye umum dari Skenario 1, server iklan penayang, SSP, atau penayang itu sendiri mungkin hanya perlu memverifikasi bahwa atribut attributionsrc yang diberikan 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 menambahkan atribut attributionsrc. Untuk peristiwa klik, umumnya pembeli (server iklan DSP/pengiklan) yang merender materi iklan menambahkan atribut.

Untuk peristiwa tayangan iklan, 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 menambahkan atribut.
Langkah 2: Aktifkan Attribution Reporting untuk origin pihak ketiga Hal ini dapat langsung berfungsi 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.

 Secara umum, 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 mana pun yang ingin menerima laporan dari Attribution Reporting API DSP dan penyedia pengukuran pihak ketiga yang digunakan oleh pengiklan

Perhatikan bahwa spesifikasi 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 ke mana permintaan Attribution Reporting API akan dikirim. Entitas yang bertanggung jawab untuk memicu peristiwa tayangan iklan dan klik harus memperbarui materi iklan dengan atribut attributionsrc. attributionsrc harus ditambahkan ke peristiwa klik dan tayangan iklan yang ada, dan dapat berupa 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). Jika atribut attributionsrc ditentukan, permintaan ARA akan dikirim ke URL yang ditentukan dalam atribut attributionsrc. URL klik-tayang juga memenuhi syarat untuk mendaftarkan sumber.

Secara umum, 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 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.

Tambahkan 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 menambahkan atribut attributionsrc.
    • Klik 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 iklan yang diaktifkan dari tag <img> atau tag <script> harus menyertakan atribut attributionsrc.
    • Peristiwa tayangan iklan 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 HTML <img> <img src="[IMPRESSION_URL]"> <img src="[IMPRESSION_URL]" attributionsrc>
Tag HTML <script> <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 dalam lelang Protected Audience, alih-alih 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 di dalam worklet pelaporan kemenangan pembeli. Kemudian, data peristiwa di dalam frame iklan dapat ditambahkan ke beacon dan makro yang 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 lebih lanjut, lihat bagian Dukungan untuk Attribution Reporting 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 pendaftaran dengan Attribution Reporting API. VAST Addendum for Attribution Reporting Support membahas hal ini secara mendetail, tetapi singkatnya, semua peristiwa <Tracking>, <Impression>, <*ClickThrough>, dan <*ClickTracking> adalah potensi peristiwa sumber atribusi. Semua penerapan VAST harus memberikan cakupan kelayakan pendaftaran untuk acara ini.

Lampiran 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. Lampiran VAST berisi contoh untuk setiap skenario.

Untuk cakupan maksimum, penerapan VAST secara default harus membuat semua peristiwa yang tercantum memenuhi syarat untuk pendaftaran saat ping peristiwa diaktifkan. Misalnya, saat memicu 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 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. 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 dilakukan sebagai bagian dari navigasi ke halaman landing akhir. Setiap permintaan dalam rantai pengalihan memenuhi syarat untuk pendaftaran dengan Attribution Reporting API jika target klik asli diberi anotasi dengan attributionsrc atau didaftarkan dengan 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 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 pelaporannya sendiri. Penyedia pengukuran pihak ketiga dapat berupa entitas yang digunakan pengiklan untuk pelaporan konversi.

Diagram yang menjelaskan cara pihak pertama mendaftarkan sumber.
Contoh cara kerja pengukuran konversi dengan pihak ketiga.

Saat pendaftaran sumber, langkah-langkah berikut akan terjadi:

  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 ada dalam rantai pengalihan

Jika beberapa asal 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 untuk 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 pemicu pendaftaran.

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 asal yang sama akan dicocokkan.