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

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

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

Проблемы с расширенным отслеживанием конверсий для потенциальных клиентов

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

Ошибка
NO_CONVERSION_ACTION_FOUND

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

Эта ошибка также может возникнуть, если GCLID в запросе принадлежит учетной записи клиента, у которой нет доступа к действию-конверсии, указанному в запросе. Вы можете проверить, принадлежит ли GCLID учетной записи клиента, используя ресурс click_view , отправив запрос, который фильтруется по click_view.gclid и segments.date , где дата — это дата, когда произошел клик.

INVALID_CONVERSION_ACTION_TYPE Тип указанного действия-конверсии недопустим для расширенных конверсий для потенциальных клиентов. Убедитесь, что ConversionAction указанный в вашем запросе на загрузку, имеет тип UPLOAD_CLICKS .
CLICK_CONVERSION_ALREADY_EXISTS Конверсия с такой conversion_date_time уже существует для этого клика. Убедитесь, что conversion_date_time уникальна для каждого события, и повторите попытку.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS Убедитесь, что в настройках конверсий вы включили расширенное преобразование для потенциальных клиентов. Инструкции для этого можно найти в руководстве по предварительным требованиям .
DUPLICATE_ORDER_ID Импортированные события включают несколько конверсий с одним и тем же идентификатором заказа и не были обработаны. Убедитесь, что идентификаторы заказов уникальны, и повторите попытку.
CLICK_NOT_FOUND Не обнаружено ни одного клика, соответствующего предоставленным идентификаторам пользователей. Google Реклама API возвращает эту ошибку, только если debug_enabled имеет true в UploadClickConversionsRequest .

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

Эта ошибка ожидается, если клик получен не из кампании Google Рекламы. Например, это может быть SA360 или DV360 . Другие возможные причины следующие:

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

Вы можете определить, приняла ли учетная запись условия использования данных клиента, запросив ресурс customer и проверив поле customer.offline_conversion_tracking_info.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, 30] .

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

  • Установка или обновление поля include_in_conversion_metrics в действии-конверсии приведет к ошибке 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 Действие-конверсия создано заново. Прежде чем повторять неудачные конверсии, подождите не менее 6 часов после создания действия.
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 . Обновите конверсию, чтобы использовать только один идентификатор клика, и убедитесь, что вы не объединяете несколько кликов в одну конверсию. Каждый клик имеет только один идентификатор клика.
VALUE_MUST_BE_UNSET Проверьте location ошибки GoogleAdsError , чтобы определить, какая из следующих проблем привела к ошибке.
  • ClickConversion имеет набор значений для gclid , а также по крайней мере одно из gbraid или wbraid . Обновите конверсию, чтобы использовать только один идентификатор клика, и убедитесь, что вы не объединяете несколько кликов в одну конверсию. Каждый клик имеет только один идентификатор клика.
  • ClickConversion имеет набор значений для gbraid или wbraid и значение custom_variables . Google Реклама не поддерживает пользовательские переменные для конверсий с идентификатором клика gbraid или wbraid . Удалите значение поля custom_variables преобразования.
,

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

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

Проблемы с расширенным отслеживанием конверсий для потенциальных клиентов

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

Ошибка
NO_CONVERSION_ACTION_FOUND

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

Эта ошибка также может возникнуть, если GCLID в запросе принадлежит учетной записи клиента, у которой нет доступа к действию-конверсии, указанному в запросе. Вы можете проверить, принадлежит ли GCLID учетной записи клиента, используя ресурс click_view , отправив запрос, который фильтруется по click_view.gclid и segments.date , где дата — это дата, когда произошел клик.

INVALID_CONVERSION_ACTION_TYPE Тип указанного действия-конверсии недопустим для расширенных конверсий для потенциальных клиентов. Убедитесь, что ConversionAction указанный в вашем запросе на загрузку, имеет тип UPLOAD_CLICKS .
CLICK_CONVERSION_ALREADY_EXISTS Конверсия с такой conversion_date_time уже существует для этого клика. Убедитесь, что conversion_date_time уникальна для каждого события, и повторите попытку.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS Убедитесь, что в настройках конверсий вы включили расширенное преобразование для потенциальных клиентов. Инструкции для этого можно найти в руководстве по предварительным требованиям .
DUPLICATE_ORDER_ID Импортированные события включают несколько конверсий с одним и тем же идентификатором заказа и не были обработаны. Убедитесь, что идентификаторы заказов уникальны, и повторите попытку.
CLICK_NOT_FOUND Не обнаружено ни одного клика, соответствующего предоставленным идентификаторам пользователей. Google Реклама API возвращает эту ошибку, только если debug_enabled имеет true в UploadClickConversionsRequest .

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

Эта ошибка ожидается, если клик получен не из кампании Google Рекламы. Например, это может быть SA360 или DV360 . Другие возможные причины следующие:

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

Вы можете определить, приняла ли учетная запись условия использования данных клиента, запросив ресурс customer и проверив поле customer.offline_conversion_tracking_info.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, 30] .

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

  • Установка или обновление поля include_in_conversion_metrics в действии-конверсии приведет к ошибке 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 Действие-конверсия создано заново. Подождите не менее 6 часов после создания действия, прежде чем повторять неудачные конверсии.
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 . Обновите конверсию, чтобы использовать только один идентификатор клика, и убедитесь, что вы не объединяете несколько кликов в одну конверсию. Каждый клик имеет только один идентификатор клика.
VALUE_MUST_BE_UNSET Проверьте location ошибки GoogleAdsError , чтобы определить, какая из следующих проблем привела к ошибке.
  • ClickConversion имеет набор значений для gclid , а также по крайней мере одно из gbraid или wbraid . Обновите конверсию, чтобы использовать только один идентификатор клика, и убедитесь, что вы не объединяете несколько кликов в одну конверсию. Каждый клик имеет только один идентификатор клика.
  • ClickConversion имеет набор значений для gbraid или wbraid и значение custom_variables . Google Реклама не поддерживает пользовательские переменные для конверсий с идентификатором клика gbraid или wbraid . Удалите значение поля custom_variables преобразования.
Назад
Отчеты