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 cuốn sổ tay 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 trình bày trong Phần 1: Giới thiệu về báo cáo gỡ lỗi.
Bảng chú giải thuật ngữ
- Nguồn gốc báo cáo là nguồn gốc [đặt tiêu đề nguồn cho Báo cáo phân bổ và trình kích hoạt.
Tất cả báo cáo do trình duyệt tạo đều được gửi đến nguồn gốc này. Trong hướng dẫn này, chúng tôi dùng
https://adtech.examplelàm ví dụ về nguồn gốc báo cáo. - 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ề sự kiện nguồn hoặc đ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ó sự cố nào đó đ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 đ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 thiết lập 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 quá trình tạo báo cáo phân bổ thành công. Chúng có liên quan trực tiếp đến báo cáo phân bổ. Kể từ Chrome 101 (tháng 4 năm 2022), chúng tôi đã cung cấp báo cáo gỡ lỗi thành công.
- Báo cáo gỡ lỗi chi tiết có thể theo dõi báo cáo bị thiếu và giúp bạn xác định lý do
báo cáo bị thiếu. Chúng cho biết các trường hợp mà 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 trường
typemô tả lý do không tạo được sự kiện nguồn, sự kiệ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 đã có trên Chrome 109 (Chính thức 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 xuyên suốt tài liệu của chúng tôi, hãy tham khảo Bảng thuật ngữ về Hộp cát về quyền riêng tư.
Hướng dẫn: Kiểm tra quá trình tích hợp theo thời gian thực
- Thiết lập hệ thống của bạn để tạo báo cáo gỡ lỗi thành công. Xem cách thực hiện trong 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 hay không. Nếu có, thì tức là bạn đang thiết lập Báo cáo phân bổ.
- Báo cáo gỡ lỗi thành công chỉ được gửi khi một lượt chuyển đổi diễn ra. Thay vào đó, bạn nên kiểm tra xem chế độ tích hợp của mình đã được thiết lập đúng cách hay chưa bất kể lượt chuyển đổi nào — tức là bạn muốn kiểm tra xem các nguồn đã được đăng ký thành công hay chưa. Để làm được điều này, bạn có thể dựa vào các 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 chúng trong Phần 2: Thiết lập báo cáo Gỡ lỗi.
Hướng dẫn: Phân tích tình trạng mất dữ liệu 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 Báo cáo phân bổ, hãy sử dụng khoá gỡ lỗi và ánh xạ các lượt chuyển đổi cookie với báo cáo gỡ lỗi. Hãy nhớ rằng báo cáo gỡ lỗi đượ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 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?
Nếu 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, ngoại trừ một vài trường hợp ngoại lệ. Xem Tình huống báo cáo gỡ lỗi thành công để biết thông tin chi tiết.
Nếu không: điều này có nghĩa là lượt chuyển đổi đó không được đă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 các 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 sự cố tích hợp. Xem tình huống 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 một báo cáo gỡ lỗi chi tiết, hãy xem trường
typecủa báo cáo đó.Nếu
typecủa phần tử này làsource-success: tức là nguồn đã được đăng ký thành công nhưng điều kiện kích hoạt chưa được đăng ký. Để thu hẹp lý do thiếu báo cáo gỡ lỗi thành công, 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 đó cho biết có vấn đề ở phía điều kiện kích hoạt.Nếu
typelà bất kỳ giá trị nào khác: thì 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, có thể bạn chỉ muốn lấy thông tin này làm điểm dữ liệu phân tích tổn thất (nói cách khác, bạn không cần làm gì cả). Bạn cũng có thể muốn báo lỗi hoặc khắc phục sự cố triển khai. Xem tình huống 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 với Báo cáo phân bổ.
Sau đó, bạn có thể sẽ nhận được báo cáo phân bổ cho lượt chuyển đổi này⏤trừ một số trường hợp ngoại lệ:
- Hành vi của người dùng: xoá dữ liệu sau khi chuyển đổi và trước khi gửi báo cáo phân bổ, đó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 vòng 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: Báo cáo cấp sự kiện được thay thế bằng một báo cáo khác có mức độ ưu tiên cao hơn.
- Các vấn đề có thể xảy ra 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à bạn đã đă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 đó.
Có một lưu ý về điều này:
Báo cáo gỡ lỗi chi tiết thuộc mọi loại khác
Nếu đối với một lượt chuyển đổi cookie nhất định, nếu 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à sau đó không có báo cáo phân bổ⏤vì báo cáo chi tiết có nghĩa là đã xảy ra lỗi có thể báo cáo. Đã xảy ra lỗi ngăn cả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 bộ nhớ
- Quy tắc tuỳ chỉnh
- Vấn đề triển khai trong mã của bạn
- Lỗi trình duyệt
Một vài trong số đó được mong đợi! Hành động cần thực hiện 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 cũng như báo cáo gỡ lỗi chi tiết), thì điều này có nghĩa 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ý) rồi kiểm tra xem có vấn đề nào xuất hiện ở đó hay không. - Vấn đề về mạng xảy ra tại thời điểm nguồn hoặc thời điểm kích hoạt, nhưng không xảy ra 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 con 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ất kỳ loại 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ổ), điều này có nghĩa là đã xảy ra lỗi không thể báo cáo. Nguyên nhân có thể có:
- Vấn đề về tích hợp cơ bản. Hãy xem cách khắc phục những vấn đề này trong bài viết Khắc phục các vấn đề cơ bản về tích hợp.
- Các vấn đề có thể xảy ra về mạng.
- Lựa chọn ưu tiên của người dùng trong các chế độ cài đặt của trình duyệt, chẳng hạn như Hộp cát về quyền riêng tư, đang 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 có một trường type nêu lý do khiến báo cáo phân bổ tương ứng bị loại bỏ. Sử dụng nội dung tham chiếu để tìm hiểu hành động cần thực hiện đối với 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 giới hạn về quyền riêng tư
Đây là những báo cáo nằm trong dự kiến. Những chính sách này chỉ rõ 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- Chi tiết và nội dung báo cáo
source-noised- Chi tiết và nội dung báo cáo
trigger-attributions-per-source-destination-limit- Chi tiết và nội dung báo cáo
trigger-reporting-origin-limit- Chi tiết và nội dung báo cáo
trigger-event-noise- Chi tiết và nội dung báo cáo
trigger-event-excessive-reports- Thông báo này đượ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 một 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ể thiết lập những báo cáo muốn nhận bằng cách đặt mức độ ưu tiên. Chi tiết và nội dung báo cáo
Báo cáo giới hạn bộ nhớ
Đây là những báo cáo nằm trong dự kiến. Thông báo cho biết giới hạn bộ nhớ để ngăn việc sử dụng tài nguyên quá mức.
source-storage-limit- Chi tiết và nội dung báo cáo
trigger-event-storage-limit- Chi tiết và nội dung báo cáo
trigger-aggregate-storage-limit- Chi tiết và nội dung báo cáo
Báo cáo quy tắc tuỳ chỉnh
Bạn có thể xem 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 cửa sổ. Trong trường hợp này, 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à một báo cáo bạn muốn loại bỏ. Nếu đúng như vậy thì bạn không cần làm gì cả.
trigger-no-matching-filter-data- Chi tiết và nội dung báo cáo
trigger-event-no-matching-configuration- Chi tiết và nội dung báo cáo
trigger-event-deduplicated- Chi tiết và nội dung báo cáo
trigger-aggregate-deduplicated- Chi tiết và nội dung báo cáo
trigger-event-low-priority- Chi tiết và nội dung báo cáo
trigger-event-report-window-passed- Chi tiết và nội dung báo cáo
trigger-aggregate-report-window-passed- Chi tiết và nội dung báo cáo
Các báo cáo chi tiết khác
Những báo cáo này có thể cho thấy các vấn đề triển khai tiềm ẩn 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ó cấu hình sai trong chế độ thiết lập
<reporting origin, destination>của bạn. Đâ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 nhìn thấy quảng cáo được liên kết. 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 mong muốn trong mã. 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 nội dung đóng góp của bạn là chính xác. 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 mong muốn trong mã. 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. Chi tiết và nội dung báo cáo
Lỗi không mong muốn (lỗi trình duyệt có thể xảy ra)
Những báo cáo này nằm ngoài dự kiến. Có thể là do lỗi trình duyệt! Báo cáo lỗi và nêu rõ các bước tái hiện lỗi trong phần mô tả.
source-unknown-error- Chi tiết và nội dung báo cáo
trigger-unknown-error- 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à ánh xạ bằng cookie
Làm theo hướng dẫn trong Phần 2: Thiết lập báo cáo gỡ lỗi để thiết lập hệ thống nhằm 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 về lượt chuyển đổi dựa trên cookie để tra cứu các 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 lượt đăng ký thành công và báo cáo còn 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 lần 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 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 một báo cáo gỡ lỗi thành công cho 70 lượt chuyển đổi liên quan đến cookie này.
- Báo cáo thành công có nghĩa là lượt phân bổ đã được ghi lại thành công, do đó, bạn có thể yên tâm giả định rằng bạn sẽ nhận được báo cáo phân bổ tương ứng với từng báo cáo thành công, trừ một số trường hợp ngoại lệ.
- Bạn có thể quyết định theo dõi những trường hợp ngoại lệ này. Để làm như vậy, khi 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 tiếp theo (tuỳ thuộc vào thời hạn), hãy tìm các báo cáo phân bổ có cùng cặp khoá gỡ lỗi giống như mỗi báo cáo gỡ lỗi thành công. Hãy nhớ chờ một chút vì có thể báo cáo sẽ không được gửi ngay lập tức vào cuối mỗi cửa sổ. Giả sử bạn chỉ 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á ngắn gọn về tình trạng mất má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 khi 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 nội dung 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 sẽ mất 30% số lượt chuyển đổi. Bây giờ, bạn có một bài đánh giá ngắn gọn về tình trạng ngừng sử dụng.
Bước 4: Phân tích nguyên nhân
Để tìm hiểu lý do các báo cáo này bị thiếu, hãy tìm các 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 sớm hơn tại thời điểm đăng ký nguồn. Hãy sử dụng khoá của 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 các 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 đề nào về 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 số liệu 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 tôi) báo cáo bị thiếu do
pending destination limit - Thiếu 5 (= 5%) báo cáo do
trigger-aggregate-no-contributions. - Thiếu 5 (= 5%) báo cáo do
unknown-error.
- 10 (= 10% trong ví dụ của chúng tôi) báo cáo bị thiếu do
Bước 5: Thực hiện hành động và khắc phục sự cố
Giờ đây, bạn đã hiểu được lý do khiến báo cáo bị thiếu, bạn có thể dựa vào những thông tin chi tiết này để xử lý.
Hành động cần thực hiện 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 để biết thông tin chi tiết. Ví dụ:
pending-destination-limitlà một biện pháp bảo vệ quyền riêng tư. Bạn không cần làm gì cả. Hãy sử dụng số này làm điểm dữ liệu để bạn theo dõi và giám sát.trigger-aggregate-no-contributionscó thể là dấu hiệu của vấn đề triển khai ở phía bạn. Hãy phân tích thêm về vấn đề này. Hãy sử dụng thông tin trong phần nội dung của báo cáo chi tiết để khắc phục vấn đề 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 lỗi này, hãy báo cáo lỗi cho nhà phát triển trình duyệt.