การอัปเดตการรายงานการระบุแหล่งที่มาในเดือนมิถุนายน 2022

ข้อเสนอการรายงานการระบุแหล่งที่มาจะมีการเปลี่ยนแปลงสำหรับ 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

อ่านเพิ่มเติมเกี่ยวกับการอัปเดต

รูปภาพส่วนหัวมาจาก Diana Polekhina ใน Unsplash