[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ổ

API đo lường lượt chuyển đổi sẽ thay đổi trong Chrome 92.

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

Sau những thay đổi của đề xuất API trong những tháng đầu năm 2021, quy trình 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 quyền.
  • Tên thuộc tính HTML và URL .well-known.
  • Định dạng của báo cáo. Báo cáo giờ đây được gửi dưới dạng JSON trong 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 các báo cáo có thể có 0 tín dụng.

Những điểm không thay đổi trong Chrome 92 là bộ 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ờ đón thông 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 trong tương lai.

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 kể từ Chrome 92, ổn định vào 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 bản dùng thử theo nguyên gốc hoặc đã triển khai bản minh hoạ cho API này, bạn có 2 lựa chọn:

  • Cách 1 (nên dùng): di chuyển mã của bạn ngay hoặc trong các tuần tiếp theo, 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 các 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, rồi thực hiện tất cả thay đổi cần thiết về mã cùng một lúc.

Di chuyển

Ví dụ về việc di chuyển

Bạn có thể xem ví dụ về cách 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 window.open() đối số

Bạn có thể đăng ký nguồn phân bổ cho các thao tác điều hướng do window.open() thực hiện. Hãy 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 diễn ra sau khi đổi tên các 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 thông số và URL 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
Yêu cầu 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 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 đối tượng JSON với các khoá sau:
source_event_id: trước đây là impression-data, mã sự kiện 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 của điều kiện kích hoạt phân bổ.

⚠️ credit đã bị xoá.

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

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