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

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

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

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

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

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

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

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

Ошибка
NO_CONVERSION_ACTION_FOUND

Указанное действие-конверсия либо не включено, либо недоступно для клиентского аккаунта, заданного в поле customer_id запроса. Убедитесь, что действие-конверсия, указанное в загружаемом файле, включено и принадлежит клиенту, отправившему запрос на загрузку.

Эта ошибка также может возникнуть, если параметр 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 Рекламе, эта ошибка может означать, что клиент, загружающий данные, принял условия использования данных клиентов, а клиент, выполняющий конверсию, – нет.

Чтобы узнать, приняты ли в аккаунте условия использования данных клиентов, отправьте запрос к ресурсу customer и проверьте поле customer.conversion_tracking_setting.accepted_customer_data_terms.

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

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

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

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

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

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

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

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

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

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

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

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

Ошибка
CONVERSION_NOT_FOUND Не удалось найти конверсию для указанной пары "действие-конверсия – идентификатор конверсии". order_id Убедитесь, что конверсия является конверсией Google Рекламы для клиента, выполняющего конверсии в Google Рекламе, указанного в customer_id запроса.
Кроме того, убедитесь, что конверсия не была связана с кликом, в котором вместо gclid были указаны значения gbraid или wbraid. Google Реклама не поддерживает расширенное отслеживание конверсий на сайтах для таких конверсий.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS Условия использования данных клиентов не были приняты для customer_id запроса. Инструкции по этому вопросу приведены в руководстве по предварительным требованиям.
CONVERSION_ALREADY_ENHANCED Для этой конверсии уже была выполнена корректировка с указанными значениями order_id и conversion_action. Убедитесь, что для каждой конверсии указан уникальный order_id.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT Указанное значение conversion_action не допущено для расширенного отслеживания конверсий на сайтах. В интерфейсе Google Рекламы установите флажок Включить расширенное отслеживание конверсий для действия-конверсии, на которое ссылается ваш запрос. Инструкции можно найти в Справочном центре.

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

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

  • При попытке задать для любого поля перечисления значение 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 Указанное действие-конверсия имеет тип, который не подходит для загрузки конверсий по клику. Убедитесь, что у объекта ConversionAction, указанного в запросе на загрузку, тип UPLOAD_CLICKS.
NO_CONVERSION_ACTION_FOUND Указанное действие-конверсия не включено или не найдено в загружаемом customer_id. Получите информацию о настройке конверсий, чтобы убедиться, что действие-конверсия в загружаемом файле включено и принадлежит аккаунту customer_id, указанному в запросе на загрузку.
TOO_RECENT_CONVERSION_ACTION Действие-конверсия было создано недавно. Подождите не менее шести часов после создания действия, прежде чем повторно загружать данные о конверсиях.
INVALID_CUSTOMER_FOR_CLICK customer_id запроса не совпадает с идентификатором клиента, который был аккаунтом для обработки конверсий Google Ads API во время клика. Измените 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, чтобы избежать дублирования.
EVENT_NOT_FOUND Google Реклама не может найти сочетание идентификатора клика и customer_id. Проверьте требования к customer_id и убедитесь, что вы загружаете данные в нужный аккаунт Google Рекламы.
EXPIRED_EVENT Импортированный клик произошел до периода времени, указанного в поле click_through_lookback_window_days. Изменение click_through_lookback_window_days влияет только на клики, зарегистрированные после изменения, поэтому изменение периода учета не устранит эту ошибку для определенного клика. Если это необходимо, измените conversion_action на другое действие с более длинным периодом ретроспективного анализа.
CONVERSION_PRECEDES_EVENT conversion_date_time предшествует дате и времени клика. Измените значение conversion_date_time на более позднее.
GBRAID_WBRAID_BOTH_SET Для объекта ClickConversion заданы значения и для gbraid, и для wbraid. Измените конверсию так, чтобы в ней использовался только один идентификатор клика или параметр URL, и убедитесь, что вы не объединяете несколько кликов в одну конверсию. У каждого клика есть только один идентификатор клика или параметр URL.
VALUE_MUST_BE_UNSET Проверьте location элемента GoogleAdsError, чтобы определить, какая из перечисленных ниже проблем привела к ошибке.
  • У параметра ClickConversion задано значение gclid, а также хотя бы одно из значений gbraid или wbraid. Измените конверсию так, чтобы в ней использовался только один идентификатор клика или параметр URL, и убедитесь, что вы не объединяете несколько кликов в одну конверсию. У каждого клика может быть только один идентификатор клика или параметр URL.
  • В объекте ClickConversion задано значение для gbraid или wbraid и для custom_variables. Google Реклама не поддерживает специальные переменные для конверсий с параметром URL gbraid или wbraid. Удалите значение поля custom_variables в конверсии.