Theo dõi chẩn đoán dữ liệu ngoại tuyến
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Sử dụng API Google Ads để truy xuất dữ liệu chẩn đoán ngoại tuyến, chứa thông tin về tình trạng tổng thể của quy trình nhập lượt chuyển đổi và điều chỉnh.
Để truy xuất thông tin chẩn đoán mới nhất về dữ liệu ngoại tuyến cho tài khoản của bạn, hãy sử dụng một trong các tài nguyên sau:
Thông tin chẩn đoán ở cấp tài khoản
Để truy xuất thông tin chẩn đoán về lượt tải chuyển đổi lên ở cấp tài khoản, hãy sử dụng truy vấn GAQL sau:
SELECT
customer.id,
offline_conversion_upload_client_summary.alerts,
offline_conversion_upload_client_summary.client,
offline_conversion_upload_client_summary.daily_summaries,
offline_conversion_upload_client_summary.job_summaries,
offline_conversion_upload_client_summary.last_upload_date_time,
offline_conversion_upload_client_summary.pending_event_count,
offline_conversion_upload_client_summary.pending_rate,
offline_conversion_upload_client_summary.status,
offline_conversion_upload_client_summary.success_rate,
offline_conversion_upload_client_summary.successful_event_count,
offline_conversion_upload_client_summary.total_event_count
FROM offline_conversion_upload_client_summary
Truy vấn này trả về các hàng OfflineConversionUploadClientSummary riêng biệt cho từng loại ứng dụng được dùng trong các lần nhập gần đây. Ví dụ: nếu gần đây bạn đã nhập bằng cả API Google Ads và giao diện người dùng Google Ads, thì kết quả sẽ chứa các mục riêng biệt cho các giá trị client của GOOGLE_ADS_API và GOOGLE_ADS_WEB_CLIENT.
Thông tin chẩn đoán ở cấp hành động chuyển đổi
Để truy xuất thông tin chẩn đoán về lượt chuyển đổi được tải lên ở cấp hành động chuyển đổi, hãy sử dụng truy vấn GAQL sau:
SELECT
offline_conversion_upload_conversion_action_summary.conversion_action_name,
offline_conversion_upload_conversion_action_summary.alerts,
offline_conversion_upload_conversion_action_summary.client,
offline_conversion_upload_conversion_action_summary.daily_summaries,
offline_conversion_upload_conversion_action_summary.job_summaries,
offline_conversion_upload_conversion_action_summary.last_upload_date_time,
offline_conversion_upload_conversion_action_summary.pending_event_count,
offline_conversion_upload_conversion_action_summary.status,
offline_conversion_upload_conversion_action_summary.successful_event_count,
offline_conversion_upload_conversion_action_summary.total_event_count
FROM offline_conversion_upload_conversion_action_summary
WHERE offline_conversion_upload_conversion_action_summary.conversion_action_id = < INSERT CONVERSION ACTION ID >
Tương tự như thông tin chẩn đoán ở cấp tài khoản, truy vấn này trả về các hàng OfflineConversionUploadConversionActionSummary riêng biệt cho từng loại ứng dụng được dùng trong các lần nhập gần đây. Ví dụ: nếu gần đây bạn đã nhập bằng cả API Google Ads và giao diện người dùng Google Ads, thì kết quả sẽ chứa các mục riêng biệt cho các giá trị client của GOOGLE_ADS_API và GOOGLE_ADS_WEB_CLIENT.
Cách diễn giải những bản tóm tắt này
Mỗi OfflineConversionUploadClientSummary hoặc OfflineConversionUploadConversionActionSummary đều có một trường status phản ánh tình trạng tổng thể của các lượt nhập cho client. Tệp này cũng chứa các thông tin sau:
- Số lượng tổng số sự kiện đã nhận được.
- Số lượng sự kiện đã xử lý thành công.
- Số lượng sự kiện đang chờ xử lý (những sự kiện vẫn đang được xử lý).
- Trường
alerts cung cấp thông tin tóm tắt về các lỗi, được nhóm theo OfflineConversionError.
Tất cả các trường này đều chứa thông tin từ ngày dương lịch đầy đủ gần đây nhất của lượt nhập. Hãy sử dụng thông tin này để đánh giá tình trạng hiện tại của các lượt nhập.
Ngoài ra, mỗi OfflineConversionUploadClientSummary hoặc OfflineConversionUploadConversionActionSummary đều chứa 2 loại báo cáo riêng biệt:
daily_summaries- A
successful_count, failed_count và pending_count yêu cầu nhập trong 7 ngày qua, được nhóm theo date nhập.
job_summariessuccessful_count, failed_count và pending_count của 7 yêu cầu nhập gần đây nhất, được nhóm theo job_id. job_id là một trường không bắt buộc của UploadClickConversionsRequest và UploadConversionAdjustmentsRequest. Bạn có thể đặt job_id thành một số không âm nhỏ hơn 2^31 hoặc để API Google Ads chỉ định một mã nhận dạng công việc do hệ thống tạo cho yêu cầu của bạn. Bất kể bạn chọn phương án nào, UploadClickConversionsResponse hoặc UploadConversionAdjustmentsResponse đều trả về job_id.
Một trường hợp mà bạn nên chỉ định job_id của riêng mình là khi bạn có một công việc hoặc quy trình duy nhất nhập một số lượng lớn lượt chuyển đổi bằng nhiều yêu cầu. Nếu đặt job_id trên mỗi yêu cầu đó thành cùng một giá trị, thì bạn có thể truy xuất một mục duy nhất cho công việc từ job_summaries. Nếu thay vào đó, bạn cho phép Google Ads API chỉ định một giá trị do hệ thống tạo cho job_id của mỗi yêu cầu, thì job_summaries sẽ chứa một mục riêng cho mỗi yêu cầu. Điều này có thể khiến việc phân tích tình trạng tổng thể của công việc trở nên khó khăn hơn.
Cách sử dụng bản tóm tắt
Để đảm bảo quy trình nhập đang ghi lại lượt chuyển đổi và các điểm cải tiến như mong đợi, hãy định kỳ truy xuất thông tin tóm tắt cho từng tài khoản của bạn. Nếu status của bất kỳ bản tóm tắt nào không phải là EXCELLENT, hãy sử dụng danh sách lỗi trong alerts để hướng dẫn bạn sửa đổi quy trình nhập nhằm giảm hoặc loại bỏ những lỗi đó.
Ví dụ:
Nếu trạng thái là NEEDS_ATTENTION, thì một phần đáng kể các thao tác nhập của bạn đã thất bại. Xem xét các lỗi trong phần alerts và sửa đổi quy trình nhập để giảm hoặc loại bỏ những lỗi đó.
Nếu trạng thái là NO_RECENT_UPLOADS, thì Google Ads chưa nhận được bất kỳ lượt nhập gần đây nào cho client. Nếu điều này không mong muốn, hãy xem xét các quy trình thực hiện thao tác nhập bằng ứng dụng đó.
Ví dụ: nếu status cho GOOGLE_ADS_API là NO_RECENT_UPLOADS, thì điều đó có thể cho biết quy trình nhập của bạn sử dụng API Google Ads đã ngừng chạy gần đây.
Để xác định xem có ngày nhập hoặc công việc cụ thể nào đã gửi một số lượng lớn sự kiện không xử lý được hay không, hãy kiểm tra successful_count, failed_count và pending_count của daily_summaries và job_summaries.
Mọi sự kiện ở trạng thái đang chờ xử lý có thể mất đến 24 giờ để hoàn tất.
Bạn có thể xem thêm thông tin về cách cải thiện tính năng chẩn đoán dữ liệu ngoại tuyến trong Trung tâm trợ giúp.
Quy định hạn chế
Khi truy xuất thông tin tóm tắt về lượt nhập, hãy lưu ý những điều sau:
Google Ads API chỉ trả về thông tin chẩn đoán dữ liệu ngoại tuyến nếu customer_id của yêu cầu searchStream hoặc search là cùng một khách hàng mà bạn đã sử dụng gần đây để nhập lượt chuyển đổi.
Ví dụ: một tài khoản khách hàng sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản có thể không chứa bất kỳ thông tin chẩn đoán nào. Tuy nhiên, bạn có thể truy xuất thông tin chẩn đoán bằng cách gửi một yêu cầu trong đó customer_id khớp với customer_id của tài khoản người quản lý mà bạn sử dụng trong quá trình nhập.
Google Ads coi các lỗi CLICK_NOT_FOUND khi nhập lượt chuyển đổi nâng cao cho khách hàng tiềm năng là cảnh báo. Do đó, nếu alerts chứa một mục cho lỗi này, thì các thao tác tương ứng vẫn được coi là thành công và được đưa vào successful_event_count.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-09-05 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-09-05 UTC."],[[["\u003cp\u003eThe Google Ads API allows retrieval of offline data diagnostics, offering insights into the health of your conversion uploads and adjustments.\u003c/p\u003e\n"],["\u003cp\u003eYou can access these diagnostics at both the account level and the conversion action level using specific GAQL queries.\u003c/p\u003e\n"],["\u003cp\u003eDiagnostics encompass data like total events, successful events, pending events, and alerts on errors, helping assess the upload process.\u003c/p\u003e\n"],["\u003cp\u003eDaily and job summaries are included, offering a detailed view of upload request performance over the past 7 days.\u003c/p\u003e\n"],["\u003cp\u003eRegularly review these summaries to ensure smooth conversion tracking, addressing any alerts to optimize the upload process for better results.\u003c/p\u003e\n"]]],[],null,["# Monitor offline data diagnostics\n\n| **Note:** For enhanced conversions for leads imports, use the [enhanced conversions for leads diagnostics report](//support.google.com/google-ads/answer/15249267) in the Google Ads UI to monitor your import health.\n\nUse the Google Ads API to retrieve\n[offline data diagnostics](//support.google.com/google-ads/answer/13812240),\nwhich contain information about the overall health of your conversion import and\nadjustment processes.\n\nTo retrieve the latest offline data diagnostics for your account, use\none of the following resources:\n\n- [`offline_conversion_upload_client_summary`](/google-ads/api/fields/v21/offline_conversion_upload_client_summary) aggregates import diagnostics at the account level.\n- [`offline_conversion_upload_conversion_action_summary`](/google-ads/api/fields/v21/offline_conversion_upload_conversion_action_summary) aggregates import diagnostics at the conversion action level.\n\nAccount level diagnostics\n-------------------------\n\nTo retrieve account level conversion upload diagnostics, use the following\nGAQL query: \n\n SELECT\n customer.id,\n offline_conversion_upload_client_summary.alerts,\n offline_conversion_upload_client_summary.client,\n offline_conversion_upload_client_summary.daily_summaries,\n offline_conversion_upload_client_summary.job_summaries,\n offline_conversion_upload_client_summary.last_upload_date_time,\n offline_conversion_upload_client_summary.pending_event_count,\n offline_conversion_upload_client_summary.pending_rate,\n offline_conversion_upload_client_summary.status,\n offline_conversion_upload_client_summary.success_rate,\n offline_conversion_upload_client_summary.successful_event_count,\n offline_conversion_upload_client_summary.total_event_count\n FROM offline_conversion_upload_client_summary\n\nThis query returns separate\n[`OfflineConversionUploadClientSummary`](/google-ads/api/reference/rpc/v21/OfflineConversionUploadClientSummary)\nrows for each type of client used in recent imports. For example, if you\nrecently imported using both the Google Ads API and the Google Ads UI, the results\ncontain separate entries for the `client` values of `GOOGLE_ADS_API` and\n`GOOGLE_ADS_WEB_CLIENT`.\n\nConversion action level diagnostics\n-----------------------------------\n\nTo retrieve conversion upload diagnostics at the conversion action level, use\nthe following GAQL query: \n\n SELECT\n offline_conversion_upload_conversion_action_summary.conversion_action_name,\n offline_conversion_upload_conversion_action_summary.alerts,\n offline_conversion_upload_conversion_action_summary.client,\n offline_conversion_upload_conversion_action_summary.daily_summaries,\n offline_conversion_upload_conversion_action_summary.job_summaries,\n offline_conversion_upload_conversion_action_summary.last_upload_date_time,\n offline_conversion_upload_conversion_action_summary.pending_event_count,\n offline_conversion_upload_conversion_action_summary.status,\n offline_conversion_upload_conversion_action_summary.successful_event_count,\n offline_conversion_upload_conversion_action_summary.total_event_count\n FROM offline_conversion_upload_conversion_action_summary\n WHERE offline_conversion_upload_conversion_action_summary.conversion_action_id = \u003c INSERT CONVERSION ACTION ID \u003e\n\nSimilar to account level diagnostics, this query returns separate\n[`OfflineConversionUploadConversionActionSummary`](/google-ads/api/reference/rpc/v21/OfflineConversionUploadConversionActionSummary)\nrows for each type of client used in recent imports. For example, if you\nrecently imported using both the Google Ads API and the Google Ads UI, the results\ncontain separate entries for the `client` values of `GOOGLE_ADS_API` and\n`GOOGLE_ADS_WEB_CLIENT`.\n\nHow to interpret these summaries\n--------------------------------\n\nEach `OfflineConversionUploadClientSummary` or\n`OfflineConversionUploadConversionActionSummary` has a `status` field, that\nreflects the [overall health](//support.google.com/google-ads/answer/13812240#2)\nof imports for the `client`. It also contains the following information:\n\n- The count of total events received.\n- The count of successfully processed events.\n- The count of pending events (events that are still being processed).\n- An `alerts` field, that provides a summary of errors, grouped by [`OfflineConversionError`](/google-ads/api/reference/rpc/v21/OfflineConversionError).\n\nAll of these fields contain information from the most recent full calendar day\nof imports. Use this information to assess the *current* health of your imports.\n\nIn addition, each `OfflineConversionUploadClientSummary` or\n`OfflineConversionUploadConversionActionSummary` contains two different\ntypes of reports:\n\n`daily_summaries`\n: A `successful_count`, `failed_count`, and `pending_count` of import requests\n from the last 7 days, grouped by import `date`.\n\n`job_summaries`\n\n: The `successful_count`, `failed_count`, and `pending_count` of the 7 most\n recent import requests, grouped by `job_id`. The `job_id` is an optional field\n of [`UploadClickConversionsRequest`](/google-ads/api/reference/rpc/v21/UploadClickConversionsRequest) and\n [`UploadConversionAdjustmentsRequest`](/google-ads/api/reference/rpc/v21/UploadConversionAdjustmentsRequest). You can either set the\n `job_id` to a non-negative number less than `2^31` or let the Google Ads API assign a\n system-generated job ID to your request. Regardless of which option you\n choose, the [`UploadClickConversionsResponse`](/google-ads/api/reference/rpc/v21/UploadClickConversionsResponse) or\n [`UploadConversionAdjustmentsResponse`](/google-ads/api/reference/rpc/v21/UploadConversionAdjustmentsResponse) returns the `job_id`.\n\n One scenario where assigning your own `job_id` is useful is when you have a\n single job or process that imports a large number of conversions using\n multiple requests. If you set the `job_id` on each of those requests to the\n same value, then you can retrieve a single entry for the job from\n `job_summaries`. If instead you let the Google Ads API assign a system-generated\n value to the `job_id` of each request, the `job_summaries` contains a separate\n entry for each request, which could make analyzing the overall health of your\n job more challenging.\n\nHow to use summaries\n--------------------\n\nTo ensure your import processes are recording conversions and enhancements as\nexpected, periodically retrieve the summaries for each of your accounts. If the\n`status` of any summary is not `EXCELLENT`, use the list of errors under\n`alerts` to guide you through modifying your import process to reduce or\neliminate those errors.\n\nFor example:\n\n- If the status is `NEEDS_ATTENTION`, then a significant portion of your\n import operations failed. Review the errors under `alerts` and modify your\n import process to reduce or eliminate those errors.\n\n- If the status is `NO_RECENT_UPLOADS`, then Google Ads has not received any recent\n imports for the `client`. If this is unexpected, then review the processes\n that perform imnports using that client.\n\n For example, if the `status` for `GOOGLE_ADS_API` is `NO_RECENT_UPLOADS`, that\n could indicate that your import process that uses the Google Ads API stopped running\n recently.\n- To determine if there was a specific import date or job that sent a large\n number of events that failed to process, check the `successful_count`,\n `failed_count`, and `pending_count` of `daily_summaries` and `job_summaries`.\n Any events in a pending state may take up to 24 hours\n to complete.\n\nMore information on how to improve offline data diagnostics can be found in\nthe [Help center](//support.google.com/google-ads/answer/13812240#4).\n\nRestrictions\n------------\n\nKeep the following in mind when retrieving import summaries:\n\n- The Google Ads API only returns offline data diagnostics if the\n [`customer_id`](/google-ads/api/reference/rpc/v21/SearchGoogleAdsStreamRequest#customer_id) of the\n `searchStream` or `search` request is the same customer you used recently to\n import conversions.\n\n For example, a client account that uses cross-account conversion tracking may\n not contain any diagnostics. However, you can retrieve diagnostics by sending\n a request where the `customer_id` matches the `customer_id` of the manager\n account you use in imports.\n- Google Ads treats `CLICK_NOT_FOUND` errors from [enhanced conversions for\n leads](/google-ads/api/docs/conversions/enhanced-conversions/leads) imports as warnings. As\n a result, if `alerts` contains an entry for this error, the corresponding\n operations are still considered successful and are included in the\n `successful_event_count`."]]
