Hướng dẫn này cung cấp thông tin tổng quan và hướng dẫn thiết lập cho cả báo cáo phân bổ ở cấp sự kiện và báo cáo phân bổ tóm tắt bằng Attribution Reporting API.
Để bắt đầu, bạn sẽ tìm hiểu cách:
Phân biệt các loại báo cáo Attribution Reporting API
Hoàn tất các bước triển khai API và tạo báo cáo
Tìm thông tin tham khảo và thông tin khắc phục sự cố
Chọn loại báo cáo
Để đo lường hiệu quả hoạt động của chiến dịch quảng cáo một cách hiệu quả với các mức độ chi tiết và quyền riêng tư khác nhau, Attribution Reporting API cung cấp 2 loại báo cáo riêng biệt:
Báo cáo cấp sự kiện: Cung cấp dữ liệu chi tiết liên kết một lượt nhấp hoặc lượt xem quảng cáo cụ thể (nguồn) với dữ liệu lượt chuyển đổi tương ứng (điều kiện kích hoạt). Báo cáo cấp sự kiện giới hạn lượng dữ liệu lượt chuyển đổi và thêm độ nhiễu vào báo cáo. Đây là lựa chọn lý tưởng cho những trường hợp sử dụng mà việc phân bổ sự kiện riêng lẻ là yếu tố then chốt, chẳng hạn như đo lường phạm vi tiếp cận của chiến dịch.
Báo cáo tóm tắt: Cung cấp dữ liệu tổng hợp về người dùng và có thể bao gồm thông tin chi tiết hơn về lượt chuyển đổi kèm theo thông tin gây nhiễu. Khi sử dụng cả Attribution Reporting API và Private Aggregation API, các báo cáo này được tạo từ báo cáo tổng hợp và cung cấp một mô hình dữ liệu phong phú hơn so với báo cáo cấp sự kiện. Báo cáo tóm tắt đặc biệt hữu ích cho những trường hợp cần thông tin chi tiết tổng hợp, chẳng hạn như tính toán giá trị lượt chuyển đổi hoặc phân tích hiệu suất chiến dịch trên các phân khúc người dùng.
Tổng quan về quy trình triển khai
Các phần sau đây trình bày các bước chung để tạo từng loại báo cáo. Bạn cũng có thể xem Bản minh hoạ Attribution Reporting API để biết hướng dẫn từng bước về toàn bộ quy trình.
Điều kiện tiên quyết: Trang web của bạn phải có chứng chỉ SSL/TLS (HTTPS) thì bạn mới có thể đăng ký nguồn, điều kiện kích hoạt và nhận báo cáo.
Tạo báo cáo cấp sự kiện
Các bước sau đây mô tả cách tạo báo cáo ở cấp sự kiện:
Đăng ký một nguồn: Liên kết một lượt nhấp vào quảng cáo hoặc lượt xem với thông tin phân bổ. Hãy xem phần Đăng ký nguồn phân bổ và Đăng ký nguồn phân bổ để biết hướng dẫn chi tiết. Xin lưu ý rằng quy trình đăng ký có khác biệt đôi chút đối với lượt nhấp và lượt xem.
Đăng ký điều kiện kích hoạt: Ghi lại một sự kiện chuyển đổi và liên kết sự kiện đó với một nguồn đã đăng ký trước đó. Hãy tham khảo phần Đăng ký trình kích hoạt phân bổ để biết hướng dẫn.
Thiết lập một điểm cuối báo cáo: Tạo một điểm cuối trên máy chủ của bạn để nhận báo cáo ở cấp sự kiện. URL điểm cuối phải có định dạng sau:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution. Hãy xem mã ví dụ trongadtech.jsđể biết ví dụ về phương thứcPOST. Để biết thêm thông tin về.well-known, hãy xem Wikipedia.
Để tìm hiểu sâu hơn về báo cáo cấp sự kiện, hãy xem Nội dung giải thích về báo cáo cấp sự kiện.
Tạo báo cáo tóm tắt
Đăng ký một nguồn: Tương tự như đối với báo cáo cấp sự kiện. Hãy xem phần Đăng ký nguồn phân bổ và Đăng ký nguồn phân bổ để biết thông tin chi tiết.
Đăng ký điều kiện kích hoạt: Tương tự như đối với báo cáo ở cấp sự kiện. Xem phần Đăng ký điều kiện kích hoạt phân bổ.
Thiết lập điểm cuối báo cáo: Tạo một điểm cuối để nhận báo cáo tổng hợp. URL phải là:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution. Hãy xemadtech.jsđể biết ví dụ về phương thứcPOSTvà Wikipedia để biết thông tin về.well-known.Phân lô và gửi báo cáo: Phân lô các báo cáo tổng hợp và gửi chúng đến Dịch vụ tổng hợp để xử lý. Sau đó, Dịch vụ tổng hợp sẽ tạo báo cáo tóm tắt. Hãy xem Các chiến lược để xử lý theo lô để biết thêm thông tin.
Để tìm hiểu sâu hơn về báo cáo tóm tắt, hãy tham khảo Trình giải thích báo cáo có thể tổng hợp.
Ngoài các bước triển khai, những chủ đề sau đây sẽ giúp bạn lập kế hoạch cho chiến lược báo cáo tóm tắt:
Thiết lập bộ lọc (không bắt buộc)
Để kiểm soát chi tiết hơn dữ liệu phân bổ mà bạn nhận được, bạn có thể thiết lập bộ lọc.
Việc lọc giúp bạn phân tích dữ liệu một cách tinh tế bằng cách tách riêng các nhóm nhỏ dữ liệu cụ thể để phân tích, giảm nhiễu. Ngoài ra, tính năng này còn giúp theo dõi hiệu suất của các chiến dịch quảng cáo và sự kiện chuyển đổi cụ thể để đo lường chính xác hơn.
Để thiết lập bộ lọc, hãy xem phần Xác định quy tắc tuỳ chỉnh bằng bộ lọc và phần điều kiện kích hoạt của Đăng ký điều kiện kích hoạt phân bổ để biết thông tin chi tiết cụ thể về báo cáo có thể tổng hợp.
Xác nhận rằng bạn đã bật API
Trước khi sử dụng API này, hãy kiểm tra xem API có được bật hay không bằng cách sử dụng mã sau:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
Bước kiểm tra này cho biết liệu API có được phép sử dụng trong bối cảnh hiện tại hay không. Tuy nhiên, chế độ cài đặt trình duyệt của người dùng hoặc các yếu tố khác có thể vẫn ngăn không cho sử dụng API này. Do các yếu tố về quyền riêng tư, không có cách nào theo chương trình để xác nhận chắc chắn khả năng sử dụng API.
Các bước tiếp theo
Các phần sau đây cung cấp thêm thông tin về cách bắt đầu báo cáo phân bổ.