Mendaftarkan pemicu atribusi

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 panggilan
• XMLHttpRequest
• 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:

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, yang 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 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
     }
   }
   ```
   

Catatan: Saat browser menerima respons pemicu atribusi dari URL Attributionsrc di halaman tertentu, pencarian penyimpanan lokal akan dilakukan untuk menemukan sumber yang cocok dengan origin attributionsrc dan eTLD+1 dari URL halaman tersebut. <br> Jika beberapa sumber ditemukan, browser akan memilih sumber yang terakhir disimpan—kecuali sumber memiliki prioritas yang berbeda, yaitu saat browser akan memilih sumber dengan prioritas terbesar.

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">

Poin penting: * Asal untuk src harus cocok dengan origin yang melakukan pendaftaran sumber. * Atribusi hanya dapat dipicu pada halaman yang eTLD+1-nya cocok dengan situs yang diberikan di tujuan saat pendaftaran sumber.

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();

Poin penting: - Origin untuk <code>src</code> harus cocok dengan origin yang melakukan pendaftaran sumber. - Atribusi hanya dapat dipicu di halaman yang <a href="https://web.dev/same-site-same-origin/#%22skemaful-same-site%22">eTLD+1</a> cocok dengan situs yang diberikan di <code>destination</code> setelah pendaftaran sumber.

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'})

Perhatian: Nilai kolom event_trigger_data harus ditempatkan dalam tanda kurung siku, karena browser mengharapkan array JSON. Hal ini berguna untuk filter.

Langkah berikutnya

Pelajari cara Mendaftarkan sumber atribusi.