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

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

หมายเหตุ: หากมีข้อสงสัยหรือต้องการความช่วยเหลือระหว่างการย้ายข้อมูล ให้เข้าร่วมรายชื่ออีเมลและถามคำถาม

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

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

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

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

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

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

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

หมายเหตุ: จะมีการเปลี่ยนแปลงอื่นๆ กับ API ในเวอร์ชันต่อๆ ไป โดยใช้ชื่อใหม่ที่นำมาใช้ใน Chrome 92

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

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

ย้ายข้อมูล

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

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

อัปเดตโค้ดนโยบายด้านสิทธิ์

รหัสแบบเดิม	รหัสใหม่
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 ถูกนำออกแล้ว

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

โปรดดูการรายงานการระบุแหล่งที่มา