Используйте API Google Рекламы для получения диагностических автономных данных , которые содержат информацию об общем состоянии процессов загрузки и корректировки конверсий.
Чтобы получить последние диагностические данные автономной работы для вашей учетной записи, воспользуйтесь одним из следующих ресурсов:
-
offline_conversion_upload_client_summary
объединяет диагностику загрузки на уровне аккаунта. -
offline_conversion_upload_conversion_action_summary
(доступно только в версии 17 или более поздней) объединяет диагностику загрузки на уровне действия-конверсии.
Диагностика на уровне аккаунта
Чтобы получить диагностику загрузки конверсий на уровне аккаунта, используйте следующий запрос 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_API
—NO_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
.