Mendaftarkan pemicu atribusi

Pelajari cara mendaftarkan pemicu atribusi untuk menghitung konversi Anda.

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 <img>
• Tag <script>
• fetch panggilan
• XMLHttpRequest

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:

1. Mulai pendaftaran pemicu. Gunakan piksel atau panggilan fetch() untuk membuat permintaan.

2. Selesaikan pendaftaran pemicu dengan merespons menggunakan header pendaftaran pemicu.

   Setelah menerima permintaan piksel—dikirim ke endpoint yang ditentukan dalam atribut src biasa, atau ke endpoint yang ditentukan dalam attributionsrc jika Anda memilih untuk menggunakan attributionsrc dan memberinya nilai—respons dengan header Attribution-Reporting-Register-Trigger.

   Di header ini, tentukan data pemicu yang ingin ditampilkan dalam laporan. Respons apa pun dapat menyetel 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]"
     }]
   }
   

   Contoh laporan ringkasan:

   {
     ... // 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
     }
   }
   

Menangani subdomain

Jika destination adalah https://advertiser.example, konversi di https://advertiser.example dan subdomainnya, seperti https://shop.advertiser.example, dapat diatribusikan.

Jika destination adalah https://shop.advertiser.example, konversi di 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 perlu menggunakan attributionsrc atau attributionReporting. Lihat tabel berikut untuk mengetahui detail tentang kapan hal ini diperlukan.

Jika attributionsrc bersifat opsional, penggunaannya menunjukkan bahwa permintaan memenuhi syarat untuk Pelaporan Atribusi. Jika Anda menggunakan attributionsrc, browser akan mengirim header Attribution-Reporting-Eligible. Header ini juga berguna untuk pengukuran aplikasi ke web: jika attributionsrc ada, browser akan mengirim header Attribution-Reporting-Support.

Langkah 1: Mulai pendaftaran pemicu

Anda dapat mendaftarkan pemicu menggunakan tag piksel (tag <img>) atau tag skrip.

Menggunakan piksel konversi baru atau yang sudah ada

Contoh berikut memicu atribusi pada gambar yang ada dengan menambahkan atribut attributionsrc.

Origin untuk attributionsrc harus cocok dengan origin yang melakukan pendaftaran sumber.

<img src="https://advertiser.example/conversionpixel"
     attributionsrc="https://adtech.example/attribution_trigger?purchase=13">

Contoh berikutnya memicu atribusi dengan menambahkan atribut attributionsrc piksel konversi baru.

Origin untuk src harus cocok dengan origin yang melakukan pendaftaran sumber.

<img src="https://adtech.example/conversionpixel"
     attributionsrc>

Menggunakan tag skrip

Anda dapat melakukan pendaftaran pemicu dengan tag skrip; perilakunya sama dengan <img>. Contoh kode berikut mengilustrasikan penggunaan fetch() dan XMLHttpRequest() (XHR).

Kode ini secara efektif menyimulasikan apa yang akan dilakukan permintaan HTML dengan attributionsrc:

const attributionReporting = {
  eventSourceEligible: false,
  triggerEligible: true,
};

// Optionally set keepalive to make sure the request outlives the page.
window.fetch("https://adtech.example/attribution_source?my_ad_id=123",
  { keepalive: true, attributionReporting });

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 dapat berupa satu atau beberapa URL yang dipisahkan spasi.

Penggunaan URL menyebabkan browser memulai permintaan pengambilan keep-alive terpisah—satu untuk setiap URL—yang mencakup header permintaan Attribution-Reporting-Eligible.

Hal ini berguna jika Anda ingin membuat pendaftaran pemicu dengan merespons permintaan yang terpisah dari permintaan utama elemen.

Misalnya, jika Anda perlu mendaftarkan pemicu pada elemen gambar, Anda mungkin tidak benar-benar mengontrol respons gambar. Dalam hal ini, Anda memerlukan konfigurasi yang memungkinkan Anda mengirim header pendaftaran pemicu sebagai respons terhadap permintaan yang terpisah dari gambar, dan yang 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, berikan respons 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.