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

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

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

Диагностика на уровне аккаунта

Чтобы получить диагностику загрузки конверсий на уровне аккаунта, используйте следующий запрос 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 для каждого типа клиента, использованного в последних загрузках. Например, если вы недавно загружали данные с помощью API Google Рекламы и пользовательского интерфейса Google Рекламы, результаты будут содержать отдельные записи для 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 для каждого типа клиента, использованного в последних загрузках. Например, если вы недавно загружали данные с помощью API Google Рекламы и пользовательского интерфейса 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 запросов на загрузку за последние 7 дней, сгруппированные по date загрузки.
job_summaries

successful_count , failed_count и pending_count 7 последних запросов на загрузку, сгруппированных по job_id . job_id — это необязательное поле UploadClickConversionsRequest и UploadConversionAdjustmentsRequest . Вы можете либо установить для job_id неотрицательное число меньше 2^31 , либо позволить API Google Рекламы назначить вашему запросу сгенерированный системой идентификатор задания. Независимо от того, какой вариант вы выберете, 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_APINO_RECENT_UPLOADS , это может указывать на то, что ваш процесс загрузки, использующий API Google Рекламы, недавно прекратил работу.

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

Ограничения

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

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

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

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