ข้อเสนอ Attribution Reporting มีการเปลี่ยนแปลงสำหรับเวอร์ชัน Chrome 104 พร้อมด้วยกลไก ฟังก์ชันการทำงาน และการอัปเดตของ API ใหม่ กับบริการรวมข้อมูล
การอัปเดตเหล่านี้มีไว้สําหรับใคร
การอัปเดตเหล่านี้มีไว้สำหรับคุณในกรณีต่อไปนี้
- คุณคุ้นเคยกับ API อยู่แล้ว ตัวอย่างเช่น ถ้าคุณเคยสังเกตการณ์ หรือเข้าร่วมการสนทนาในที่เก็บ WICG และต้องการ เข้าใจการเปลี่ยนแปลงที่ทำใน API
- คุณกําลังใช้ Attribution Reporting API ในการสาธิตหรือแผนจะทดสอบใน ช่วงทดลองใช้จากต้นทาง
หากคุณเพิ่งเริ่มต้นใช้งาน API นี้และ/หรือยังไม่ได้ทดลองใช้ ให้ไปที่ข้อมูลเบื้องต้นเกี่ยวกับ API แทน
การอัปเดต Attribution Reporting API
การสาธิตการรายงานการระบุแหล่งที่มา ได้รับการอัปเดตให้สอดคล้องกับการเปลี่ยนแปลงล่าสุดของรายงานการระบุแหล่งที่มาแล้ว API ฝั่งไคลเอ็นต์
การเปลี่ยนแปลงส่วนใหญ่ไม่ต้องมีการดำเนินการ ส่วนขยายที่จำเป็นต้องมีการอัปเดตสำหรับ ซึ่งได้ไฮไลต์การนำไปใช้ไว้ที่ด้านล่างนี้
(ขอให้ดำเนินการ) ส่วนหัวแบบรวมสำหรับการลงทะเบียน
ส่วนหัวทั้งหมดรวมกันแล้ว ขณะนี้มีส่วนหัวเพียง 1 รายการสำหรับแหล่งที่มาและอีก 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 เพื่อดูข้อมูลเพิ่มเติม
การสร้างรายงาน
คุณอาจเลือกสร้างเฉพาะรายงานที่รวบรวมได้ ซึ่งรวมข้อมูลไว้ ลงในรายงานสรุป หากตัวกรองไม่ตรงกับทริกเกอร์เหตุการณ์ใดๆ ไม่ต้อง จะมีการสร้างรายงานระดับเหตุการณ์ขึ้น
การตั้งค่าคีย์การแก้ไขข้อบกพร่องแบบรวม
ตอนนี้ ควรตั้งค่าคีย์การแก้ไขข้อบกพร่องในส่วนหัวแหล่งที่มาและส่วนหัวทริกเกอร์ แทน โดยมีส่วนหัวแยกกัน ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีแก้ไขข้อบกพร่อง รายงานของ Google
ลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา
ตอนนี้คุณสามารถใช้แท็กสคริปต์เพื่อลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มาได้แล้ว ซึ่งคล้ายกับการสนับสนุน
สำหรับแท็ก <img>
การอัปเดต API เพิ่มเติม
การเปลี่ยนแปลงอื่นๆ ที่มีการทําและอ้างถึงในคู่มือ API มีดังนี้
- สามารถลงทะเบียนแหล่งที่มาด้วย API คำขอ JavaScript
- นำ
window.registerSource
ออกแล้ว - คุณจะใส่ค่าสำหรับ
attributionsrc
หรือไม่ก็ได้เมื่อลงทะเบียน แหล่งที่มา - เพิ่มส่วนหัว
Attribution-Reporting-Eligible
ในแหล่งที่มาขาเข้าแล้ว คำขอลงทะเบียน - มีการเปลี่ยนแปลงเล็กน้อยใน
encodeURIComponent
- มีการนำคีย์งบประมาณความเป็นส่วนตัวออก
จากช่อง
shared_info
ในรายงานที่รวบรวมได้
การสนับสนุนสำหรับบริการรวมข้อมูล
ใน Chrome 104 เราตั้งใจที่จะอัปเดตรูปแบบของข้อมูลบางอย่างภายใน รายงานที่รวบรวมได้ เรากำลังสร้างการสนับสนุนสำหรับการเปลี่ยนแปลงนี้ใน บริการรวมข้อมูล เอกสารนี้จะได้รับการอัปเดต และ changelog หลังจากมีการจัดส่งการเปลี่ยนแปลงแล้ว
เราได้รวบรวมเอกสารเคล็ดลับและกลยุทธ์ที่ใช้ได้จริงเพื่อสร้างข้อมูลสรุป รายงานของ Google ข้อมูลเชิงลึกมีมากมาย ได้แก่
- ภาพรวมของความผันผวนในการสร้างรายงานสรุป
- คำอธิบายอย่างละเอียดเกี่ยวกับมิติข้อมูล คีย์ และค่า
- คีย์การสรุปรวมในเชิงปฏิบัติ รวมถึงแผนผังโครงสร้างหลัก
- ค่าที่รวบรวมได้ในทางปฏิบัติ และผลกระทบของงบประมาณการมีส่วนร่วม
- คู่มือในการทดลองใช้ epsilon
อ่านเพิ่มเติมเกี่ยวกับการอัปเดต
- โปรดอ่านสิ่งที่คุณควรรู้เกี่ยวกับ API
- อ่านการทดสอบด้วยการระบุแหล่งที่มา: กลยุทธ์และเคล็ดลับสำหรับรายงานสรุป
รูปภาพส่วนหัวมาจาก Diana Polekhina ใน Unsplash