Мониторинг автономной диагностики данных

Используйте 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 .

Назад
Пользовательские переменные конверсии
Далее
Отчеты