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

Используйте API Google Ads для получения диагностических данных в автономном режиме , содержащих информацию об общем состоянии процессов импорта и корректировки конверсий.

Для получения последних диагностических данных в автономном режиме для вашей учетной записи воспользуйтесь одним из следующих ресурсов:

• Функция offline_conversion_upload_client_summary выполняет агрегирование данных для диагностики импорта на уровне учетной записи.
• offline_conversion_upload_conversion_action_summary объединяет диагностические данные импорта на уровне действия конверсии.

Диагностика на уровне учетной записи

Для получения диагностических данных о загрузке данных о конверсиях на уровне учетной записи используйте следующий 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 для каждого типа клиента, использованного в последних импортах. Например, если вы недавно импортировали данные, используя как Google Ads API, так и пользовательский интерфейс 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 для каждого типа клиента, использованного в последних импортах. Например, если вы недавно импортировали данные, используя как Google Ads API, так и пользовательский интерфейс Google Ads, результаты будут содержать отдельные записи для значений client GOOGLE_ADS_API и 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 Ads рассматривает ошибки CLICK_NOT_FOUND возникающие при импорте лидов в рамках расширенных конверсий , как предупреждения. В результате, если в alerts содержится запись об этой ошибке, соответствующие операции все равно считаются успешными и включаются в количество successful_event_count ).