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

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