Эта страница переведена с помощью Cloud Translation API.

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

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

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

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.resource_name,
  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 .

Каждый OfflineConversionUploadClientSummary имеет поле status , которое отражает общую работоспособность загрузок для client . Он также содержит общее количество полученных событий, количество успешно обработанных событий и поле alerts , в котором представлена сводка ошибок, сгруппированных по OfflineConversionError . Все эти поля содержат информацию за последний полный календарный день загрузки. Используйте эту информацию для оценки текущего состояния ваших загрузок.

Кроме того, каждый OfflineConversionUploadClientSummary содержит два разных типа отчетов:

daily_summaries

successful_count и failed_count запросов на загрузку за последние 7 дней, сгруппированных по date загрузки.

job_summaries

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

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

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

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

Например:

Если статус NEEDS_ATTENTION , значит, значительная часть ваших операций загрузки завершилась неудачей. Просмотрите ошибки в alerts и измените процесс загрузки, чтобы уменьшить или устранить эти ошибки.
Если статус NO_RECENT_UPLOADS , Google Реклама не получала никаких последних загрузок для client . Если это неожиданно, просмотрите процессы, выполняющие загрузку с помощью этого клиента.
Например, если status GOOGLE_ADS_API — NO_RECENT_UPLOADS , это может указывать на то, что ваш процесс загрузки, использующий API Google Рекламы, недавно прекратил работу.
Проверьте successful_count и failed_count daily_summaries и job_summaries , чтобы определить, была ли определенная дата загрузки или задание, которое отправило большое количество событий, которые не были успешно обработаны.

Ограничения

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

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

Правила ценности конверсии

Отчеты