Устранение неполадок

Управление конверсиями требует сложной интеграции, часто с использованием нескольких взаимозависимых инструментов и процессов. В этом руководстве приведены подробные инструкции по устранению неполадок, будь то непонятные ошибки API или вопросы по показателям или диагностике в интерфейсе.

Как читать показатели в интерфейсе Google Рекламы

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

Проблемы с расширенным отслеживанием конверсий лидов

В этом разделе рассматриваются распространенные проблемы, возникающие при импорте расширенных конверсий потенциальных клиентов.

Распространенные ошибки

Ниже приведены рекомендации по диагностике и устранению распространенных ошибок, связанных с расширенным отслеживанием конверсий потенциальных клиентов.

Ошибка
NO_CONVERSION_ACTION_FOUND	Указанное действие-конверсия не включено или недоступно для аккаунта, указанного в поле customer_id запроса. Убедитесь, что действие-конверсия в загружаемом файле включено и его владельцем является клиент Google Рекламы, связанный с кликом, или аккаунт, который находится в иерархии отслеживания конверсий загружающего аккаунта. Эта ошибка также может возникнуть, если GCLID в запросе принадлежит клиентскому аккаунту, у которого нет доступа к действию-конверсии, указанному в запросе. Чтобы проверить, относится ли GCLID к клиентскому аккаунту, используйте ресурс click_view. Отправьте запрос с фильтрацией по click_view.gclid и segments.date, где дата – это дата клика.
INVALID_CONVERSION_ACTION_TYPE	Указанное действие-конверсия имеет тип, который не подходит для расширенного отслеживания конверсий потенциальных клиентов. Убедитесь, что у объекта ConversionAction, указанного в запросе на загрузку, тип UPLOAD_CLICKS.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS	Убедитесь, что вы включили расширенное отслеживание конверсий лидов в настройках конверсий. Инструкции можно найти в руководстве по предварительным требованиям.
DUPLICATE_ORDER_ID	Импортированные события содержат разные конверсии с одинаковым идентификатором заказа. Они не будут обработаны. Задайте уникальные идентификаторы заказов и повторите попытку.
CLICK_NOT_FOUND	Не удалось найти клик, соответствующий указанным идентификаторам пользователей. Если конверсия вызывает это предупреждение, Google Ads API включает ее в successful_event_count диагностики офлайн-данных. В Google Ads API есть запись CLICK_NOT_FOUND в коллекции alerts, которая позволяет отслеживать частоту появления этого предупреждения. Эта ошибка ожидаема, если клик не связан с кампанией Google Рекламы. Например, это может быть SA360 или DV360. Другие возможные причины: Клиент, загружающий данные, отличается от клиента, связанного с конверсией Google Рекламы. Добавление тегов для лид-формы настроено неправильно. Загруженные данные не были правильно нормализованы и хешированы. В редких случаях, когда клиент, загружающий данные, отличается от клиента, отслеживающего конверсии в Google Рекламе, эта ошибка может означать, что клиент, загружающий данные, принял Условия в отношении данных клиента, а клиент, отслеживающий конверсии, – нет. Чтобы узнать, приняты ли в аккаунте условия в отношении данных клиентов, запросите ресурс customer и проверьте поле customer.conversion_tracking_setting.accepted_customer_data_terms.

Расхождения в показателях

Обратите внимание на следующие распространенные проблемы:

• Конверсии могут быть отброшены конвейером обработки по разным причинам, и такие конверсии не подлежат восстановлению. Подробнее о том, как устранить несоответствия данных после успешной загрузки…

• Убедитесь, что тег Google правильно настроен на вашей веб-странице и активируется при отправке лид-формы. Если тег не срабатывает при отправке формы или отправляет неверные данные, то атрибуция загруженных конверсий будет низкой или нулевой. Ознакомьтесь со статьями Справочного центра о том, как настроить расширенное отслеживание конверсий потенциальных клиентов с помощью тега Google и Google Менеджера тегов.

• Если вы используете расширенное отслеживание конверсий лидов без тега Google на веб-странице, то вы должны включить GCLID в импорт конверсий, задав поле ClickConversion.gclid для каждой конверсии.

• Убедитесь, что вы правильно указываете согласие в загружаемых данных. Для этого задайте настройки согласия по умолчанию для аккаунта (в интерфейсе Google Рекламы нажмите Инструменты > Менеджер данных > Настройки согласия) или задайте поле ClickConversion.consent для каждой загруженной конверсии.

Проблемы с эффективностью кампании

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

Проблемы с расширенным отслеживанием конверсий на сайтах

В этом разделе рассматриваются распространенные проблемы, возникающие при импорте расширенного отслеживания конверсий на сайтах.

Распространенные ошибки

Ниже приведены инструкции по диагностике и устранению распространенных ошибок, связанных с расширенным отслеживанием конверсий на сайтах.

Ошибка
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS	Условия в отношении данных клиента не приняты для customer_id запроса. Инструкции по выполнению этого действия приведены в руководстве по предварительным требованиям.
CONVERSION_ALREADY_ENHANCED	Для этой конверсии уже получена корректировка ENHANCEMENT с указанными полями order_id и conversion_action. Убедитесь, что для каждой конверсии указано уникальное значение order_id.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT	Указанный идентификатор conversion_action не подходит для расширенного отслеживания конверсий на сайтах. В интерфейсе Google Рекламы установите флажок Включить расширенное отслеживание конверсий для действия-конверсии, указанного в запросе. Инструкции вы найдете в Справочном центре.
INVALID_USER_IDENTIFIER	Поле хешированного идентификатора пользователя (hashed_email, hashed_phone_number, hashed_first_name, hashed_last_name или hashed_street_address) не является действительным 64-символьным шестнадцатеричным дайджестом SHA-256. Нормализуйте и хешируйте данные, предоставленные пользователями, перед импортом. Подробнее о том, как нормализовать и хешировать данные, предоставленные пользователями…
CONVERSION_NOT_FOUND	Google Рекламе не удалось найти конверсию, соответствующую указанному полю conversion_action и идентификатору конверсии (order_id или gclid_date_time_pair). Эта ошибка относится только к корректировкам RESTATEMENT и RETRACTION. Подробную информацию вы найдете в разделе Требования статьи "Как импортировать корректировки конверсий". Для корректировок ENHANCEMENT API принимает запрос, не возвращая ошибку CONVERSION_NOT_FOUND, и асинхронно оценивает соответствие order_id тега и API. Если таких order_id значений много, в отчете о диагностике расширенного отслеживания конверсий в интерфейсе Google Рекламы появится предупреждение о несоответствии идентификаторов заказов. Инструкции по устранению неполадок приведены в разделе Оповещения диагностики в интерфейсе после успешной загрузки через API.

Оповещения диагностики в интерфейсе после успешной загрузки через API

Когда вы загружаете корректировки ENHANCEMENT с помощью сервиса ConversionAdjustmentUploadService, API проверяет форматирование запроса во время загрузки и сопоставляет улучшения с событиями тега сайта асинхронно. В результате запросы к API могут выполняться без ошибок в поле partial_failure_error и со статусом EXCELLENT в диагностике офлайн-данных. При этом в отчете о диагностике расширенного отслеживания конверсий в интерфейсе Google Рекламы могут по-прежнему показываться оповещения.

Если после успешной загрузки через API в интерфейсе появляются оповещения диагностики, проверьте следующее:

• Отсутствуют обязательные поля адреса. Объект OfflineUserAddressInfo в поле address_info требует наличия четырех полей в одной записи: hashed_first_name, hashed_last_name, country_code и postal_code. Поля hashed_street_address, city и state необязательны. Если вы заполняете поле hashed_street_address, оно должно содержать действительный 64-символьный хеш SHA-256. API принимает непустые частичные объекты address_info (например, только имя и фамилию), не возвращая ошибку в поле partial_failure_error. Однако при последующем сопоставлении неполные адреса отбрасываются и появляется оповещение об отсутствующих полях адреса. Если хотя бы одно из четырех обязательных полей недоступно, пропустите объект UserIdentifier для поля address_info.

• Отсутствуют идентификаторы транзакций в событиях тега сайта. Если в корректировке ENHANCEMENT в API не указано поле order_id, возвращается синхронная ошибка FieldError.REQUIRED. Если ваши запросы к API включают поле order_id, то оповещение в интерфейсе о том, что в событии-конверсии отсутствует идентификатор транзакции, относится к тегу на вашем сайте. Это оповещение появляется, если менее 90 % событий тега конверсии на сайте включают действительный идентификатор транзакции (или если тег отправляет строки-плейсхолдеры, например "undefined" или "null"). Настройте тег конверсии на сайте так, чтобы он отправлял уникальный идентификатор транзакции для каждого события-конверсии.

• Несовпадение идентификаторов заказов из тега и API или поздняя загрузка. При корректировке ENHANCEMENT API не возвращает ошибку CONVERSION_NOT_FOUND или CONVERSION_EXPIRED во время загрузки. Вместо этого несоответствующие значения order_id вызывают в интерфейсе оповещение о несоответствии идентификатора заказа, а улучшения, загруженные более чем через 24 часа после конверсии, вызывают оповещение о поздней загрузке. Сопоставьте поле order_id API с точной строкой идентификатора транзакции, отправленной тегом конверсии на сайте, и загрузите улучшение в течение 24 часов после события-конверсии.

• Хеширование ненормализованных пользовательских данных перед загрузкой. Хеширование ненормализованных значений, например заглавных букв, начальных или конечных пробелов или номеров телефонов, не соответствующих формату E.164, по-прежнему приводит к созданию действительного 64-символьного шестнадцатеричного дайджеста SHA-256. API принимает загрузку, не возвращая ошибку INVALID_USER_IDENTIFIER, но сопоставление на последующих этапах не выполняется, и появляются оповещения о форматировании или низком коэффициенте соответствия. Следуйте правилам нормализации, приведенным в статье Как нормализовать и хешировать данные, предоставленные пользователями.

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

  • Настройка режима согласия. Если режим согласия в теге Google передает значение ad_storage='denied', то при диагностике в интерфейсе события тега сайта, для которых не получено согласие, исключаются из сравнения. Поэтому отсутствие таких событий в загрузках API не приводит к появлению оповещения о низком объеме данных. Однако если обработка согласия в теге сайта и триггерах на сервере не совпадает, вы увидите следующие оповещения:

    • В теге нет параметра ad_storage='denied', сервер пропускает загрузку. В диагностике интерфейса события тега считаются событиями с согласием, и показывается оповещение о низком охвате.
    • Сигналы тегов ad_storage='denied', улучшение загрузок в серверной части. Для загруженных улучшений нет соответствующего события тега с согласием, и они приводят к оповещениям о несоответствии идентификатора заказа.

    Примените один и тот же статус согласия к тегу сайта и загрузкам улучшений API.

  • Анонимные события на сайте. Не включайте расширенное отслеживание конверсий для действий-конверсий в верхней части воронки (например, просмотров страниц или товаров), когда тег сайта срабатывает для анонимных посетителей. Если ваш сервер отправляет улучшения API только для вошедших в систему пользователей с известными контактными данными, то несопоставленные анонимные события тегов вызовут оповещение о низком охвате. Включайте расширенное отслеживание конверсий только для тех действий-конверсий, для которых данные, предоставленные пользователями, доступны постоянно.

Общие проблемы с управлением конверсиями

Обратите внимание на следующие распространенные проблемы:

• Если вы попытаетесь задать для поля enum значение UNKNOWN, то получите ошибку RequestError.INVALID_ENUM_VALUE. Это распространенная проблема, когда указывается значение consent, если рекламодатель не знает, было ли получено согласие. Если статус consent неизвестен, задайте значение DENIED.

• При создании действия-конверсии для конверсий в приложении или Firebase и сторонних сервисов аналитики приложений вы можете изменить поле app_id только при создании. После создания действия-конверсии это поле изменить нельзя.

• При создании действия-конверсии для поля ConversionAction.attribution_model_settings.attribution_model можно задать только значение GOOGLE_ADS_LAST_CLICK или GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN. Если выбрать другой вариант, возникнет ошибка CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. Подробную информацию вы найдете в записи в нашем блоге, посвященной прекращению поддержки других моделей атрибуции.

• Допустимый диапазон для поля click_through_lookback_window_days – от 1 до 60 дн. для действий-конверсий типа AD_CALL и WEBSITE_CALL. Для большинства других действий-конверсий допустимый диапазон составляет от 1 до 90 дней.

• Для большинства действий-конверсий допустимый диапазон значений в поле view_through_lookback_window_days составляет от 1 до 30 дней. Это поле должно быть незаполненным для действий-конверсий типа AD_CALL и WEBSITE_CALL.

• Если вы попытаетесь задать или изменить значение поля include_in_conversions_metric в действии-конверсии, то получите ошибку FieldError.IMMUTABLE_FIELD. Вместо этого задайте поле primary_for_goal, как описано в руководстве по целям конверсий.

• При создании действия-конверсии типа WEBSITE_CALL или AD_CALL для поля value_settings.always_use_default_value должно быть задано значение true. Если указать значение false, возникнет ошибка INVALID_VALUE.

Распространенные ошибки

Ниже приведены рекомендации по диагностике и устранению распространенных ошибок при импорте офлайн-конверсий, в том числе ошибок доступа при отслеживании конверсий в управляющем аккаунте.

Ошибка
INVALID_CONVERSION_ACTION_TYPE	Указанное действие-конверсия имеет тип, который не подходит для загрузки конверсий по кликам. Убедитесь, что в запросе на загрузку указан тип UPLOAD_CLICKS для ConversionAction.
NO_CONVERSION_ACTION_FOUND	Указанное действие-конверсия не включено или недоступно для аккаунта в поле customer_id запроса. Получите информацию о настройках отслеживания конверсий, чтобы убедиться, что действие-конверсия включено. Владельцем действия-конверсии должен быть либо клиент Google Рекламы, связанный с конверсией по клику, либо аккаунт, входящий в иерархию отслеживания конверсий аккаунта, в который загружаются данные. Например, эта ошибка возникает, если действие-конверсия относится к бывшему управляющему аккаунту, связь с которым была отменена после клика.
TOO_RECENT_CONVERSION_ACTION	Действие-конверсия создано недавно. Подождите не менее шести часов после создания действия и повторите попытку.
INVALID_CUSTOMER_FOR_CLICK	Поле customer_id в запросе не соответствует клиенту конверсии Google Рекламы на момент клика. Эта ошибка возникает, когда у аккаунта, из которого выполняется загрузка, нет доступа к действию-конверсии в другом аккаунте. Обновите поле customer_id в запросе, указав аккаунт в иерархии владельца действия-конверсии.
EVENT_NOT_FOUND	Google Реклама не может найти сочетание идентификатора клика и customer_id. Ознакомьтесь с требованиями к customer_id и убедитесь, что вы загружаете данные в правильный аккаунт Google Рекламы.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST	Несколько конверсий в запросе имеют одинаковую комбинацию идентификатора клика, conversion_date_time и conversion_action. Удалите повторяющиеся конверсии из запроса.
CLICK_CONVERSION_ALREADY_EXISTS	Конверсия с таким же сочетанием идентификатора клика, conversion_date_time и conversion_action уже была загружена. Если вы повторно загружаете конверсию, которая уже была успешно загружена, игнорируйте эту ошибку. Если вы хотите добавить ещё одну конверсию в дополнение к ранее загруженной, измените значение conversion_date_time в ClickConversion, чтобы избежать дублирования ранее загруженной конверсии.
EXPIRED_EVENT	Импортированный клик произошел до временного интервала, указанного в поле click_through_lookback_window_days. Изменение click_through_lookback_window_days влияет только на клики, зарегистрированные после него, поэтому изменение периода учета не устранит эту ошибку для конкретного клика. При необходимости замените conversion_action на другое действие с более длительным периодом ретроспективного анализа.
CONVERSION_PRECEDES_EVENT	Значение conversion_date_time предшествует дате и времени клика. Укажите более позднее значение для свойства conversion_date_time.
VALUE_MUST_BE_UNSET	В ClickConversion задано значение для gbraid или wbraid (без gclid), а также для custom_variables или cart_data, что не поддерживается в Google Рекламе при использовании gbraid или wbraid. Удалите конфликтующее поле.