หน้านี้ได้รับการแปลโดย Cloud Translation API

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

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

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

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

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

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

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

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

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

หากคุณใช้ช่วงทดลองใช้จากต้นทางหรือติดตั้งใช้งานเดโมสําหรับ 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` ถูกนำออกแล้ว

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

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