Sau đây là hướng dẫn bắt đầu, bao gồm cả bước thiết lập và thông tin tổng quan nhanh.
Chọn một loại báo cáo
Khi sử dụng Attribution Reporting API, bạn có thể tạo hai loại báo cáo: báo cáo cấp sự kiện và báo cáo tóm tắt. Báo cáo cấp sự kiện yêu cầu ít phải thiết lập hơn so với báo cáo tổng hợp hoặc báo cáo tóm tắt. Vì vậy, đây có thể là nơi phù hợp để bắt đầu. Báo cáo tóm tắt yêu cầu tích hợp với Dịch vụ tổng hợp; báo cáo cấp sự kiện thì không.
Bạn có thể thiết lập báo cáo cho cả báo cáo tóm tắt và báo cáo cấp sự kiện. Các thành phần này bổ sung cho nhau.
Báo cáo cấp sự kiện
Báo cáo cấp sự kiện liên kết một lượt nhấp hoặc lượt xem quảng cáo cụ thể (ở phía quảng cáo) với dữ liệu ở phía chuyển đổi. Để bảo vệ quyền riêng tư của người dùng bằng cách giới hạn việc kết hợp danh tính người dùng trên các trang web, dữ liệu phía chuyển đổi rất hạn chế và dữ liệu không nhiều.
Báo cáo tóm tắt
Báo cáo tóm tắt là một loại báo cáo API Báo cáo phân bổ và API Tổng hợp riêng tư. Báo cáo tóm tắt bao gồm dữ liệu tổng hợp về người dùng và có thể chứa dữ liệu chi tiết về lượt chuyển đổi (kèm theo độ nhiễu). Báo cáo tóm tắt được tạo thành từ các báo cáo tổng hợp.
Triển khai
Bạn có thể bắt đầu bằng cách thử làm theo các bước sau.
Xin lưu ý rằng đối với một nguồn sự kiện nhất định, bạn có thể tạo cả báo cáo cấp sự kiện và báo cáo tổng hợp. Bản minh hoạ sẽ hướng dẫn bạn thực hiện quy trình này.
Tạo báo cáo ở cấp sự kiện
Dưới đây là các bước tối thiểu bạn cần thực hiện để tạo báo cáo cấp sự kiện:
Đăng ký nguồn. Hãy tham khảo bài viết Đăng ký các nguồn phân bổ để biết hướng dẫn. Xin lưu ý rằng các bước áp dụng cho lượt nhấp và lượt xem sẽ khác nhau.
Đăng ký điều kiện kích hoạt. Hãy tham khảo bài viết Đăng ký điều kiện kích hoạt phân bổ để được hướng dẫn.
Thiết lập điểm cuối bằng URL sau:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
Hãy tham khảo mã ví dụ trong advertising.js để xem phương thứcpost
. Bạn có thể tìm hiểu thêm thông tin về .well-known tại đây.
Bạn có thể xem thêm thông tin chi tiết về báo cáo ở cấp sự kiện tại đây.
Tạo báo cáo tóm tắt
Để tạo báo cáo tóm tắt, hãy làm theo các bước cấp cao sau:
Đăng ký nguồn. Hãy tham khảo bài viết Đăng ký các nguồn phân bổ để biết hướng dẫn. Xin lưu ý rằng các bước áp dụng cho lượt nhấp và lượt xem sẽ khác nhau. Bạn có thể xem thêm thông tin chi tiết trong phần Đăng ký nguồn phân bổ.
Đăng ký điều kiện kích hoạt. Hãy tham khảo bài viết Đăng ký điều kiện kích hoạt phân bổ để được hướng dẫn.
Thiết lập điểm cuối cho các báo cáo tổng hợp bằng URL sau:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution
Hãy tham khảo mã ví dụ trongads.js để xem phương thứcpost
. Bạn có thể tìm hiểu thêm thông tin về .well-known tại đây.Tạo lô rồi gửi báo cáo để Dịch vụ tổng hợp xử lý thêm. Dịch vụ này sẽ tạo báo cáo tóm tắt. Hãy tham khảo báo cáo tổng hợp theo lô.
Tìm hiểu thêm thông tin chi tiết về báo cáo tóm tắt tại đây.
Tìm hiểu cách thiết lập báo cáo gỡ lỗi trong loạt bài viết Gỡ lỗi báo cáo phân bổ.
Các khái niệm khác trong báo cáo tóm tắt
Ngoài việc hiểu các bước triển khai ở đây, các khái niệm sau sẽ giúp bạn lập kế hoạch cho chiến lược báo cáo tóm tắt:
Các bước không bắt buộc
- Thiết lập bộ lọc (không bắt buộc):
- Làm theo hướng dẫn trong bài viết Xác định quy tắc tuỳ chỉnh bằng bộ lọc.
- Hãy xem lại thông tin chi tiết cụ thể về các bộ lọc cho báo cáo tổng hợp trong phần điều kiện kích hoạt của nội dung giải thích.
Đừng quên phát hiện tính năng
Trước khi bạn sử dụng API, hãy phát hiện xem API đó có bị chặn trên trang bằng Chính sách về quyền hay không. Để làm như vậy, hãy chạy mã sau:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
Nếu quy trình kiểm tra phát hiện tính năng này trả về giá trị true thì API sẽ được cho phép trong ngữ cảnh (trang) mà quy trình kiểm tra diễn ra.
Xin lưu ý rằng chỉ kiểm tra này không đảm bảo rằng API có thể sử dụng được trên trang đó; người dùng có thể đã tắt API bằng các chế độ cài đặt của trình duyệt hoặc có thể họ có các chế độ cài đặt khác ngăn không cho sử dụng API. Để bảo vệ quyền riêng tư của người dùng, không có cách nào để kiểm tra điều này theo phương thức lập trình.
Các bước tiếp theo
Nếu bạn đã sẵn sàng để bắt đầu triển khai, hãy xem các tài liệu sau:
Thiết lập
- Đăng ký nguồn phân bổ
- Đăng ký một điều kiện kích hoạt phân bổ
- Ưu tiên lượt nhấp, lượt xem hoặc lượt chuyển đổi cụ thể
- Gỡ lỗi Báo cáo phân bổ
- Khoá tổng hợp
Thông tin khái quát
- Báo cáo phân bổ với báo cáo cấp sự kiện
- Báo cáo phân bổ bằng báo cáo tổng hợp
- Các quy tắc ràng buộc đối với dữ liệu báo cáo tổng hợp
- Tìm hiểu về nhiễu
- Xử lý nhiễu
Bản minh hoạ và công cụ
- Bản minh hoạ Attribution Reporting API
- Phòng thí nghiệm tiếng ồn
- Trình xác thực tiêu đề báo cáo phân bổ
Lập kế hoạch
Nếu bạn vẫn đang trong giai đoạn lập kế hoạch, hãy xem các tài liệu sau: