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 cho phiên bản Chrome 104, với nội dung cập nhật, chức năng và cơ chế API mới cho dịch vụ tổng hợp.

Những bản cập nhật này dành cho ai?

Những nội dung cập nhật này áp dụng 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 thảo luận trên kho lưu trữ của WICG và muốn tìm hiểu những thay đổi đối với API.
  • Bạn đang sử dụng Attribution Reporting API trong bản minh hoạ hoặc kế hoạch thử nghiệm trong bản dùng thử theo nguyên gốc.

Nếu bạn mới bắt đầu sử dụng API này và/hoặc chưa thử nghiệm chưa, hãy trực tiếp chuyển đến phần giới thiệu về API.

Thông tin 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 Báo cáo phân bổ API phía máy khách.

Bạn không cần làm gì với hầu hết các thay đổi. Những ứng dụng cần cập nhật cho cách triển khai đã được nhấn mạnh 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 theo JSON.

  • Để đăng ký các nguồn phân bổ, bạn có thể phản hồi các yêu cầu đăng ký bằng tiêu đề Attribution-Reporting-Register-Source.
  • Để hoàn tất quá trình đăng ký điều kiện kích hoạt, hãy đặt giá trị Tiêu đề Attribution-Reporting-Register-Trigger.

Bạn cần thực hiện hành động thay đổi nà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) Khoá tổng hợp nay là một từ điển

Để đăng ký nguồn phân bổ, tiếp tục sử dụng aggregation_keys nhưng hiện được lưu trữ dưới dạng từ điển JSON của một 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
 }

Bạn cần thực hiện hành động thay đổi này. Tham khảo Sổ tay về 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 có thể được tổng hợp vào 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ì không các báo cáo ở cấp sự kiện sẽ được tạo.

Chế độ cài đặt khoá gỡ lỗi hợp nhất

Bạn hiện phải đặt khoá gỡ lỗi trong tiêu đề nguồn và điều kiện kích hoạt, thay vì với 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 các thẻ tập lệnh để đăng ký các nguồn phân bổ, tương tự như việc hỗ trợ cho thẻ <img>.

Thông tin cập nhật khác về API

Các 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.
  • Giờ đây, 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 nguồn đến yêu cầu đăng ký.
  • Có một thay đổi nhỏ đối với encodeURIComponent.
  • Khoá ngân sách quyền riêng tư đã bị xoá từ 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 dịch vụ hỗ trợ cho thay đổi này trong Dịch vụ tổng hợp. Tài liệu này sẽ được cập nhật, cũng như nhật ký thay đổi, sau khi gửi nội dung thay đổi.

Chúng tôi đã thu thập tài liệu về các chiến lược và mẹo thiết thực để tạo bản tóm tắt báo cáo. Có một số thông tin chi tiết, bao gồm:

  • Tổng quan về yếu tố gây 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 cả bản đồ cấu trúc khoá
  • 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 với epsilon

Đọc thêm về nội dung cập nhật

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