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

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

A 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.