ดูวิธีบันทึกทริกเกอร์การระบุแหล่งที่มาเพื่อนับ Conversion
ทริกเกอร์การระบุแหล่งที่มาคือเหตุการณ์ที่บอกเบราว์เซอร์ให้บันทึก Conversion
เมื่อทําตามขั้นตอนในเอกสารฉบับนี้ คุณจะสามารถบันทึกทริกเกอร์เพื่อบันทึก Conversion ที่เบราว์เซอร์ระบุแหล่งที่มาเป็นเหตุการณ์แหล่งที่มาที่เกี่ยวข้อง เช่น การแสดงโฆษณา หรือการคลิกโฆษณา
วิธีการจดทะเบียน
หากต้องการลงทะเบียนทริกเกอร์ ให้ใช้องค์ประกอบ HTML หรือการเรียก JavaScript ดังนี้
- แท็ก
<a>
- แท็ก
<img>
- แท็ก
<script>
- การโทร
fetch
รายการ XMLHttpRequest
window.open
วิธีนี้จะสร้างคำขอเครือข่ายที่คุณตอบสนองด้วยส่วนหัวการตอบกลับ 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]" }] } ``` **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'})