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

Thực hiện theo các thay đổi của đề xuất API trong những tháng đầu năm 2021, chúng tôi sẽ ngày càng phát triển việc triển khai API trong Chrome. 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. Báo cáo hiện được gửi dưới dạng JSON trong nội dung yêu cầu.
  • Nội dung của báo cáo: credit đã bị xoá, cùng với các báo cáo sẽ có 0 tín dụng.

Không có gì 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. 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.

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

Những thay đổi này sẽ có hiệu lực kể từ Chrome 92, ổn định vào ngày 20 tháng 7 năm 2021. Bản thử nghiệm Chrome 92 đượ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, thì bạn có hai tùy chọn:

  • Cách 1 (nên chọn): di chuyển mã của bạn ngay bây giờ hoặc trong những 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à tiếp tục hoạt động cho các ứng dụng Chrome mới hơn.
  • Lựa chọn 2: Đợi chúng tôi ra mắt các bản cập nhật và tính năng khác trong các phiên bản Chrome trong tương lai. và 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ề 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ã của 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 các 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ý 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 các thuộc tính HTML đổi tên):

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 cuộc 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 bằng 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 điều kiện kích hoạt phân bổ chuyển hướng.

⚠️ 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ổ.