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 tóm tắt bằng API Báo cáo phân bổ.
Để 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à khắc phục sự cố
Chọn loại báo cáo
Để đo lường hiệu suất của chiến dịch quảng cáo một cách hiệu quả với nhiều mức độ chi tiết và quyền riêng tư, Attribution Reporting API cung cấp hai 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à làm tăng độ nhiễu trong báo cáo. Đây là những mô hình lý tưởng cho các trường hợp sử dụng mà mô hình phân bổ sự kiện riêng lẻ là yếu tố chính, 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 người dùng tổng hợp và có thể bao gồm thông tin chi tiết hơn về lượt chuyển đổi cùng với thông tin gây nhiễu. Bằng cách 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ô 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 các 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 của chiến dịch trên các phân khúc người dùng.
Tổng quan về cách triển khai
Các phần sau đây trình bày các bước tổng quan để tạo từng loại báo cáo. Bạn cũng có thể làm theo Bản minh hoạ API Báo cáo phân bổ để xem 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ý 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 bài viết Đă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ý sẽ hơi khác đố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 đ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 tuân theo định dạng sau:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution. 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 bài viết 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ý 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 đ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.Gửi báo cáo theo lô: Gửi báo cáo tổng hợp theo lô đế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 phần Chiến lược tạo 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 Nội dung giải thích về báo cáo tổng hợp.
Ngoài các bước triển khai, các chủ đề sau đây sẽ giúp bạn lập kế hoạch 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.
Tính năng lọc cung cấp bản phân tích dữ liệu tinh vi, tách riêng các nhóm nhỏ dữ liệu cụ thể để phân tích, giúp giảm độ nhiễu. Tính năng này cũng 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 tính năng lọc, hãy xem bài viết 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 trong bài viết Đăng ký điều kiện kích hoạt phân bổ để biết thông tin chi tiết dành riêng cho báo cáo tổng hợp.
Xác nhận API đã được bật
Trước khi sử dụng API, hãy kiểm tra xem API đó có được bật hay không bằ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 trong ngữ 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 vẫn có thể ngăn việc sử dụng API. Do các cân nhắc về quyền riêng tư, không có cách nào mang tính lập trình để xác nhận chắc chắn khả năng hữu dụng của 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 sử dụng báo cáo phân bổ.