Monitorowanie diagnostyki danych offline
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Użyj interfejsu Google Ads API, aby pobrać diagnostykę danych offline, która zawiera informacje o ogólnym stanie procesów importowania konwersji i korygowania danych.
Aby pobrać najnowsze dane diagnostyczne dotyczące danych offline na koncie, skorzystaj z jednego z tych zasobów:
Diagnostyka na poziomie konta
Aby pobrać diagnostykę przesyłania konwersji na poziomie konta, użyj tego zapytania GAQL:
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
To zapytanie zwraca oddzielne wierszeOfflineConversionUploadClientSummary dla każdego typu klienta użytego w ostatnich importach. Jeśli np. ostatnio importowano dane za pomocą interfejsu Google Ads API i interfejsu Google Ads, wyniki będą zawierać osobne wpisy dla wartości client: GOOGLE_ADS_API i GOOGLE_ADS_WEB_CLIENT.
Diagnostyka na poziomie działania powodującego konwersję
Aby pobrać diagnostykę przesyłania konwersji na poziomie działania powodującego konwersję, użyj tego zapytania GAQL:
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 >
Podobnie jak w przypadku diagnostyki na poziomie konta to zapytanie zwraca osobne wiersze OfflineConversionUploadConversionActionSummary dla każdego typu klienta użytego w ostatnich importach. Jeśli np. ostatnio importowano dane za pomocą interfejsu Google Ads API i interfejsu Google Ads, wyniki będą zawierać osobne wpisy dla wartości client: GOOGLE_ADS_API i GOOGLE_ADS_WEB_CLIENT.
Jak interpretować te podsumowania
Każdy element OfflineConversionUploadClientSummary lub OfflineConversionUploadConversionActionSummary ma pole status, które odzwierciedla ogólny stan importów w przypadku client. Zawiera też te informacje:
- Liczba wszystkich otrzymanych zdarzeń.
- Liczba zdarzeń, które zostały przetworzone.
- Liczba oczekujących zdarzeń (zdarzeń, które są nadal przetwarzane).
- Pole
alerts, które zawiera podsumowanie błędów pogrupowanych według OfflineConversionError.
Wszystkie te pola zawierają informacje z ostatniego pełnego dnia kalendarzowego importów. Używaj tych informacji do oceny bieżącego stanu importów.
Każda OfflineConversionUploadClientSummary lub OfflineConversionUploadConversionActionSummary zawiera 2 rodzaje raportów:
daily_summaries- A
successful_count, failed_count i pending_count z żądań importu z ostatnich 7 dni pogrupowane według importu date.
job_summariesWartości successful_count, failed_count i pending_count z 7 najnowszych próśb o import pogrupowane według parametru job_id. Pole job_id jest opcjonalne w przypadku UploadClickConversionsRequest i UploadConversionAdjustmentsRequest. Możesz ustawić wartość parametru
job_id na nieujemną liczbę mniejszą niż 2^31 lub pozwolić interfejsowi Google Ads API przypisać do Twojego żądania wygenerowany przez system identyfikator zadania. Niezależnie od wybranej opcji funkcja UploadClickConversionsResponse lub UploadConversionAdjustmentsResponse zwraca wartość job_id.
Przypisanie własnego identyfikatora job_id jest przydatne w sytuacji, gdy masz jedno zadanie lub proces, który importuje dużą liczbę konwersji za pomocą wielu żądań. Jeśli w każdym z tych żądań ustawisz parametr job_id na tę samą wartość, możesz pobrać z job_summaries pojedynczy wpis dotyczący zadania. Jeśli zamiast tego pozwolisz interfejsowi Google Ads API przypisać wygenerowaną przez system wartość do parametru job_id każdego żądania, parametr job_summaries będzie zawierać osobny wpis dla każdego żądania, co może utrudnić analizowanie ogólnego stanu zadania.
Jak korzystać z podsumowań
Aby mieć pewność, że procesy importu rejestrują konwersje i ulepszenia zgodnie z oczekiwaniami, okresowo pobieraj podsumowania dla każdego konta. Jeśli w przypadku któregoś podsumowania wartość status nie jest równa EXCELLENT, skorzystaj z listy błędów w sekcji alerts, aby zmodyfikować proces importu i zmniejszyć liczbę błędów lub je wyeliminować.
Na przykład:
Jeśli stan to NEEDS_ATTENTION, oznacza to, że znaczna część operacji importu zakończyła się niepowodzeniem. Sprawdź błędy w sekcji alerts i zmodyfikuj proces importowania, aby je ograniczyć lub wyeliminować.
Jeśli stan to NO_RECENT_UPLOADS, oznacza to, że Google Ads nie otrzymało ostatnio żadnych importów dotyczących client. Jeśli jest to niespodziewane, sprawdź procesy, które wykonują importy za pomocą tego klienta.
Jeśli np. wartość status dla GOOGLE_ADS_API wynosi NO_RECENT_UPLOADS, może to oznaczać, że proces importowania korzystający z interfejsu Google Ads API został niedawno zatrzymany.
Aby sprawdzić, czy była konkretna data importu lub zadanie, które wysłało dużą liczbę zdarzeń, które nie zostały przetworzone, sprawdź successful_count, failed_count i pending_count w przypadku daily_summaries i job_summaries.
Przetwarzanie zdarzeń w stanie oczekiwania może potrwać do 24 godzin.
Więcej informacji o tym, jak ulepszyć diagnostykę danych offline, znajdziesz w Centrum pomocy.
Ograniczenia
Podczas pobierania podsumowań importu pamiętaj o tych kwestiach:
Interfejs Google Ads API zwraca diagnostykę danych offline tylko wtedy, gdy customer_id w przypadku żądania searchStream lub search jest tym samym klientem, którego używasz ostatnio do importowania konwersji.
Na przykład konto klienta, które korzysta ze śledzenia konwersji dla wielu kont, może nie zawierać żadnych informacji diagnostycznych. Możesz jednak pobrać dane diagnostyczne, wysyłając żądanie, w którym wartość parametru customer_id jest zgodna z wartością parametru customer_id na koncie menedżera używanym do importowania.
Google Ads traktuje CLICK_NOT_FOUND błędy importowania konwersji rozszerzonych dotyczących potencjalnych klientów jako ostrzeżenia. W rezultacie, jeśli pole alerts zawiera wpis dotyczący tego błędu, odpowiednie operacje są nadal uznawane za zakończone powodzeniem i są uwzględniane w polu successful_event_count.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-09-05 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 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`."]]
