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

Используйте 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 неотрицательное число меньше 2^31 или разрешить Google Ads API назначить вашему запросу идентификатор задания, созданный системой. Независимо от выбранного варианта UploadClickConversionsResponse или UploadConversionAdjustmentsResponse возвращает job_id.

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

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

Чтобы убедиться, что процессы импорта регистрируют конверсии и улучшения так, как вы ожидаете, периодически получайте сводки для каждого из своих аккаунтов. Если значение 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.