Pelajari cara mendaftarkan pemicu atribusi untuk menghitung konversi.
Pemicu atribusi adalah peristiwa yang memberi tahu browser untuk mencatat konversi.
Dengan mengikuti langkah-langkah dalam dokumen ini, Anda dapat mendaftarkan pemicu untuk mendaftarkan konversi yang kemudian diatribusikan oleh browser ke peristiwa sumber yang relevan—yaitu, tayangan iklan atau klik iklan.
Metode pendaftaran
Untuk mendaftarkan pemicu, gunakan elemen HTML atau panggilan JavaScript:
- Tag
<a>
- Tag
<img>
- Tag
<script>
fetch
panggilanXMLHttpRequest
window.open
Tindakan ini menghasilkan permintaan jaringan yang kemudian Anda respons dengan header respons HTTP pendaftaran pemicu.
Mendaftarkan pemicu untuk mengatribusikan konversi
Mendaftarkan pemicu mirip dengan mendaftarkan peristiwa sumber atribusi. Langkah-langkah lengkap akan dijelaskan nanti. Berikut ringkasannya:
- Mulai pendaftaran pemicu. Gunakan piksel atau panggilan
fetch()
untuk membuat permintaan. Selesaikan pendaftaran pemicu dengan merespons menggunakan header pendaftaran pemicu.
Setelah menerima permintaan piksel, yang dikirim ke endpoint yang ditentukan dalam atribut
src
biasa, atau ke endpoint yang ditentukan dalamattributionsrc
jika Anda memilih untuk menggunakanattributionsrc
dan memberinya nilai—respons dengan headerAttribution-Reporting-Register-Trigger
.Di header ini, tentukan data pemicu yang pada akhirnya ingin Anda tampilkan dalam laporan. Setiap respons dapat menetapkan header ini. Selama merupakan respons terhadap permintaan yang dibuat dari situs yang cocok dengan
destination
, sumber akan dicocokkan. Saat header diterima, browser akan mencari sumber yang cocok dan menjadwalkan laporan.Contoh untuk laporan tingkat peristiwa:
{ "event_trigger_data": [{ "trigger_data": "[unsigned 64-bit integer]", "priority": "[signed 64-bit integer]", "deduplication_key": "[unsigned 64-bit integer]" }] } ``` **Example for summary reports:** ```json { ... // existing fields, such as "event_trigger_data" "aggregatable_trigger_data": [ { "key_piece": "0x400", "source_keys": ["campaignCounts"] }, { "key_piece": "0xA80", "source_keys": ["geoValue", "nonMatchingKeyIdsAreIgnored"] } ], "aggregatable_values": { "campaignCounts": 32768, "geoValue": 1664 } } ```
Berurusan dengan subdomain
Jika destination
adalah https://advertiser.example
, konversi pada
https://advertiser.example
dan subdomainnya, seperti https://shop.advertiser.example
, dapat diatribusikan.
Jika destination
adalah https://shop.advertiser.example
, konversi pada https://advertiser.example
dan
https://shop.advertiser.example
dapat diatribusikan.
Atribut wajib dan opsional
Saat menggunakan elemen HTML atau melakukan panggilan JavaScript untuk mendaftarkan pemicu, Anda mungkin harus menggunakan attributionsrc
atau attributionReporting
. Lihat tabel berikut untuk mengetahui detail tentang kapan fungsi ini
diperlukan.
Jika attributionsrc
bersifat opsional, penggunaannya menunjukkan bahwa permintaan memenuhi syarat untuk Attribution Reporting. Jika Anda menggunakan
attributionsrc
, browser akan mengirimkan
header Attribution-Reporting-Eligible
. Ini juga berguna untuk pengukuran aplikasi ke web: jika attributionsrc
ada, browser akan mengirimkan header Attribution-Reporting-Support
.
Metode pendaftaran | Pemicu |
---|---|
Tag <a> |
T/A Anchor tidak dapat mendaftarkan pemicu. |
Tag <img> |
attributionsrc bersifat opsional. Header
cukup untuk mendaftarkan pemicu. |
Tag <script> |
attributionsrc bersifat opsional. Header
cukup untuk mendaftarkan pemicu. |
fetch panggilan |
Opsi attributionReporting
wajib ada. |
XMLHttpRequest |
Opsi attributionReporting
wajib ada. |
window.open() |
T/A
window.open tidak dapat mendaftarkan pemicu. |
Langkah 1: Mulai pendaftaran pemicu
Anda dapat mendaftarkan pemicu menggunakan piksel (tag <img>
) atau tag skrip.
Menggunakan piksel konversi baru atau yang sudah ada
<img src="https://ad-tech.example/conversionpixel"
attributionsrc="https://adtech.example/attribution_trigger?purchase=13">
Menggunakan tag skrip
Anda dapat melakukan pendaftaran pemicu dengan tag skrip; kode ini berperilaku identik dengan <img>
. Contoh kode berikut mengilustrasikan penggunaan fetch()
dan XMLHttpRequest()
(XHR).
Kode ini secara efektif menyimulasikan fungsi permintaan HTML dengan attributionsrc
:
// With fetch
const attributionReporting = {
eventSourceEligible: false,
triggerEligible: true,
};
// Optionally set keepalive to ensure the request outlives the page.
window.fetch("https://adtech.example/attribution_source?my_ad_id=123",
{ keepalive: true, attributionReporting });
// With XMLHttpRequest:
const attributionReporting = {
eventSourceEligible: false,
triggerEligible: true,
};
const req = new XMLHttpRequest();
req.open('GET', url);
req.setAttributionReporting(
attributionReporting);
req.send();
attributionsrc
dengan atau tanpa nilai
Anda dapat menambahkan attributionsrc
dengan atau tanpa nilai.
<!-- Without a value -->
<img src="..." width="1" height="1" attributionsrc>
<!--With a value (URL) -->
<img src="..." width="1" height="1" attributionsrc="https://...">
Jika Anda menetapkan nilai untuk attributionsrc
, nilai tersebut harus berupa URL tunggal.
Menggunakan URL akan menyebabkan browser memulai permintaan pengambilan keepalive terpisah—satu
untuk setiap URL—yang mencakup header permintaan
Attribution-Reporting-Eligible
.
Hal ini berguna jika Anda ingin membuat pendaftaran sumber dengan merespons permintaan yang terpisah dari permintaan utama elemen.
Misalnya, jika Anda perlu mendaftarkan sumber untuk klik pada elemen anchor,
Anda mungkin sebenarnya tidak mengontrol tujuan. Dalam hal ini, Anda memerlukan
konfigurasi untuk mengirim header pendaftaran sumber sebagai respons terhadap permintaan
yang terpisah dari navigasi dan dapat Anda kontrol sepenuhnya. Dengan
menentukan nilai eksplisit untuk attributionsrc
, Anda menginstruksikan
browser untuk membuat permintaan tambahan tersebut dan mengonfigurasi tujuannya.
Langkah 2: Berikan respons dengan header
Setelah menerima permintaan browser, tanggapi dan sertakan header Attribution-Reporting-Register-Trigger
dalam respons Anda:
JSON.stringify({event_trigger_data: [{
trigger_data: '412444888111012',
// Optional
priority: '1000000000000',
deduplication_key: '2345698765'
}], debug_key: '1115698977'})
Langkah berikutnya
Pelajari cara Mendaftarkan sumber atribusi.