Đề xuất Báo cáo phân bổ sẽ thay đổi trong Chrome phiên bản 104, với các cơ chế, chức năng API mới và nội dung cập nhật cho dịch vụ tổng hợp.
Những nội dung cập nhật này dành cho đối tượng nào?
Những nội dung cập nhật này là dành cho bạn nếu:
- Bạn đã quen thuộc với API. Ví dụ: nếu bạn đang quan sát hoặc tham gia vào các cuộc thảo luận trên kho lưu trữ WICG và muốn tìm hiểu những thay đổi đối với API này.
- Bạn đang sử dụng Attribution Reporting API trong bản minh hoạ hoặc dự định thử nghiệm trong bản dùng thử theo nguyên gốc.
Nếu bạn chỉ mới bắt đầu sử dụng API này và/hoặc chưa thử nghiệm API, hãy chuyển thẳng đến phần giới thiệu về API.
Nội dung cập nhật về Attribution Reporting API
Bản minh hoạ Báo cáo phân bổ đã được cập nhật để phản ánh những thay đổi mới nhất đối với API báo cáo phân bổ phía máy khách.
Hầu hết các thay đổi đều không yêu cầu hành động. Những mục cần cập nhật để triển khai đã được làm nổi bật bên dưới.
(Việc cần làm) tiêu đề hợp nhất để đăng ký
Các tiêu đề đã được hợp nhất. Hiện chỉ có một tiêu đề cho các nguồn và một tiêu đề cho các điều kiện kích hoạt, được định dạng trong JSON.
- Để đăng ký nguồn phân bổ, bạn có thể phản hồi các yêu cầu đăng ký với tiêu đề
Attribution-Reporting-Register-Source
. - Để hoàn tất việc đăng ký điều kiện kích hoạt, hãy đặt tiêu đề
Attribution-Reporting-Register-Trigger
.
Thay đổi này yêu cầu hành động. Hãy tham khảo Hướng dẫn cho nhà phát triển API để biết thêm thông tin.
(Việc cần làm) các khoá tổng hợp hiện là một từ điển
Để đăng ký nguồn phân bổ, hãy tiếp tục sử dụng aggregation_keys
, nhưng bây giờ được lưu trữ dưới dạng từ điển JSON thay vì dưới dạng danh sách.
Ví dụ:
"aggregation_keys": {
// Generate a "0x159" key piece for the key named "campaignCounts".
"campaignCounts": "0x159", // User saw ad from campaign 345 (out of 511)
// Generates a "0x5" key piece (low order bits of the key) for
// the key named "geoValue".
"geoValue": "0x5" // Source-side geo region = 5 (US), out of a possible ~100 regions
}
Thay đổi này yêu cầu hành động. Hãy tham khảo sổ tay API để biết thêm thông tin.
Tạo báo cáo
Bạn có thể chọn chỉ tạo các báo cáo tổng hợp mà có thể được tổng hợp thành báo cáo tóm tắt. Nếu bộ lọc của bạn không khớp với bất kỳ điều kiện kích hoạt sự kiện nào, thì sẽ không có báo cáo cấp sự kiện nào được tạo.
Chế độ cài đặt khoá gỡ lỗi hợp nhất
Bây giờ, khoá gỡ lỗi phải được đặt trong tiêu đề nguồn và tiêu đề điều kiện kích hoạt, thay vì đặt các tiêu đề riêng biệt. Tìm hiểu thêm về cách gỡ lỗi báo cáo.
Đăng ký nguồn phân bổ
Giờ đây, bạn có thể dùng thẻ tập lệnh để đăng ký các nguồn phân bổ, tương tự như việc hỗ trợ thẻ <img>
.
Thông tin cập nhật khác về API
Những thay đổi khác đã được thực hiện và trích dẫn trong sổ tay API bao gồm:
- Bạn có thể đăng ký nguồn bằng API yêu cầu JavaScript.
- Xoá
window.registerSource
. - Hiện bạn không bắt buộc phải thêm giá trị cho
attributionsrc
khi đăng ký nguồn. - Đã thêm tiêu đề
Attribution-Reporting-Eligible
vào các yêu cầu đăng ký nguồn tới. - Có một thay đổi nhỏ đối với
encodeURIComponent
. - Khoá ngân sách quyền riêng tư đã bị xoá khỏi trường
shared_info
trong báo cáo tổng hợp.
Hỗ trợ Dịch vụ tổng hợp
Trong Chrome 104, chúng tôi dự định cập nhật định dạng của một số thông tin bên trong báo cáo tổng hợp. Chúng tôi hiện đang xây dựng chức năng hỗ trợ cho thay đổi này trong Dịch vụ tổng hợp. Tài liệu này cũng như nhật ký thay đổi sẽ được cập nhật sau khi các thay đổi được chuyển.
Chúng tôi đã thu thập một tài liệu về các mẹo và chiến lược thiết thực để tạo báo cáo tóm tắt. Có một số thông tin chi tiết, bao gồm:
- Tổng quan về nhiễu trong quá trình tạo báo cáo tóm tắt
- Nội dung giải thích chi tiết về phương diện, khoá và giá trị
- Khoá tổng hợp trong thực tế, bao gồm bản đồ cấu trúc khoá
- Các giá trị tổng hợp trong thực tế và ý nghĩa của ngân sách đóng góp
- Hướng dẫn thử nghiệm epsilon
Đọc thêm về các thay đổi này
- Đọc Những điều bạn cần biết về API.
- Đọc bài viết Thử nghiệm với Báo cáo phân bổ: Chiến lược và mẹo cho báo cáo tóm tắt.
Hình ảnh tiêu đề là của Diana Polekhina trên Unsplash.