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

ข้อเสนอ 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

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

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