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