Phần 3/3 về việc gỡ lỗi Attribution Reporting. Tìm hướng dẫn về cách sử dụng báo cáo gỡ lỗi.
Trong cẩm nang 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ữ
- The reporting origin is the origin
that sets the Attribution Reporting source and trigger headers.
All reports generated by the browser are sent to this origin. In this guidance,
we use
https://adtech.exampleas the example reporting origin. - An attribution report (report for short) is the final report (event-level or aggregatable) that contains the measurement data you've requested.
- A debug report contains additional data about an attribution report, or about a source or trigger event. Receiving a debug report does not necessarily mean that something is working incorrectly! There are two types of debug reports
- A transitional debug report is a debug report that requires a cookie to be set in order to be generated and sent. Transitional debug reports will be unavailable if a cookie is not set, and once third-party cookies are deprecated. All debug reports described in this guide are transitional debug reports.
- Success debug reports track successful generation of an attribution report. They relate directly to an attribution report. Success debug reports have been available since Chrome 101 (April 2022).
- Verbose debug reports can track missing reports and help you determine why
they're missing. They indicate cases where the browser did not record a source
or trigger event, (which means it will not generate an attribution report), and
cases where an attribution report can't be generated or sent for some reason.
Verbose debug reports include a
typefield that describes the reason why a source event, trigger event or attribution report was not generated. Verbose debug reports are available starting in Chrome 109 (Stable in January 2023). - Debug keys are unique identifiers you can set on both the source side and the trigger side. Debug keys enable you to map cookie-based conversions and attribution-based conversions. When you've set up your system to generate debug reports and set debug keys, the browser will include these debug keys in all attribution reports and debug reports.
For more concepts and key terms used throughout our documentation, refer to the Privacy Sandbox glossary.
Cách thực hiện: Kiểm tra quá trình 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. 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 của mình hay không. Nếu có, thì chế độ thiết lập Attribution Reporting đ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 chế độ tích hợp được thiết lậ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 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. Xem cách thiết lập các báo cáo này trong Phần 2: Thiết lập báo cáo gỡ lỗi.
Hướng dẫn: Phân tích tổn thất và khắc phục sự cố về việ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 Attribution Reporting, hãy sử dụng khoá gỡ lỗi và liên kết lượt chuyển đổi dựa trên 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 các khoá gỡ lỗi (cặp <source_debug_key, trigger_debug_key>) để liên kết lượt chuyển đổi cookie với các báo cáo gỡ lỗi thành công.
Đối với mỗi lượt chuyển đổi từ 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ể nhận được một báo cáo phân bổ sau đó (ngoại trừ một số trường hợp). 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 đăng ký với Attribution Reporting. 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 từ 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 do vấn đề về việc tích hợp. Xem xét 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 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
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ì chưa. Để 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 loại khác. Báo cáo đó sẽ cho biết một vấn đề ở phía điều kiện kích hoạt.Nếu
typelà 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ỉ 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ả) hoặc bạn có thể muốn báo cáo lỗi hoặc khắc phục sự cố về việc triển khai. Xem kịch bản 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 dựa trên cookie nhất định, bạn nhận được một 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 Attribution Reporting.
Sau đó, bạn có thể nhận được một báo cáo phân bổ cho lượt chuyển đổi 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 hoặc lâu hơ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 đượ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 dựa trên cookie nhất định, bạn nhận được một 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 đó.
Có một điều cần lưu ý về việc này:
Báo cáo gỡ lỗi chi tiết của bất kỳ loại nào khác
Nếu đối với một lượt chuyển đổi dựa trên 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 này sẽ không nhận đượ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. Đã xảy ra lỗi ngăn chặ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ó:
- Hạn mức về quyền riêng tư
- Giới hạn dung lượng
- Quy tắc tuỳ chỉnh
- Vấn đề về việc triển khai trong mã
- Lỗi trình duyệt
Một số lỗi trong số này là điều có thể dự đoán được! Bạn nên thực hiện hành động nào tuỳ 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ì tức là có điều gì đó đã ngăn báo cáo gỡ lỗi được tạo. 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ẻ Nhật ký rồi kiểm tra xem có vấn đề nào xuất hiện ở đó hay không. - Các vấn đề về 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 xảy ra khi báo cáo phân bổ được gửi.
Bạn có nhận được báo cáo phân bổ không?
Đây là một 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ất kỳ loại báo cáo nào (không có báo cáo gỡ lỗi thuộc bất kỳ loại nào, không có báo cáo phân bổ), thì điều này có nghĩa là đã xảy ra một 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á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ư đã 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ó một trường type ghi lại lý do khiến báo cáo phân bổ tương ứng bị loại bỏ. Hãy sử dụng thông tin tham chiếu để tìm ra 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 hạn chế đối với quyền riêng tư
Đây là những báo cáo dự kiến. Chúng cho biết các hạn chế 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- Lỗi này xảy ra 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à ba lượt chuyển đổi cho lượt nhấp. Xin lưu ý rằng bạn có thể định cấu hình những báo cáo sẽ nhận được 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 về các hạn chế đối với bộ nhớ
Đây là những báo cáo dự kiến. Các hạn mức này cho biết giới hạn bộ nhớ để ngăn chặ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 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ỏ dữ liệu trùng lặp, mức độ ưu tiên hoặc lọc dựa trên khoảng thời gian. Để chắc chắn, 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 mà bạn muốn loại bỏ. 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- 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
Các báo cáo này có thể cho biết những 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à một vấn đề về việc triển khai. Kiểm tra để đảm bảo rằng bạn không thiết lập sai
<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ờ 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 muốn mã của mình có. Khắc phục sự cố 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. 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 có. Kiểm tra kỹ mã đăng ký điều kiện kích hoạt để đảm bảo tổng của tất cả các lượt đó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 ngoài dự kiến (lỗi có thể xảy ra trong trình duyệt)
Những báo cáo này không như mong đợi. Nguyên nhâ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à liên kết 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 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 những lượt đăng ký thành công và những 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 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 từ cookie này.
- Báo cáo thành công có nghĩa là hoạt động 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.
- Bạn có thể quyết định giám sát 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 hoặc tuần tiếp theo (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ớ chờ một chút: báo cáo có thể không được gửi ngay khi kết thúc mỗi khung 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á sơ bộ về tổn thất
Thiếu 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 chế độ triển khai dựa trên cookie) không được ghi lại bằng Attribution Reporting. Bạn sẽ không nhận được báo cáo phân bổ cho những mục tiêu 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 bị mất 30% lượt chuyển đổi. Giờ đây, bạn đã có bản đánh giá sơ bộ về tổn thất.
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 trước đó tại thời điểm đăng ký nguồn. Sử dụng các khoá của lượt chuyển đổi dựa trên cookie để liên kết các khoá 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 báo cáo (= 10% trong ví dụ của chúng tôi) 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 báo cáo (= 10% trong ví dụ của chúng tôi) 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.
Bạn nên thực hiện hành động nào tuỳ 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 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 một điểm dữ liệu để bạn có thể theo dõi và nắm bắt thông tin.trigger-aggregate-no-contributionscó thể là dấu hiệu cho thấy bạn đang gặp vấn đề về việc triển khai. 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 báo cáo chi tiết để khắc phục vấn đề 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 gặp phải lỗi này nhiều lần, hãy báo cáo lỗi cho nhà phát triển trình duyệt.