Как отслеживать диагностику офлайн-данных

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

Чтобы получить последние данные диагностики офлайн-данных для своего аккаунта, используйте один из следующих ресурсов:

• 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 Рекламы, результаты будут содержать отдельные записи для значений client GOOGLE_ADS_API и GOOGLE_ADS_WEB_CLIENT.

Диагностика на уровне действия-конверсии

Чтобы получить данные диагностики загрузки конверсий на уровне действия-конверсии, используйте следующий запрос GAQL:

SELECT
  offline_conversion_upload_conversion_action_summary.conversion_action_id,
  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 = <CONVERSION_ACTION_ID>

Как и в случае с диагностикой на уровне аккаунта, этот запрос возвращает отдельные строки OfflineConversionUploadConversionActionSummary для каждого типа клиента, использованного в недавних импортах. Например, если вы недавно импортировали данные с помощью Google Ads API и интерфейса Google Рекламы, результаты будут содержать отдельные записи для значений client GOOGLE_ADS_API и GOOGLE_ADS_WEB_CLIENT.

Как интерпретировать сводки

Каждый объект OfflineConversionUploadClientSummary или OfflineConversionUploadConversionActionSummary содержит поле status, которое отражает общее состояние импорта для client. В нем также содержится следующая информация:

• Общее количество полученных событий.
• Количество успешно обработанных событий.
• Количество ожидающих событий (событий, которые все ещё обрабатываются).
• Поле alerts, в котором содержится сводка ошибок, сгруппированных по OfflineConversionError.

Все эти поля содержат информацию за последний полный календарный день импорта. Используйте эту информацию, чтобы оценить текущее состояние импорта.

Кроме того, в каждом OfflineConversionUploadClientSummary или OfflineConversionUploadConversionActionSummary есть два типа отчетов:

daily_summaries

successful_count, failed_count и pending_count запросов на импорт за последние семь дней, сгруппированные по date импорта.

job_summaries

successful_count, failed_count и pending_count семи последних запросов на импорт, сгруппированные по job_id. job_id – необязательное поле в UploadClickConversionsRequest и UploadConversionAdjustmentsRequest. Вы можете задать для поля job_id положительное 32-битное целое число (от 1 до 2^31 - 1) или разрешить Google Ads API назначить вашему запросу идентификатор задания, сгенерированный системой. Независимо от выбранного варианта UploadClickConversionsResponse или UploadConversionAdjustmentsResponse возвращает job_id.

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

Как использовать сводки

Чтобы убедиться, что процессы импорта принимают конверсии и улучшения без ошибок API, периодически запрашивайте сводки для каждого из своих аккаунтов. Если в поле status сводки указано значение, отличное от EXCELLENT, используйте список ошибок в поле alerts, чтобы изменить процесс импорта и уменьшить количество ошибок или полностью их устранить.

Пример:

• Если статус – NEEDS_ATTENTION, значит значительная часть операций импорта не выполнена. Проверьте ошибки в разделе alerts и измените процесс импорта, чтобы уменьшить или устранить их.

• Если статус – NO_RECENT_UPLOADS, то Google Реклама не получала недавних импортов для client. Если это не так, проверьте процессы, которые выполняют импорт с помощью этого клиента.

  Например, если status для GOOGLE_ADS_API – NO_RECENT_UPLOADS, это может означать, что процесс импорта, использующий Google Ads API, недавно прекратил работу.

• Чтобы определить, была ли конкретная дата импорта или задание, в результате которого было отправлено большое количество событий, которые не удалось обработать, проверьте successful_count, failed_count и pending_count для daily_summaries и job_summaries. Обработка событий в статусе ожидания может занять до 24 часов.

Дополнительную информацию о том, как улучшить диагностику офлайн-данных, можно найти в Справочном центре.

Ограничения

При получении сводки импорта учитывайте следующее:

• Google Ads API возвращает диагностику офлайн-данных, только если customer_id запроса searchStream или search относится к тому же клиенту, для которого вы недавно импортировали конверсии.

  Например, в клиентском аккаунте, в котором используется отслеживание конверсий в управляющем аккаунте, может не быть данных диагностики. Однако вы можете получить диагностические данные, отправив запрос, в котором customer_id совпадает с customer_id управляющего аккаунта, используемого при импорте.

• Google Реклама обрабатывает ошибки CLICK_NOT_FOUND при импорте расширенного отслеживания конверсий лидов как предупреждения. В результате, если в alerts есть запись об этой ошибке, соответствующие операции по-прежнему считаются успешными и включаются в successful_event_count.