ลงทะเบียนทริกเกอร์การระบุแหล่งที่มา

ดูวิธีบันทึกทริกเกอร์การระบุแหล่งที่มาเพื่อนับ Conversion

ทริกเกอร์การระบุแหล่งที่มาคือเหตุการณ์ที่บอกเบราว์เซอร์ให้บันทึก Conversion

เมื่อทําตามขั้นตอนในเอกสารฉบับนี้ คุณจะสามารถบันทึกทริกเกอร์เพื่อบันทึก Conversion ที่เบราว์เซอร์ระบุแหล่งที่มาเป็นเหตุการณ์แหล่งที่มาที่เกี่ยวข้อง เช่น การแสดงโฆษณา หรือการคลิกโฆษณา

วิธีการจดทะเบียน

หากต้องการลงทะเบียนทริกเกอร์ ให้ใช้องค์ประกอบ HTML หรือการเรียก JavaScript ดังนี้

  • แท็ก <a>
  • แท็ก <img>
  • แท็ก <script>
  • การโทร fetch รายการ
  • XMLHttpRequest
  • window.open

วิธีนี้จะสร้างคำขอเครือข่ายที่คุณตอบสนองด้วยส่วนหัวการตอบกลับ HTTP การลงทะเบียนทริกเกอร์

ลงทะเบียนทริกเกอร์เพื่อระบุแหล่งที่มาของ Conversion

การลงทะเบียนทริกเกอร์คล้ายกับการลงทะเบียนเหตุการณ์แหล่งที่มาของการระบุแหล่งที่มา เราจะอธิบายขั้นตอนที่สมบูรณ์ในภายหลัง ข้อมูลสรุปมีดังนี้

  1. เริ่มการลงทะเบียนทริกเกอร์ ใช้พิกเซลหรือการเรียก fetch() เพื่อส่งคำขอ

  2. ลงทะเบียนทริกเกอร์ให้เสร็จสมบูรณ์โดยตอบกลับด้วยส่วนหัวการลงทะเบียนทริกเกอร์

    เมื่อได้รับคำขอพิกเซล ให้ส่งไปยังปลายทางที่กำหนดไว้ในแอตทริบิวต์ src ปกติ หรือปลายทางที่กำหนดไว้ใน attributionsrc หากคุณเลือกใช้ attributionsrc และระบุค่า ให้ตอบกลับด้วยส่วนหัว Attribution-Reporting-Register-Trigger

    ในส่วนหัวนี้ ให้ระบุข้อมูลทริกเกอร์ที่คุณต้องการให้แสดงในรายงานในที่สุด ทุกคำตอบจะตั้งค่าส่วนหัวนี้ได้ ตราบใดที่เป็นการตอบกลับคำขอจากเว็บไซต์ที่ตรงกับ destination แหล่งที่มาก็จะจับคู่ตรงกัน เมื่อได้รับส่วนหัวแล้ว เบราว์เซอร์จะมองหาแหล่งที่มาที่ตรงกันและตั้งเวลารายงาน

    ตัวอย่างสำหรับรายงานระดับเหตุการณ์

    {
  "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
  }
}
```

การจัดการกับโดเมนย่อย

หาก destination คือ https://advertiser.example ระบบจะระบุแหล่งที่มาของ Conversion ทั้งใน https://advertiser.example และโดเมนย่อย เช่น https://shop.advertiser.example

หาก destination คือ https://shop.advertiser.example จะสามารถระบุแหล่งที่มาของ Conversion ทั้งใน https://advertiser.example และ https://shop.advertiser.example

แอตทริบิวต์ที่ต้องระบุและไม่บังคับ

เมื่อคุณใช้องค์ประกอบ HTML หรือเรียกใช้ JavaScript เพื่อลงทะเบียนทริกเกอร์ คุณอาจต้องใช้ attributionsrc หรือ attributionReporting ดูรายละเอียดเกี่ยวกับเวลาที่จำเป็นต้องใช้สิ่งเหล่านี้ในตารางต่อไปนี้

หากattributionsrc ไม่บังคับ การใช้ตัวแปรนี้จะระบุว่าคำขอนั้นมีสิทธิ์ใช้รายงานการระบุแหล่งที่มา หากคุณใช้ attributionsrc เบราว์เซอร์จะส่งส่วนหัว Attribution-Reporting-Eligible นอกจากนี้ยังเป็นประโยชน์สำหรับการวัดผลจากแอปไปยังเว็บด้วย หากมี attributionsrc อยู่ เบราว์เซอร์จะส่งส่วนหัว Attribution-Reporting-Support

วิธีการลงทะเบียน ทริกเกอร์
แท็ก <a> ไม่มี Anchor จะบันทึกทริกเกอร์ไม่ได้
แท็ก <img> attributionsrc เป็นตัวเลือก ส่วนหัวนั้นเพียงพอต่อการลงทะเบียนทริกเกอร์
แท็ก <script> attributionsrc ไม่บังคับ ส่วนหัวนั้นเพียงพอต่อการลงทะเบียนทริกเกอร์
การโทร fetch รายการ ต้องระบุตัวเลือก attributionReporting
XMLHttpRequest ต้องระบุตัวเลือก attributionReporting
window.open() ไม่มี window.open ลงทะเบียนทริกเกอร์ไม่ได้

ขั้นตอนที่ 1: เริ่มการลงทะเบียนทริกเกอร์

คุณสามารถลงทะเบียนทริกเกอร์โดยใช้พิกเซล (แท็ก <img>) หรือแท็กสคริปต์

การใช้พิกเซล Conversion ใหม่หรือที่มีอยู่

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

การใช้แท็กสคริปต์

คุณสามารถลงทะเบียนทริกเกอร์ด้วยแท็กสคริปต์ ซึ่งทำงานเหมือนกับ <img> ตัวอย่างโค้ดต่อไปนี้แสดงให้เห็นถึงการใช้ fetch() และ XMLHttpRequest() (XHR)

โค้ดนี้จะจำลองว่าคำขอ HTML ด้วย 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 ที่มีหรือไม่มีค่า

คุณจะเพิ่ม attributionsrc จะมีหรือไม่มีค่าก็ได้

<!-- Without a value -->
<img src="..." width="1" height="1" attributionsrc>

<!--With a value (URL) -->
<img src="..." width="1" height="1" attributionsrc="https://...">

หากคุณกำหนดค่าสำหรับ attributionsrc ค่าดังกล่าวควรเป็น URL เดียว

การใช้ URL จะทำให้เบราว์เซอร์เริ่มคำขอดึงข้อมูล Keepalive แยกต่างหาก 1 รายการต่อ URL 1 รายการ ซึ่งรวมถึงส่วนหัวของคำขอ Attribution-Reporting-Eligible

ซึ่งจะเป็นประโยชน์หากคุณต้องการสร้างการลงทะเบียนต้นทางโดยการตอบกลับคำขอที่แยกจากคำขอหลักขององค์ประกอบ

ตัวอย่างเช่น หากคุณจำเป็นต้องลงทะเบียนแหล่งที่มาสำหรับการคลิกองค์ประกอบ Anchor จริงๆ แล้วคุณอาจไม่ได้เป็นผู้ควบคุมปลายทาง ซึ่งในกรณีนี้ คุณจะต้องกำหนดค่าที่ส่งส่วนหัวการลงทะเบียนแหล่งที่มาเป็นการตอบกลับคำขอที่แยกจากการนำทาง และคุณจะควบคุมได้โดยสมบูรณ์ การระบุค่าที่ชัดเจนสำหรับ attributionsrc จะเป็นการสั่งให้เบราว์เซอร์สร้างคำขอเพิ่มเติมและกำหนดค่าปลายทาง

ขั้นตอนที่ 2: ตอบกลับด้วยส่วนหัว

เมื่อได้รับคำขอของเบราว์เซอร์ ให้ตอบกลับและรวมส่วนหัว Attribution-Reporting-Register-Trigger ไว้ในการตอบกลับของคุณด้วย:

JSON.stringify({event_trigger_data: [{
      trigger_data: '412444888111012',
      // Optional
      priority: '1000000000000',
      deduplication_key: '2345698765'
    }], debug_key: '1115698977'})

ขั้นตอนถัดไป

ดูวิธีลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา