Phần 3/3 về cách gỡ lỗi Báo cáo phân bổ. Tìm hướng dẫn về cách sử dụng báo cáo gỡ lỗi.
Trong sách hướng dẫn này, bạn sẽ tìm thấy hướng dẫn về cách sử dụng báo cáo gỡ lỗi cho nhiều trường hợp sử dụng được nêu trong Phần 1: Giới thiệu về báo cáo gỡ lỗi.
Bảng thuật ngữ
- Nguồn gốc báo cáo là nguồn gốc đặt nguồn và tiêu đề điều kiện kích hoạt trong Báo cáo phân bổ.
Tất cả báo cáo do trình duyệt tạo sẽ được gửi đến nguồn này. Trong hướng dẫn này, chúng tôi sử dụng
https://adtech.examplelàm nguồn gốc báo cáo mẫu. - Báo cáo phân bổ (gọi tắt là báo cáo) là báo cáo cuối cùng (cấp sự kiện hoặc tổng hợp) chứa dữ liệu đo lường mà bạn đã yêu cầu.
- Báo cáo gỡ lỗi chứa dữ liệu bổ sung về báo cáo phân bổ hoặc về nguồn hay sự kiện điều kiện kích hoạt. Việc nhận được báo cáo gỡ lỗi không nhất thiết có nghĩa là có gì đó đang hoạt động không chính xác! Có hai loại báo cáo gỡ lỗi
- Báo cáo gỡ lỗi chuyển đổi là một báo cáo gỡ lỗi yêu cầu bạn phải đặt cookie để có thể tạo và gửi. Các báo cáo gỡ lỗi chuyển đổi sẽ không có sẵn nếu bạn không đặt cookie và sau khi cookie của bên thứ ba không được dùng nữa. Tất cả báo cáo gỡ lỗi được mô tả trong hướng dẫn này đều là báo cáo gỡ lỗi chuyển đổi.
- Báo cáo gỡ lỗi thành công theo dõi việc tạo báo cáo phân bổ thành công. Chúng liên quan trực tiếp đến 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 có thể theo dõi các báo cáo bị thiếu và giúp bạn xác định lý do các báo cáo đó bị thiếu. Những báo cáo này cho biết các trường hợp trình duyệt không ghi lại sự kiện nguồn hoặc sự kiện kích hoạt, (nghĩa là trình duyệt sẽ không tạo báo cáo phân bổ) và 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
typemô tả lý do không tạo được một sự kiện nguồn, sự kiện liên quan đến điều kiện kích hoạt hoặc báo cáo phân bổ. Báo cáo gỡ lỗi chi tiết sẽ có từ phiên bản Chrome 109 (Ổn định vào tháng 1 năm 2023). - Khoá gỡ lỗi là các giá trị nhận dạng duy nhất mà bạn có thể đặt ở cả phía nguồn và phía điều kiện kích hoạt. Khoá gỡ lỗi cho phép bạn liên kết các lượt chuyển đổi dựa trên cookie và các lượt chuyển đổi dựa trên mô hình phân bổ. Khi bạn đã thiết lập hệ thống để tạo báo cáo gỡ lỗi và đặt khoá gỡ lỗi, trình duyệt sẽ đưa các khoá gỡ lỗi này vào tất cả báo cáo phân bổ và báo cáo gỡ lỗi.
Để biết thêm các khái niệm và thuật ngữ chính được dùng trong tài liệu của chúng tôi, hãy tham khảo bảng chú giải thuật ngữ Hộp cát về quyền riêng tư.
Cách thực hiện: Kiểm tra chế độ tích hợp theo thời gian thực
- Thiết lập hệ thống để tạo báo cáo gỡ lỗi thành công. Hãy xem cách thực hiện trong phần Phần 2: Thiết lập báo cáo gỡ lỗi.
- Bất cứ khi nào bạn triển khai mã Báo cáo phân bổ, hãy kiểm tra theo thời gian thực xem bạn có nhận được một số báo cáo gỡ lỗi thành công trên điểm cuối của mình hay không. Nếu có, thì chế độ thiết lập Báo cáo phân bổ của bạn đang hoạt động.
- Báo cáo gỡ lỗi thành công chỉ được gửi khi có lượt chuyển đổi. Thay vào đó, bạn nên kiểm tra để đảm bảo rằng bạn đã thiết lập chế độ tích hợp đúng cách, bất kể lượt chuyển đổi. Tức là bạn muốn kiểm tra để đảm bảo rằng các nguồn đã được đăng ký thành công. Để đạt được điều này, bạn có thể dựa vào báo cáo gỡ lỗi chi tiết đăng ký nguồn thành công. Hãy xem cách thiết lập các báo cáo này trong phần Phần 2: Thiết lập báo cáo gỡ lỗi.
Cách thực hiện: Phân tích tổn thất và khắc phục sự cố tích hợp
Để so sánh kết quả đo lường lượt chuyển đổi dựa trên cookie với các báo cáo trong Báo cáo phân bổ, hãy sử dụng khoá gỡ lỗi và liên kết lượt chuyển đổi từ cookie với báo cáo gỡ lỗi. Hãy nhớ rằng báo cáo gỡ lỗi sẽ được gửi ngay lập tức đến điểm cuối của bạn.
Tổng quan
Sử dụng khoá gỡ lỗi (cặp <source_debug_key, trigger_debug_key>) để liên kết lượt chuyển đổi cookie với báo cáo gỡ lỗi thành công.
Đối với mỗi lượt chuyển đổi bằng cookie, tại thời điểm chuyển đổi, bạn có nhận được báo cáo gỡ lỗi thành công tương ứng không?
Có: đối với tất cả các báo cáo gỡ lỗi thành công này, bạn có thể sẽ nhận được báo cáo phân bổ sau này, ngoại trừ một số trường hợp ngoại lệ. Xem Kịch bản báo cáo gỡ lỗi thành công để biết thông tin chi tiết.
Nếu không: tức là lượt chuyển đổi đó không đăng ký với Báo cáo phân bổ. Sử dụng cặp <source_debug_key, trigger_debug_key> (hoặc khoá gỡ lỗi nguồn nếu không có khoá gỡ lỗi điều kiện kích hoạt) để liên kết lượt chuyển đổi cookie với báo cáo gỡ lỗi chi tiết. Đối với mỗi lượt chuyển đổi này, tại một thời điểm nào đó (thời gian nguồn hoặc thời gian kích hoạt), bạn có nhận được báo cáo gỡ lỗi chi tiết tương ứng không?
Nếu bạn không nhận được báo cáo gỡ lỗi chi tiết: điều này có thể là do hành vi của người dùng hoặc do vấn đề tích hợp. Xem trường hợp không có báo cáo gỡ lỗi để biết thông tin chi tiết.
Nếu bạn đã nhận được báo cáo gỡ lỗi chi tiết, hãy xem trường
typecủa báo cáo đó.Nếu
typelàsource-success: tức là nguồn đã được đăng ký thành công nhưng điều kiện kích hoạt thì không. Để thu hẹp lý do khiến báo cáo gỡ lỗi thành công bị thiếu, hãy tìm một báo cáo gỡ lỗi chi tiết tương ứng thuộc bất kỳ loại nào khác⏤báo cáo đó sẽ cho biết vấn đề ở phía trình kích hoạt.Nếu
typecủa nó là bất kỳ giá trị nào khác: nguồn hoặc điều kiện kích hoạt chưa được đăng ký.typesẽ cho bạn biết lý do. Báo cáo phân bổ tương ứng (và báo cáo gỡ lỗi thành công) sẽ bị thiếu. Tuỳ thuộc vàotypecủa báo cáo gỡ lỗi chi tiết, bạn có thể chỉ cần lấy thông tin này làm điểm dữ liệu phân tích tổn thất (tức là không cần làm gì cả) hoặc bạn có thể gửi lỗi hoặc khắc phục sự cố triển khai. Xem trường hợp báo cáo gỡ lỗi chi tiết để biết thông tin chi tiết.
Các trường hợp có thể xảy ra
Báo cáo gỡ lỗi thành công
Nếu đối với một lượt chuyển đổi cookie nhất định, bạn nhận được báo cáo gỡ lỗi thành công, thì tức là lượt chuyển đổi này đã được đăng ký thành công bằng Báo cáo phân bổ.
Bạn có thể nhận được báo cáo phân bổ cho lượt chuyển đổi này sau này⏤, ngoại trừ một số trường hợp:
- Hành vi của người dùng: xoá dữ liệu sau khi chuyển đổi và trước khi báo cáo phân bổ được gửi, đóng trình duyệt, v.v. Nếu người dùng đóng trình duyệt sau khi chuyển đổi và không mở trình duyệt trong một tuần, thì báo cáo sẽ không được gửi trong một tuần trở lên. Bạn có thể coi sự chậm trễ này là một tổn thất.
- Chỉ áp dụng cho cấp sự kiện: Một báo cáo cấp sự kiện sẽ được thay thế bằng một báo cáo khác có mức độ ưu tiên cao hơn.
- Có thể xảy ra vấn đề về mạng.
Báo cáo gỡ lỗi chi tiết thuộc loại source-success
Nếu đối với nguồn của một lượt chuyển đổi cookie nhất định, bạn nhận được báo cáo gỡ lỗi chi tiết thuộc loại source-success, thì tức là quá trình đăng ký nguồn đã thành công. Tuỳ thuộc vào việc đăng ký điều kiện kích hoạt có thành công sau đó hay không, bạn có thể nhận được hoặc không nhận được báo cáo cho lượt chuyển đổi đó.
Tuy nhiên, bạn cần lưu ý một điều:
Báo cáo gỡ lỗi chi tiết về bất kỳ loại nào khác
Nếu đối với một lượt chuyển đổi cookie nhất định, bạn nhận được báo cáo gỡ lỗi chi tiết thuộc bất kỳ loại nào khác, thì bạn sẽ không nhận được báo cáo gỡ lỗi thành công và do đó, sau đó sẽ không có báo cáo phân bổ nào⏤vì báo cáo chi tiết có nghĩa là đã xảy ra lỗi có thể báo cáo. Có điều gì đó đã ngăn việc đăng ký nguồn, đăng ký điều kiện kích hoạt, tạo báo cáo hoặc gửi báo cáo. Nguyên nhân có thể có:
- Giới hạn về quyền riêng tư
- Giới hạn dung lượng
- Quy tắc tuỳ chỉnh
- Vấn đề triển khai trong mã
- Lỗi trình duyệt
Một số lỗi này là dự kiến! Thao tác cần thực hiện sẽ phụ thuộc vào type của từng báo cáo chi tiết. Xem tài liệu tham khảo về báo cáo chi tiết.
Không có báo cáo gỡ lỗi
Nếu đối với một lượt chuyển đổi cookie nhất định, bạn chỉ nhận được báo cáo phân bổ (không có báo cáo gỡ lỗi thành công hoặc báo cáo gỡ lỗi chi tiết), thì tức là có điều gì đó đã ngăn việc tạo báo cáo gỡ lỗi. Nguyên nhân có thể có:
- Lựa chọn ưu tiên của người dùng (người dùng đã tắt cookie của bên thứ ba)
- Thiếu cookie hoặc thiếu khoá gỡ lỗi (khoá gỡ lỗi bị xoá do thiếu cookie). Trong
chrome://attribution-internals, hãy mở thẻ Logs (Nhật ký) và kiểm tra xem có vấn đề nào xuất hiện hay không. - Sự cố mạng xảy ra tại thời điểm nguồn hoặc điều kiện kích hoạt, nhưng không phải tại thời điểm gửi báo cáo phân bổ.
Bạn có nhận được báo cáo phân bổ không?
Đây là trường hợp phụ của việc không nhận được báo cáo gỡ lỗi: nếu đối với một lượt chuyển đổi cookie nhất định, bạn không nhận được báo cáo nào (không có báo cáo gỡ lỗi, không có báo cáo phân bổ), thì điều này có nghĩa là đã xảy ra lỗi không báo cáo được. Nguyên nhân có thể có:
- Vấn đề cơ bản về việc tích hợp. Hãy xem cách khắc phục các vấn đề này trong phần Khắc phục các vấn đề cơ bản về việc tích hợp.
- Có thể xảy ra vấn đề về mạng.
- Lựa chọn ưu tiên của người dùng trong phần cài đặt trình duyệt, chẳng hạn như Hộp cát về quyền riêng tư bị tắt.
Tài liệu tham khảo về báo cáo gỡ lỗi chi tiết
Mỗi báo cáo gỡ lỗi chi tiết đều có trường type ghi lại lý do khiến báo cáo phân bổ tương ứng bị loại bỏ. Sử dụng tài liệu tham khảo để tìm hiểu hành động cần thực hiện cho mỗi type của báo cáo chi tiết.
Đã đăng ký nguồn thành công
Đã đăng ký thành công một nguồn.
source-success- Thông tin chi tiết và nội dung báo cáo
Báo cáo về các giới hạn về quyền riêng tư
Đây là những báo cáo dự kiến. Các cookie này cho biết các giới hạn về quyền riêng tư để giảm tình trạng rò rỉ danh tính người dùng trên nhiều trang web.
source-destination-limit- Thông tin chi tiết và nội dung báo cáo
source-noised- Thông tin chi tiết và nội dung báo cáo
trigger-attributions-per-source-destination-limit- Thông tin chi tiết và nội dung báo cáo
trigger-reporting-origin-limit- Thông tin chi tiết và nội dung báo cáo
trigger-event-noise- Thông tin chi tiết và nội dung báo cáo
trigger-event-excessive-reports- Đây là lỗi được tạo nếu số lượng báo cáo vượt quá giới hạn; bạn có thể đăng ký tối đa 1 lượt chuyển đổi cho lượt xem và 3 lượt chuyển đổi cho lượt nhấp. Xin lưu ý rằng bạn có thể định cấu hình báo cáo cần nhận bằng cách đặt mức độ ưu tiên. Thông tin chi tiết và nội dung báo cáo
Báo cáo về hạn mức bộ nhớ
Đây là những báo cáo dự kiến. Các thông báo này cho biết các giới hạn về bộ nhớ để ngăn việc sử dụng tài nguyên quá mức.
source-storage-limit- Thông tin chi tiết và nội dung báo cáo
trigger-event-storage-limit- Thông tin chi tiết và nội dung báo cáo
trigger-aggregate-storage-limit- Thông tin chi tiết và nội dung báo cáo
Báo cáo quy tắc tuỳ chỉnh
Bạn sẽ thấy những báo cáo này nếu đang sử dụng tính năng lọc, loại bỏ trùng lặp, mức độ ưu tiên hoặc lọc dựa trên khoảng thời gian. Phòng trường hợp xảy ra sự cố, hãy kiểm tra kỹ các quy tắc tuỳ chỉnh tương ứng để xác nhận rằng báo cáo tương ứng với báo cáo chi tiết đó thực sự là báo cáo bạn muốn xoá. Nếu thông tin này chính xác, bạn không cần làm gì cả.
trigger-no-matching-filter-data- Thông tin chi tiết và nội dung báo cáo
trigger-event-no-matching-configuration- Thông tin chi tiết và nội dung báo cáo
trigger-event-deduplicated- Thông tin chi tiết và nội dung báo cáo
trigger-aggregate-deduplicated- Thông tin chi tiết và nội dung báo cáo
trigger-event-low-priority- Thông tin chi tiết và nội dung báo cáo
trigger-event-report-window-passed- Thông tin chi tiết và nội dung báo cáo
trigger-aggregate-report-window-passed- Thông tin chi tiết và nội dung báo cáo
Các báo cáo chi tiết khác
Các báo cáo này có thể cho biết các vấn đề tiềm ẩn về việc triển khai trong mã của bạn.
trigger-no-matching-source- Đây có thể là vấn đề về việc triển khai. Kiểm tra để đảm bảo không có lỗi cấu hình trong quá trình thiết lập
<reporting origin, destination>. Đây cũng có thể là hành vi dự kiến của API. Ví dụ: người dùng đã xoá dữ liệu tại một thời điểm nào đó sau khi tương tác với quảng cáo và trước khi chuyển đổi, hoặc người dùng đã chuyển đổi mà không bao giờ xem quảng cáo được liên kết. Thông tin chi tiết và nội dung báo cáo trigger-aggregate-no-contributions- Đây có thể không phải là hành vi mà bạn muốn mã của mình thực hiện. Khắc phục sự cố về mã đăng ký điều kiện kích hoạt; đảm bảo rằng cấu hình đóng góp của bạn là chính xác. Thông tin chi tiết và nội dung báo cáo
trigger-aggregate-insufficient-budget- Đây có thể không phải là hành vi mà bạn muốn mã của mình thực hiện. Kiểm tra kỹ mã đăng ký điều kiện kích hoạt để đảm bảo tổng số tiền đóng góp không vượt quá ngân sách đóng góp. Thông tin chi tiết và nội dung báo cáo
Lỗi ngoài dự kiến (lỗi tiềm ẩn của trình duyệt)
Những báo cáo này là ngoài dự kiến. Lỗi này có thể là do lỗi trình duyệt! Gửi lỗi và chỉ định các bước để tái hiện lỗi trong nội dung mô tả.
source-unknown-error- Thông tin chi tiết và nội dung báo cáo
trigger-unknown-error- Thông tin chi tiết và nội dung báo cáo
Ví dụ về phân tích tổn thất
Bước 1: Thiết lập và liên kết bằng cookie
Làm theo hướng dẫn trong phần Phần 2: Thiết lập báo cáo gỡ lỗi để thiết lập hệ thống tạo báo cáo gỡ lỗi thành công và báo cáo gỡ lỗi chi tiết.
Nhờ đó, bạn có thể sử dụng thông tin lượt chuyển đổi dựa trên cookie để tra cứu báo cáo gỡ lỗi hoặc báo cáo phân bổ tương ứng.
Bước 2: Xác định các lượt đăng ký thành công và báo cáo bị thiếu
Trong ví dụ này, giả sử bạn đã theo dõi 100 lượt chuyển đổi bằng hệ thống dựa trên cookie.
Mỗi khi bạn ghi lại một lượt chuyển đổi dựa trên cookie, hãy tìm báo cáo gỡ lỗi thành công (được gửi ngay lập tức) có cùng một cặp <source_debug_key, trigger_debug_key> với lượt chuyển đổi dựa trên cookie này.
Giả sử bạn đã nhận được báo cáo gỡ lỗi thành công cho 70 trong số các lượt chuyển đổi bằng cookie này.
- Báo cáo thành công có nghĩa là mô hình phân bổ đã được ghi lại thành công. Vì vậy, bạn có thể yên tâm rằng bạn sẽ nhận được một báo cáo phân bổ tương ứng với mỗi báo cáo thành công, ngoại trừ một số trường hợp ngoại lệ.
- Bạn có thể quyết định theo dõi các trường hợp ngoại lệ này. Để làm như vậy, khi các báo cáo phân bổ được gửi đến điểm cuối của bạn trong những ngày/tuần tới (tuỳ thuộc vào thời gian hết hạn), hãy tìm những báo cáo phân bổ có cùng cặp khoá gỡ lỗi với từng báo cáo gỡ lỗi thành công. Hãy nhớ đợi một chút: báo cáo có thể không được gửi ngay lập tức vào cuối mỗi khoảng thời gian. Giả sử bạn chỉ tìm thấy 60 báo cáo phân bổ. 10 báo cáo phân bổ bị thiếu có thể là do hành vi của người dùng.
Bước 3: Đánh giá nhanh về tổn thất
Thiếu 100-70 = 30 báo cáo gỡ lỗi thành công. Điều này có nghĩa là 30 lượt chuyển đổi này (được theo dõi trong quá trình triển khai dựa trên cookie) không được ghi lại bằng Báo cáo phân bổ. Bạn sẽ không nhận được báo cáo phân bổ cho những chiến dịch này.
Vì bạn có 100 lượt chuyển đổi dựa trên cookie và chỉ có 70 lượt chuyển đổi dựa trên mô hình phân bổ, nên bạn mất 30%. Giờ đây, bạn đã có một bản đánh giá ngắn gọn về tổn thất.
Bước 4: Phân tích nguyên nhân
Để điều tra lý do các báo cáo này bị thiếu, hãy tìm báo cáo gỡ lỗi chi tiết tương ứng mà bạn đã nhận được tại thời điểm chuyển đổi (đăng ký điều kiện kích hoạt) hoặc trước đó tại thời điểm đăng ký nguồn. Sử dụng khoá của các lượt chuyển đổi dựa trên cookie để liên kết các lượt chuyển đổi này với báo cáo gỡ lỗi chi tiết.
- Giả sử có 10 khoá không có báo cáo gỡ lỗi chi tiết. Kiểm tra xem có vấn đề gì về việc tích hợp hay không. Nếu không, điều này có thể là do hành vi của người dùng.
- Bạn có 20 báo cáo gỡ lỗi chi tiết. Giờ đây, bạn có thể tinh chỉnh thông tin phân tích về tổn thất. Phân tích trường
typecủa từng báo cáo chi tiết. Ví dụ: bạn có thể thấy rằng:- 10 (= 10% trong ví dụ của chúng ta) báo cáo bị thiếu do
pending destination limit - 5 (= 5%) báo cáo bị thiếu do
trigger-aggregate-no-contributions. - 5 (= 5%) báo cáo bị thiếu do
unknown-error.
- 10 (= 10% trong ví dụ của chúng ta) báo cáo bị thiếu do
Bước 5: Hành động và khắc phục sự cố
Giờ đây, khi đã biết lý do khiến báo cáo bị thiếu, bạn có thể hành động dựa trên những thông tin chi tiết này.
Thao tác cần thực hiện sẽ phụ thuộc vào type của từng báo cáo chi tiết. Hãy xem tài liệu tham khảo về báo cáo chi tiết để biết thông tin chi tiết. Ví dụ:
pending-destination-limitlà một tính năng bảo vệ quyền riêng tư. Bạn không cần làm gì cả. Hãy sử dụng con số này làm một điểm dữ liệu để bạn có thể theo dõi và giám sát.trigger-aggregate-no-contributionscó thể là dấu hiệu cho thấy bạn gặp vấn đề về việc triển khai. Hãy phân tích thêm về vấn đề này. Hãy sử dụng thông tin chi tiết trong nội dung của báo cáo chi tiết để khắc phục sự cố này nếu cần.unknown-errorcó thể là dấu hiệu của lỗi trình duyệt hoặc lỗi mạng. Nếu bạn liên tục gặp phải vấn đề này, hãy báo cáo lỗi cho nhà phát triển trình duyệt.