ข้อเสนอการรายงานการระบุแหล่งที่มาจะมีการเปลี่ยนแปลงสำหรับ Chrome เวอร์ชัน 104 พร้อมด้วยกลไก API, ฟังก์ชันการทำงาน และการอัปเดตแบบใหม่สำหรับบริการรวบรวมข้อมูล
การอัปเดตเหล่านี้มีไว้สำหรับใคร
การอัปเดตเหล่านี้เหมาะสำหรับคุณในกรณีต่อไปนี้
- คุณคุ้นเคยกับ API อยู่แล้ว เช่น หากได้สังเกตหรือมีส่วนร่วมในการสนทนาเกี่ยวกับที่เก็บ WICG และต้องการทำความเข้าใจการเปลี่ยนแปลงที่เกิดขึ้นกับ API
- คุณกำลังใช้ Attribution Reporting API ในเดโมหรือแผนที่จะทดสอบในช่วงทดลองใช้จากต้นทาง
หากคุณเพิ่งเริ่มใช้ API นี้และ/หรือยังไม่ได้ทดลองใช้ โปรดไปที่ข้อมูลเบื้องต้นเกี่ยวกับ API โดยตรงแทน
ข้อมูลอัปเดตเกี่ยวกับ Attribution Reporting API
การสาธิต Attribution Reporting ได้รับการอัปเดตเพื่อแสดงการเปลี่ยนแปลงล่าสุดของ Attribution Reporting API ฝั่งไคลเอ็นต์
การเปลี่ยนแปลงส่วนใหญ่ไม่จําเป็นต้องดําเนินการใดๆ ส่วนการทดสอบที่จำเป็นต้องมีการอัปเดต ซึ่งได้ไฮไลต์ไว้ด้านล่างนี้
(ขอให้ดำเนินการ) ส่วนหัวแบบรวมสำหรับการลงทะเบียน
ส่วนหัวต่างๆ รวมกันแล้ว ตอนนี้มีเพียงส่วนหัวสำหรับแหล่งที่มา 1 ส่วนหัว และอีกส่วนหัวสำหรับทริกเกอร์ ซึ่งอยู่ในรูปแบบ JSON
- หากต้องการลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา คุณสามารถตอบกลับคำขอการจดทะเบียนได้ด้วยส่วนหัว
Attribution-Reporting-Register-Source
- หากต้องการลงทะเบียนทริกเกอร์ให้เสร็จสมบูรณ์ ให้ตั้งค่าส่วนหัว
Attribution-Reporting-Register-Trigger
ต้องดำเนินการเพื่อการเปลี่ยนแปลงนี้ ดูข้อมูลเพิ่มเติมได้ในคู่มือนักพัฒนาซอฟต์แวร์ API
(ขอให้ดำเนินการ) ตอนนี้คีย์การรวมเป็นพจนานุกรมแล้ว
หากต้องการลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา ให้ใช้ aggregation_keys
ต่อไป แต่จะจัดเก็บเป็นพจนานุกรม JSON แทนรายการ
เช่น
"aggregation_keys": {
// Generate a "0x159" key piece for the key named "campaignCounts".
"campaignCounts": "0x159", // User saw ad from campaign 345 (out of 511)
// Generates a "0x5" key piece (low order bits of the key) for
// the key named "geoValue".
"geoValue": "0x5" // Source-side geo region = 5 (US), out of a possible ~100 regions
}
ต้องดำเนินการเพื่อการเปลี่ยนแปลงนี้ โปรดดูข้อมูลเพิ่มเติมในคู่มือ API
การสร้างรายงาน
คุณสามารถเลือกสร้างเฉพาะรายงานแบบรวมได้ ซึ่งสามารถนำไปรวมเป็นรายงานสรุปได้ หากตัวกรองไม่ตรงกับทริกเกอร์เหตุการณ์ใดๆ จะไม่มีการสร้างรายงานระดับเหตุการณ์
การตั้งค่าคีย์การแก้ไขข้อบกพร่องแบบรวม
ตอนนี้คุณควรตั้งค่าคีย์การแก้ไขข้อบกพร่องในส่วนหัวต้นทางและส่วนหัวทริกเกอร์ แทนที่จะใช้ส่วนหัวแยกกัน ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีแก้ไขข้อบกพร่องของรายงาน
ลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา
ตอนนี้คุณใช้แท็กสคริปต์เพื่อลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มาได้แล้ว ซึ่งคล้ายกับการรองรับแท็ก <img>
ข้อมูลอัปเดตเพิ่มเติมเกี่ยวกับ API
การเปลี่ยนแปลงอื่นๆ ที่มีขึ้นและอ้างถึงในคู่มือ API มีดังนี้
- แหล่งที่มาสามารถลงทะเบียนด้วย API คำขอ JavaScript
- นำ
window.registerSource
ออกแล้ว - ตอนนี้คุณจะใส่ค่าสำหรับ
attributionsrc
ไม่ได้เมื่อลงทะเบียนแหล่งที่มา - เพิ่มส่วนหัว
Attribution-Reporting-Eligible
ในคำขอการลงทะเบียนแหล่งที่มาขาเข้าแล้ว - มีการเปลี่ยนแปลงเล็กน้อยกับ
encodeURIComponent
- มีการนำคีย์งบประมาณความเป็นส่วนตัวออกจากช่อง
shared_info
ในรายงานที่รวบรวมได้
การสนับสนุนสำหรับบริการรวบรวมข้อมูล
ใน Chrome 104 เราตั้งใจที่จะอัปเดตรูปแบบของข้อมูลบางอย่างภายในรายงานที่รวบรวมได้ เรากำลังสร้างการรองรับการเปลี่ยนแปลงนี้ในบริการรวบรวมข้อมูล ระบบจะอัปเดตเอกสารนี้รวมถึง changelog หลังจากจัดส่งการเปลี่ยนแปลงแล้ว
เราได้รวบรวมเอกสารเคล็ดลับและกลยุทธ์ที่ใช้ได้จริงเพื่อสร้างรายงานสรุป ซึ่งมีข้อมูลเชิงลึกดังนี้
- ภาพรวมของสัญญาณรบกวนในการสร้างรายงานสรุป
- คำอธิบายโดยละเอียดเกี่ยวกับมิติข้อมูล คีย์ และค่า
- คีย์การรวมในทางปฏิบัติ รวมถึงแมปโครงสร้างคีย์
- ค่าที่รวบรวมได้ในทางปฏิบัติและผลกระทบของงบประมาณการมีส่วนร่วม
- คู่มือการทดลองใช้ epsilon
อ่านเพิ่มเติมเกี่ยวกับการอัปเดต
- อ่านสิ่งที่ควรรู้เกี่ยวกับ API
- อ่านการทดสอบการรายงานการระบุแหล่งที่มา: กลยุทธ์และเคล็ดลับสำหรับรายงานสรุป
รูปภาพส่วนหัวมาจาก Diana Polekhina ใน Unsplash