Thông tin cập nhật về Báo cáo phân bổ vào tháng 6 năm 2022

Đề 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

Hình ảnh tiêu đề là của Diana Polekhina trên Unsplash.