Мониторинг автономной диагностики данных
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Используйте API Google Ads для получения офлайн-диагностики данных , которая содержит информацию об общем состоянии ваших процессов импорта и корректировки конверсий.
Чтобы получить последние данные офлайн-диагностики для вашей учетной записи, воспользуйтесь одним из следующих ресурсов:
Диагностика на уровне аккаунта
Чтобы получить диагностику загрузки конверсий на уровне аккаунта, используйте следующий запрос 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
Этот запрос возвращает отдельные строки OfflineConversionUploadClientSummary для каждого типа клиента, использованного в недавних импортах. Например, если вы недавно импортировали данные, используя как API Google Ads, так и интерфейс Google Ads, результаты будут содержать отдельные записи для client GOOGLE_ADS_API и GOOGLE_ADS_WEB_CLIENT .
Диагностика уровня конверсионных действий
Для получения диагностики загрузки конверсий на уровне действия конверсии используйте следующий запрос 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 >
Подобно диагностике на уровне аккаунта, этот запрос возвращает отдельные строки OfflineConversionUploadConversionActionSummary для каждого типа клиента, использованного в недавних импортах. Например, если вы недавно импортировали данные, используя как API Google Ads, так и интерфейс Google Ads, результаты будут содержать отдельные записи для GOOGLE_ADS_API client GOOGLE_ADS_WEB_CLIENT .
Как интерпретировать эти сводки
У каждого OfflineConversionUploadClientSummary или OfflineConversionUploadConversionActionSummary есть поле status , отражающее общее состояние импорта для client . Оно также содержит следующую информацию:
- Количество всех полученных событий.
- Количество успешно обработанных событий.
- Количество ожидающих событий (событий, которые все еще обрабатываются).
- Поле
alerts , в котором содержится сводка ошибок, сгруппированных по OfflineConversionError .
Все эти поля содержат информацию за последний полный календарный день импорта. Используйте эту информацию для оценки текущего состояния вашего импорта.
Кроме того, каждый OfflineConversionUploadClientSummary или OfflineConversionUploadConversionActionSummary содержит два различных типа отчетов:
-
daily_summaries -
successful_count , failed_count и pending_count запросов на импорт за последние 7 дней, сгруппированных по date импорта. -
job_summaries Значения successful_count , failed_count и pending_count 7 последних запросов на импорт, сгруппированные по job_id . Поле job_id — необязательное для запросов UploadClickConversionsRequest и UploadConversionAdjustmentsRequest . Вы можете указать в качестве job_id неотрицательное число меньше 2^31 или позволить API Google Ads назначить вашему запросу системный идентификатор задания. Независимо от выбранного варианта, ответ UploadClickConversionsResponse или UploadConversionAdjustmentsResponse возвращает job_id .
Назначение собственного job_id может быть полезным, например, при наличии одного задания или процесса, импортирующего большое количество конверсий с помощью нескольких запросов. Если задать job_id для каждого из этих запросов одно и то же значение, то из job_summaries можно будет получить одну запись для этого задания. Если же вместо этого позволить API Google Ads назначать системное значение job_id для каждого запроса, job_summaries будет содержать отдельную запись для каждого запроса, что может затруднить анализ общего состояния вашего задания.
Как использовать резюме
Чтобы гарантировать, что ваши процессы импорта регистрируют конверсии и улучшения должным образом, периодически проверяйте сводки по каждому из ваших аккаунтов. Если status какой-либо сводки не EXCELLENT , воспользуйтесь списком ошибок в разделе alerts , чтобы изменить процесс импорта и уменьшить или устранить эти ошибки.
Например:
Если статус — NEEDS_ATTENTION , значит, значительная часть операций импорта не выполнена. Просмотрите ошибки в alerts и измените процесс импорта, чтобы уменьшить или устранить их.
Если статус — NO_RECENT_UPLOADS , это означает, что Google Ads не получал недавних импортов для этого client . Если это неожиданно, проверьте процессы, которые выполняют импорт с использованием этого клиента.
Например, если status GOOGLE_ADS_API — NO_RECENT_UPLOADS , это может означать, что ваш процесс импорта, использующий API Google Ads, недавно прекратил работу.
Чтобы определить, была ли конкретная дата импорта или задание, приведшее к отправке большого количества событий, которые не удалось обработать, проверьте значения successful_count , failed_count и pending_count для daily_summaries и job_summaries . Любые события, находящиеся в состоянии ожидания, могут завершиться в течение 24 часов.
Более подробную информацию о том, как улучшить диагностику офлайн-данных, можно найти в Справочном центре .
Ограничения
При получении сводок импорта помните следующее:
API Google Ads возвращает только данные автономной диагностики, если customer_id searchStream или search запроса принадлежит тому же клиенту, которого вы недавно использовали для импорта конверсий.
Например, клиентская учётная запись, использующая отслеживание конверсий между учётными записями, может не содержать диагностических данных. Однако вы можете получить диагностические данные, отправив запрос, в котором customer_id совпадает с customer_id учётной записи менеджера, используемой при импорте.
Google Реклама обрабатывает ошибки CLICK_NOT_FOUND , возникающие при расширенном отслеживании конверсий для импорта лидов , как предупреждения. Поэтому, если alerts есть запись об этой ошибке, соответствующие операции всё равно считаются успешными и включаются в successful_event_count .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-09-03 UTC.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-09-03 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`."]]
