[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, 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 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 hiện đượ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 các báo cáo sẽ có 0 tín dụng.

Chrome 92 vẫn giữ nguyên 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. Chúng tôi sẽ cập nhật thông tin 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.

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

Những thay đổi này có hiệu lực kể từ phiên bản 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ó hai lựa chọn:

  • Phương án 1 (nên chọn): di chuyển mã 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 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 trong tương lai, đồng thời thực hiện tất cả các thay đổi mã cần thiết cùng một lúc.

Di chuyển

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

Bạn có thể xem ví dụ về việc 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 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 thuộc tính HTML

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

Cập nhật đố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ý 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ố 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à trình duyệt sẽ gửi .well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100 .well-known/attribution-reporting/trigger-attribution
Báo cáo sắp tới Đượ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 phần 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 đ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ổ.