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

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

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

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

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

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

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

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

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

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

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

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

• ตัวเลือกที่ 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 ออกแล้ว

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

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