ดูวิธีลงทะเบียนทริกเกอร์การระบุแหล่งที่มาเพื่อนับ Conversion
ทริกเกอร์การระบุแหล่งที่มาคือเหตุการณ์ที่บอกให้เบราว์เซอร์บันทึก Conversion
เมื่อทำตามขั้นตอนในเอกสารนี้ คุณจะสามารถบันทึกทริกเกอร์เพื่อลงทะเบียน Conversion ที่เบราว์เซอร์ระบุแหล่งที่มาไปยังเหตุการณ์แหล่งที่มาที่เกี่ยวข้อง ซึ่งได้แก่ การแสดงโฆษณาหรือการคลิกโฆษณา
วิธีการลงทะเบียน
หากต้องการลงทะเบียนทริกเกอร์ ให้ใช้องค์ประกอบ HTML หรือการเรียก JavaScript ดังนี้
- แท็ก
<img> - แท็ก
<script> - การโทร
fetchครั้ง XMLHttpRequest
การดำเนินการนี้จะสร้างคำขอเครือข่าย ซึ่งคุณจะตอบกลับด้วยส่วนหัวการตอบกลับ HTTP ของการลงทะเบียนทริกเกอร์
ลงทะเบียนทริกเกอร์เพื่อระบุแหล่งที่มาของ Conversion
การลงทะเบียนทริกเกอร์นั้นคล้ายกับ การลงทะเบียนเหตุการณ์แหล่งที่มาของการระบุแหล่งที่มา เราจะอธิบายขั้นตอนที่สมบูรณ์ในภายหลัง ข้อมูลสรุปมีดังนี้
- เริ่มการลงทะเบียนทริกเกอร์ ใช้พิกเซลหรือการเรียก
fetch()เพื่อโทรออก คำขอ ดำเนินการลงทะเบียนทริกเกอร์ให้เสร็จสมบูรณ์โดยการตอบกลับด้วยทริกเกอร์ ส่วนหัวการลงทะเบียน
เมื่อได้รับคำขอพิกเซล - ส่งไปยัง ปลายทางที่กำหนดไว้ในแอตทริบิวต์
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]" }] }ตัวอย่างรายงานสรุป
{ ... // 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 ในทั้ง 2 ที่
ระบบจะระบุแหล่งที่มาของ 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 ใหม่หรือที่มีอยู่
ตัวอย่างต่อไปนี้จะทริกเกอร์การระบุแหล่งที่มาในรูปภาพที่มีอยู่ด้วยการเพิ่มแอตทริบิวต์ attributionsrc
ต้นทางสำหรับ attributionsrc ต้องตรงกับต้นทางที่ลงทะเบียนได้
<img src="https://advertiser.example/conversionpixel"
attributionsrc="https://adtech.example/attribution_trigger?purchase=13">
ตัวอย่างถัดไปจะเรียกใช้การระบุแหล่งที่มาด้วยการเพิ่มแอตทริบิวต์พิกเซล Conversion attributionsrc ใหม่
ต้นทางสำหรับ src ต้องตรงกับต้นทางที่ลงทะเบียนได้
<img src="https://adtech.example/conversionpixel"
attributionsrc>
การใช้แท็กสคริปต์
คุณลงทะเบียนทริกเกอร์ด้วยแท็กสคริปต์ได้ มีลักษณะการทำงานเหมือนกับ <img> ตัวอย่างโค้ดต่อไปนี้แสดงการใช้ fetch() และ XMLHttpRequest() (XHR)
โค้ดนี้จะจำลองสิ่งที่คำขอ HTML ที่มี attributionsrc จะทำอย่างมีประสิทธิภาพ:
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 });
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 ที่คั่นด้วยช่องว่างอย่างน้อย 1 รายการ
การใช้ URL จะทำให้เบราว์เซอร์เริ่มคำขอดึงข้อมูล Keepalive แยกต่างหาก -
สำหรับแต่ละ URL ซึ่งมีคำขอ Attribution-Reporting-Eligible
ส่วนหัว
ซึ่งจะเป็นประโยชน์ในกรณีที่คุณต้องการสร้างการลงทะเบียนทริกเกอร์โดยการตอบกลับ คำขอที่แยกจากคำขอหลักขององค์ประกอบ
ตัวอย่างเช่น หากคุณต้องลงทะเบียนทริกเกอร์
กับองค์ประกอบรูปภาพ
คุณอาจไม่ได้อยู่ภายใต้การควบคุมของการตอบสนองของรูปภาพ ในกรณีนี้ คุณจะต้อง
การกำหนดค่าที่คุณส่งส่วนหัวการลงทะเบียนทริกเกอร์เพื่อตอบกลับคำขอ
ที่แยกต่างหากจากรูปภาพ และคุณสามารถควบคุมได้อย่างสมบูรณ์ โดย
ระบุค่า Explicit สำหรับ attributionsrc ได้
เพื่อสร้างคำขอเพิ่มเติมและกำหนดค่าปลายทาง
ขั้นตอนที่ 2: ตอบกลับด้วยส่วนหัว
เมื่อได้รับคำขอเบราว์เซอร์ ให้ตอบกลับและรวมส่วนหัว Attribution-Reporting-Register-Trigger ไว้ในการตอบกลับของคุณ:
JSON.stringify({
event_trigger_data: [{
trigger_data: "412444888111012",
// Optional
priority: "1000000000000",
deduplication_key: "2345698765"
}],
debug_key: "1115698977"
});