Phần 1 trong 3 phần về gỡ lỗi Attribution Reporting. Tìm hiểu lý do việc gỡ lỗi là cần thiết 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ử Attribution Reporting API, bạn nên kiểm tra để đảm bảo rằng hoạt động tích hợp của bạn đang diễn ra đúng cách, nắm được những điểm khác biệt trong kết quả đo lường giữa việc triển khai dựa trên cookie và việc triển khai Attribution Reporting, đồng thời khắc phục mọi vấn đề với hoạt động tích hợp.
Bạn cần có báo cáo gỡ lỗi để hoàn tất các tác vụ này. Do đó, bạn nên thiết lập các chỉ số 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ó 2 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 việc tạo thành công một báo cáo phân bổ. Chúng 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 biết rõ hơn về nguồn và sự kiện điều 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 khiến chúng bị thiếu (lỗi trong sự kiện nguồn hoặc điều 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 sự kiện 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 một trường type mô tả một lượt đăng ký nguồn thành công hoặc lý do khiến một 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ó sẵn 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 này trong Chrome 112.
Xem các báo cáo mẫu trong 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 gốc báo cáo cần đặt cookie.
Nếu nguồn gốc đượ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 cookie của bên thứ ba được cho phép trong trình duyệt của người dùng.
Báo cáo gỡ lỗi được gửi ngay lập tức
Trình duyệt sẽ gửi ngay các 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ổ được gửi đi muộn.
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 khi có lượt đă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 gốc 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 2: Thiết lập báo cáo gỡ lỗi.
Trường hợp sử dụng
Kiểm tra tích hợp cơ bản theo thời gian thực
Báo cáo gỡ lỗi được gửi ngay đến điểm cuối của bạn, không giống như báo cáo phân bổ bị 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 Attribution Reporting API đang hoạt động.
Tìm hiểu cách thực hiện việc này trong Phần 3: Sổ tay 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ế để cân bằng giữa tính hữu í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 báo cáo phân bổ.
Một 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 để nắm được 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 quy trình phân tích tổn thất trong Phần 3: Sổ tay gỡ lỗi.
Khắc phục sự cố
Mặc dù tổn thất do các biện pháp bảo vệ quyền riêng tư hoặc tài nguyên là điều có thể xảy ra, nhưng tổn thất khác có thể là điều không mong muốn. Việc định cấu hình sai 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 ở phía bạn 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 3: Sổ tay 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 các hành vi của API. Quy tắc lọc, quy tắc loại bỏ dữ liệu trùng lặp và quy tắc về mức độ ưu tiên là một số ví dụ.
Khi sử dụng các tính năng này, hãy 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 quá trình sản xuất 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 3: Sổ tay gỡ lỗi.
Kiểm thử cục bộ bằng các báo cáo tổng hợp
Không giống như các báo cáo phân bổ có thể tổng hợp được mã hoá, báo cáo gỡ lỗi có thể tổng hợp bao gồm tải trọng chưa mã hoá.
Sử dụng báo cáo gỡ lỗi có thể tổng hợp để xác thực nội dung của báo cáo có thể 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 của Dịch vụ tổng hợp
Một lợi ích khác của việc sử dụng chế độ gỡ lỗi là chế độ này cho phép bạn xử lý lại 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 có thể muố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 các giá trị epsilon khác nhau.
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ờ đó có thể 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ư 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.
Tiếp theo
Phần 2: Thiết lập báo cáo gỡ lỗi