[Lỗi thời] Hướng dẫn di chuyển (Chrome 92): API Đo lường lượt chuyển đổi sang API Báo cáo phân bổ

Conversion Measurement API sẽ thay đổi trong Chrome 92.

Điều gì sẽ thay đổi?

Sau những thay đổi trong đề xuất API vào những tháng đầu năm 2021, việc triển khai API trong Chrome đang phát triển. Sau đây là những điểm sẽ thay đổi:

Tên API và tên chính sách về quyền.
Tên thuộc tính HTML và URL .well-known.
Định dạng của báo cáo. Giờ đây, báo cáo được gửi dưới dạng JSON trong phần nội dung yêu cầu.
Nội dung của các báo cáo: credit đã bị xoá, cùng với những báo cáo không có điểm tín dụng.

Những điểm không thay đổi trong Chrome 92 là tập hợp các tính năng được hỗ trợ: báo cáo cấp sự kiện, chỉ dành cho lượt nhấp. Hãy chờ tin cập nhật về vấn đề này. Sau thay đổi này, các bản cập nhật và tính năng khác sẽ được phát hành trong các phiên bản Chrome sau này.

Khi nào những thay đổi này có hiệu lực?

Những thay đổi này có hiệu lực từ Chrome 92, phiên bản ổn định từ ngày 20 tháng 7 năm 2021. Chrome 92 beta được phát hành vào ngày 3 tháng 6 năm 2021.

Bạn nên làm gì?

Nếu đang chạy một thử nghiệm nguồn gốc hoặc đã triển khai bản minh hoạ cho API này, bạn có hai lựa chọn:

Phương án 1 (nên chọn): di chuyển mã của bạn ngay hoặc trong những tuần tới, tốt nhất là trước giữa tháng 7 năm 2021. Bằng cách này, cơ sở mã của bạn sẽ sẵn sàng cho những thay đổi trong tương lai và sẽ tiếp tục hoạt động cho các ứng dụng Chrome mới hơn.
Cách 2: Chờ các bản cập nhật và tính năng khác được phát hành trong các phiên bản Chrome sau này, đồng thời thực hiện tất cả các thay đổi cần thiết về mã cùng một lúc.

Di chuyển

Ví dụ về quy trình di chuyển

Bạn có thể xem ví dụ về quy trình di chuyển cho một ứng dụng minh hoạ nhỏ trong yêu cầu kéo (bản nháp) này.

Cập nhật mã chính sách về quyền

Mã cũ	Mã mới
`allow='conversion-measurement'`	`allow='attribution-reporting'`

Cập nhật mã phát hiện tính năng

Mã cũ	Mã mới
`document.featurePolicy.features() .includes('conversion-measurement')`	`document.featurePolicy.features() .includes('attribution-reporting')`

Cập nhật các thuộc tính HTML

Mã cũ	Mã mới
`conversiondestination`	`attributiondestination`
`impressiondata`	`attributionsourceeventid`
`impressionexpiry`	`attributionexpiry`
`reportingorigin`	`attributionreportto`

Cập nhật các đối số `window.open()`

Bạn có thể đăng ký một nguồn phân bổ cho các thao tác điều hướng do window.open() khởi tạo. Cập nhật các lệnh gọi này nếu bạn đang sử dụng window.open() để đăng ký các nguồn phân bổ.

Mã mới của bạn sẽ có dạng như sau (việc đổi tên này tuân theo quy trình đổi tên thuộc tính HTML):

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

Cập nhật URL và tham số của lệnh gọi đăng ký

Mã cũ	Mã mới
`.well-known/register-conversion?conversion-data={DATA}`	`.well-known/attribution-reporting/trigger-attribution?trigger-data={DATA}`

Cập nhật mã điểm cuối báo cáo

	Mã cũ	Mã mới
Các yêu cầu mà bạn có thể mong đợi từ trình duyệt	`.well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100`	`.well-known/attribution-reporting/trigger-attribution`
Báo cáo đến	Được gửi dưới dạng tham số URL.	Được gửi dưới dạng JSON trong phần nội dung yêu cầu. Dữ liệu báo cáo được đưa vào nội dung yêu cầu dưới dạng một đối tượng JSON có các khoá sau: `source_event_id`: trước đây là `impression-data`, giá trị nhận dạng sự kiện gồm 64 bit được đặt trên nguồn phân bổ. `trigger_data`: trước đây là `conversion-data`, tập dữ liệu 3 bit trong lệnh chuyển hướng điều kiện kích hoạt phân bổ. ⚠️ `credit` đã bị xoá.

Báo cáo phân bổ: tất cả tài nguyên

Xem phần Báo cáo phân bổ.