[เลิกใช้แล้ว] คำแนะนำในการย้ายข้อมูล (Chrome 92): จาก API การวัด Conversion ไปใช้ Attribution Reporting API

API การวัด Conversion จะมีการเปลี่ยนแปลงใน Chrome 92

สิ่งที่เปลี่ยนแปลงไป

การใช้งาน API ใน Chrome กำลังพัฒนาไปตามการเปลี่ยนแปลงของข้อเสนอ API ในช่วงเดือนแรกๆ ของปี 2021 โดยสิ่งที่จะเปลี่ยนแปลงมีดังนี้

  • ชื่อ API และชื่อนโยบายสิทธิ์
  • ชื่อแอตทริบิวต์ HTML และ .well-known URL
  • รูปแบบของรายงาน ขณะนี้ระบบจะส่งรายงานเป็น JSON ในเนื้อหาคำขอ
  • เนื้อหาของรายงาน: credit ถูกนำออกแล้ว พร้อมกับรายงานที่ควรจะมีเครดิตเป็น 0

สิ่งที่ยังคงไม่เปลี่ยนแปลงใน Chrome 92 คือชุดฟีเจอร์ที่รองรับ ได้แก่ รายงานระดับเหตุการณ์สําหรับการคลิกเท่านั้น โปรดรอติดตามข้อมูลอัปเดตเกี่ยวกับเรื่องนี้ หลังจากทำการเปลี่ยนแปลงนี้แล้ว เราจะเผยแพร่การอัปเดตและฟีเจอร์อื่นๆ ใน Chrome เวอร์ชันในอนาคต

การเปลี่ยนแปลงเหล่านี้จะมีผลเมื่อใด

การเปลี่ยนแปลงเหล่านี้จะมีผลตั้งแต่วันที่ 20 กรกฎาคม 2021 เป็นต้นไปใน Chrome 92 เวอร์ชันเสถียร Chrome 92 รุ่นเบต้าเปิดตัวเมื่อวันที่ 3 มิถุนายน 2021

คุณควรทำอย่างไร

หากคุณกำลังเรียกใช้ช่วงทดลองใช้แหล่งที่มาหรือได้ติดตั้งใช้งานเดโมสำหรับ API นี้ คุณจะมี 2 ตัวเลือกดังนี้

  • ตัวเลือกที่ 1 (แนะนำ): ย้ายข้อมูลโค้ดตอนนี้หรือในอีกไม่กี่สัปดาห์ข้างหน้า โดยควรย้ายก่อน กลางเดือนกรกฎาคม 2021 ด้วยวิธีนี้ ฐานโค้ดของคุณจะพร้อมสำหรับการเปลี่ยนแปลงในอนาคตและจะ ทำงานต่อไปได้สำหรับไคลเอ็นต์ Chrome เวอร์ชันใหม่กว่า
  • ตัวเลือกที่ 2: รอการอัปเดตและฟีเจอร์เพิ่มเติมที่จะเปิดตัวใน Chrome เวอร์ชันในอนาคต และทำการเปลี่ยนแปลงโค้ดที่จำเป็นทั้งหมดพร้อมกัน

ย้ายข้อมูล

ตัวอย่างการย้ายข้อมูล

คุณดูตัวอย่างการย้ายข้อมูลสำหรับแอปเดโมขนาดเล็กได้ในคำขอ Pull (ฉบับร่าง) นี้

อัปเดตรหัสของนโยบายสิทธิ์

โค้ดเดิม รหัสใหม่
allow='conversion-measurement' allow='attribution-reporting'

อัปเดตโค้ดการตรวจหาฟีเจอร์

โค้ดเดิม รหัสใหม่
document.featurePolicy.features()
.includes('conversion-measurement')
document.featurePolicy.features()
.includes('attribution-reporting')

อัปเดตแอตทริบิวต์ HTML

โค้ดเดิม รหัสใหม่
conversiondestination attributiondestination
impressiondata attributionsourceeventid
impressionexpiry attributionexpiry
reportingorigin attributionreportto

อัปเดตอาร์กิวเมนต์ window.open()

ลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มาได้สำหรับการนําทางที่เริ่มต้นโดย window.open() อัปเดตการเรียกเหล่านี้หากคุณใช้ window.open() เพื่อลงทะเบียนแหล่งที่มาของการระบุแหล่งที่มา

โค้ดใหม่ควรมีลักษณะดังนี้ (การเปลี่ยนชื่อนี้เป็นไปตามการเปลี่ยนชื่อแอตทริบิวต์ HTML)

window.open(
  'https://dest.example',
  '_blank',
  'attributionsourceeventid=1234,attributiondestination=https://dest.example,attributionreportto=https://reporter.example,attributionexpiry=604800000'
);

อัปเดต URL และพารามิเตอร์การเรียกการจดทะเบียน

โค้ดเดิม รหัสใหม่
.well-known/register-conversion?conversion-data={DATA} .well-known/attribution-reporting/trigger-attribution?trigger-data={DATA}

อัปเดตโค้ดปลายทางการรายงาน

โค้ดเดิม รหัสใหม่
คำขอที่คาดหวังจากเบราว์เซอร์ .well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100 .well-known/attribution-reporting/trigger-attribution
รายงานที่ได้รับ ส่งเป็นพารามิเตอร์ URL ส่งเป็น JSON ในเนื้อหาคำขอ

ข้อมูลรายงานจะรวมอยู่ในเนื้อหาของคำขอเป็นออบเจ็กต์ JSON ที่มีคีย์ต่อไปนี้
source_event_id: เดิมคือ impression-data ซึ่งเป็นรหัสเหตุการณ์แบบ 64 บิตที่ตั้งค่าไว้ในแหล่งที่มาของการระบุแหล่งที่มา
trigger_data: เดิมคือ conversion-data ชุดข้อมูล 3 บิตในทริกเกอร์การระบุแหล่งที่มา การเปลี่ยนเส้นทาง

⚠️ ระบบได้นำcreditออกแล้ว

การรายงานการระบุแหล่งที่มา: แหล่งข้อมูลทั้งหมด

ดูAttribution Reporting