Phần 1/3 về cách gỡ lỗi Báo cáo phân bổ. Tìm hiểu lý do việc gỡ lỗi quan trọng và thời điểm sử dụng báo cáo gỡ lỗi trong quá trình kiểm thử.
Lý do bạn cần báo cáo gỡ lỗi
Nếu đang kiểm thử API Báo cáo phân bổ, bạn nên kiểm tra để đảm bảo rằng tính năng tích hợp của mình đang hoạt động đúng cách, hiểu rõ sự khác biệt trong kết quả đo lường giữa việc triển khai dựa trên cookie và triển khai Báo cáo phân bổ, đồng thời khắc phục mọi vấn đề về tính năng tích hợp.
Bạn cần có báo cáo gỡ lỗi để hoàn thành các nhiệm vụ này. Do đó, bạn nên thiết lập các chế độ này.
Bảng thuật ngữ
Các khía cạnh chính của báo cáo gỡ lỗi
Hai loại báo cáo gỡ lỗi
Có hai loại báo cáo gỡ lỗi. Hãy sử dụng cả hai, vì chúng đáp ứng các trường hợp sử dụng khác nhau.
Báo cáo gỡ lỗi thành công
Báo cáo gỡ lỗi thành công theo dõi quá trình tạo thành công báo cáo phân bổ. Các giá trị này liên quan trực tiếp đến một báo cáo phân bổ.
Báo cáo gỡ lỗi thành công đã có từ Chrome 101 (tháng 4 năm 2022).
Báo cáo gỡ lỗi chi tiết
Báo cáo gỡ lỗi chi tiết giúp bạn hiểu rõ hơn về nguồn và sự kiện kích hoạt. Nhờ đó, bạn có thể đảm bảo rằng các nguồn đã được đăng ký thành công hoặc theo dõi các báo cáo bị thiếu và xác định lý do các báo cáo đó bị thiếu (lỗi trong nguồn hoặc sự kiện kích hoạt, lỗi khi gửi hoặc tạo báo cáo). Báo cáo gỡ lỗi chi tiết cho biết:
- Các trường hợp trình duyệt đăng ký thành công một nguồn.
- Các trường hợp trình duyệt không đăng ký thành công một nguồn hoặc sự kiện kích hoạt — tức là trình duyệt sẽ không tạo báo cáo phân bổ.
- Các trường hợp không thể tạo hoặc gửi báo cáo phân bổ vì lý do nào đó.
Báo cáo gỡ lỗi chi tiết bao gồm trường type mô tả một lượt đăng ký nguồn thành công hoặc lý do khiến báo cáo nguồn, điều kiện kích hoạt hoặc báo cáo phân bổ không được tạo.
Báo cáo gỡ lỗi chi tiết đã có từ Chrome 109 (tháng 1 năm 2023) – ngoại trừ báo cáo gỡ lỗi chi tiết về việc đăng ký nguồn thành công được thêm vào sau trong Chrome 112.
Xem xét các báo cáo mẫu trong phần Phần 2: Thiết lập báo cáo gỡ lỗi.
Báo cáo gỡ lỗi dựa trên cookie
Để sử dụng báo cáo gỡ lỗi, nguồn báo cáo cần đặt cookie.
Nếu nguồn được định cấu hình để nhận báo cáo là bên thứ ba, thì cookie này sẽ là cookie của bên thứ ba. Điều này có nghĩa là báo cáo gỡ lỗi chỉ được tạo nếu trình duyệt của người dùng cho phép cookie của bên thứ ba.
Báo cáo gỡ lỗi được gửi ngay lập tức
Trình duyệt sẽ gửi ngay báo cáo gỡ lỗi đến nguồn báo cáo. Điều này khác với báo cáo phân bổ, báo cáo này được gửi trễ.
Báo cáo gỡ lỗi thành công được tạo và gửi ngay khi báo cáo phân bổ tương ứng được tạo, tức là khi đăng ký điều kiện kích hoạt.
Báo cáo gỡ lỗi chi tiết được gửi ngay sau khi đăng ký nguồn hoặc điều kiện kích hoạt.
Báo cáo gỡ lỗi có các đường dẫn điểm cuối khác nhau
Giống như báo cáo phân bổ, tất cả báo cáo gỡ lỗi đều được gửi đến nguồn báo cáo. Báo cáo gỡ lỗi được gửi đến 3 điểm cuối riêng biệt của nguồn báo cáo:
- Điểm cuối cho báo cáo gỡ lỗi thành công, cấp sự kiện
- Điểm cuối cho báo cáo gỡ lỗi thành công, có thể tổng hợp
- Điểm cuối cho báo cáo gỡ lỗi chi tiết, ở cấp sự kiện và có thể tổng hợp.
Tìm hiểu thêm trong phần Phần 2: Thiết lập báo cáo gỡ lỗi.
Trường hợp sử dụng
Kiểm tra cơ bản về việc tích hợp theo thời gian thực
Báo cáo gỡ lỗi được gửi đến điểm cuối của bạn ngay lập tức, không giống như báo cáo phân bổ được trì hoãn để bảo vệ quyền riêng tư của người dùng. Sử dụng báo cáo gỡ lỗi làm tín hiệu theo thời gian thực cho biết quá trình tích hợp của bạn với API Báo cáo phân bổ đang hoạt động.
Tìm hiểu cách thực hiện việc này trong phần Phần 3: Sách dạy nấu ăn về gỡ lỗi.
Phân tích tổn thất
Không giống như cookie của bên thứ ba, Attribution Reporting API có các biện pháp bảo vệ quyền riêng tư tích hợp sẵn, được thiết kế để tạo ra sự cân bằng giữa tiện ích và quyền riêng tư. Điều này có nghĩa là với Attribution Reporting API, bạn có thể không thu thập được tất cả dữ liệu đo lường mà bạn có thể thu thập bằng cookie. Không phải tất cả lượt chuyển đổi mà bạn có thể theo dõi bằng cookie của bên thứ ba đều sẽ tạo ra báo cáo phân bổ.
Ví dụ: đối với báo cáo cấp sự kiện, bạn có thể đăng ký tối đa một lượt chuyển đổi cho mỗi lượt hiển thị. Điều này có nghĩa là đối với một lượt hiển thị quảng cáo nhất định, bạn sẽ chỉ nhận được một báo cáo phân bổ, bất kể người dùng chuyển đổi bao nhiêu lần.
Sử dụng báo cáo gỡ lỗi để biết sự khác biệt giữa kết quả đo lường dựa trên cookie và kết quả bạn nhận được bằng Attribution Reporting API. Xác định chính xác những lượt chuyển đổi được báo cáo, số lượt chuyển đổi không được báo cáo, cụ thể là những lượt chuyển đổi nào và lý do.
Tìm hiểu cách chạy phân tích tổn thất trong phần Phần 3: Sách hướng dẫn gỡ lỗi.
Khắc phục sự cố
Mặc dù tổn thất do việc bảo vệ quyền riêng tư hoặc tài nguyên là điều có thể dự kiến, nhưng tổn thất khác có thể là ngoài ý muốn. Việc định cấu hình không chính xác trong quá trình triển khai hoặc lỗi trong chính trình duyệt có thể khiến báo cáo bị thiếu.
Bạn có thể sử dụng báo cáo gỡ lỗi để phát hiện và khắc phục vấn đề triển khai từ phía mình hoặc báo cáo lỗi tiềm ẩn cho các nhóm trình duyệt. Tìm hiểu cách thực hiện việc này trong phần Phần 3: Sách dạy nấu ăn về gỡ lỗi.
Kiểm tra cấu hình nâng cao
Một số tính năng của Attribution Reporting API cho phép bạn tuỳ chỉnh hành vi của API. Một số ví dụ: quy tắc lọc, quy tắc loại bỏ trùng lặp và quy tắc ưu tiên.
Khi sử dụng các tính năng này, hãy sử dụng báo cáo gỡ lỗi để kiểm tra xem logic của bạn có dẫn đến hành vi dự kiến trong phiên bản phát hành chính thức hay không mà không cần chờ báo cáo phân bổ. Tìm hiểu cách thực hiện việc này trong phần Phần 3: Sách dạy nấu ăn về gỡ lỗi.
Kiểm thử cục bộ bằng báo cáo tổng hợp
Không giống như báo cáo phân bổ tổng hợp được mã hoá, báo cáo gỡ lỗi tổng hợp bao gồm cả tải trọng chưa mã hoá.
Sử dụng báo cáo gỡ lỗi tổng hợp để xác thực nội dung của báo cáo tổng hợp và tạo báo cáo tóm tắt bằng công cụ tổng hợp cục bộ để kiểm thử.
Xử lý lại báo cáo Dịch vụ tổng hợp
Một ưu điểm khác của việc sử dụng chế độ gỡ lỗi là cho phép bạn xử lý lại các báo cáo. Do đó, để xử lý báo cáo nhiều lần, hãy nhớ bật báo cáo gỡ lỗi. Bạn nên xử lý lại báo cáo khi:
- đang cố gắng gỡ lỗi Dịch vụ tổng hợp.
- thử nghiệm nhiều chiến lược gộp nhóm.
- thử nghiệm với nhiều giá trị epsilon.
Khôi phục dữ liệu
Các công nghệ quảng cáo nên bật chế độ gỡ lỗi để nhận báo cáo gỡ lỗi nhằm khôi phục dữ liệu báo cáo. Điều này hữu ích trong trường hợp gặp vấn đề về Dịch vụ tổng hợp, chẳng hạn như các dịch vụ không hoạt động hoặc không phản hồi có thể khiến quá trình tạo báo cáo tóm tắt không thành công.