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

Если у вас возникли проблемы при использовании API Search Ads 360, просмотрите этот раздел по устранению неполадок.

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

  • Идентификатор агентства Search Ads 360 и идентификатор рекламодателя, к которому вы пытаетесь получить доступ.

  • Номер проекта из консоли Google API

  • Имя пользователя учетной записи Google, которую вы используете для доступа к API.
    Это аккаунт, которому предоставлено разрешение на доступ к Search Ads 360 ; это тот же аккаунт, который вы используете для настройки авторизации .

  • Фрагмент кода вашего запроса

  • JSON-ответ
    Если ответ представляет собой ошибку, обязательно укажите сообщение об ошибке, а не только цифровой код ошибки.

Ошибки авторизации

Вот некоторые часто встречающиеся ошибки авторизации:

Сообщение Описание

Access Not Configured. Please use Google API Console to activate the API for your project.

Эта ошибка возникает, если вы не включили API Search Ads 360 для своей учетной записи. Убедитесь, что вы сделали следующее:

  1. Перейдите в консоль Google API .

  2. Выберите свой проект. Если вы еще не создали проект, см. раздел Создание проекта для клиента .

  3. На боковой панели слева разверните API и аутентификация. Далее нажмите «API» . Убедитесь, что в списке API для Search Ads 360 API включен статус «ВКЛ» .

Invalid grant

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

sa360Api.py --login

Узнайте больше о рекомендуемом рабочем процессе для авторизации.

Invalid client
no application name

Эта ошибка возникает, если вы не указали название продукта при настройке проекта в консоли Google API. Чтобы исправить эту ошибку, введите название вашего продукта на экране согласия консоли Google API.

Другие виды ошибок авторизации

Обязательно используйте учетную запись Google, которой предоставлен доступ к Search Ads 360, когда вы входите в консоль Google API для получения своего идентификатора клиента и секретного кода клиента, а также при получении токена обновления.

Ошибки загрузки конверсий

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

Код ошибки Сообщение Описание
0x00000101

Click ID ' {ID} ' is not found

Идентификатор клика, указанный вами в запросе update недействителен. Повторно загрузите конверсии после выполнения следующих действий:

  • Проверено, что идентификатор клика был создан за 6 часов до загрузки конверсий.

  • Активировали службу конвертации API .

  • Если вы связываете конверсии с конкретными посещениями , подождите не менее 6 часов после посещения, прежде чем загружать конверсию. Поисковая реклама 360 может не распознать идентификатор клика посещения, если вы загрузите его раньше, чем через 6 часов после посещения. В редких случаях вам может потребоваться подождать до 24 часов, прежде чем Search Ads 360 сможет распознать идентификатор clickId.

  • Подтверждено, что клик получен из действительного источника, как указано в параметре gclsrc .

  • Подтверждено, что вы указали правильного рекламодателя в столбце AdvertiserId .

  • Подтверждено, что ваш идентификатор клика был создан в течение последних 90 дней.

0x0000010E Floodlight activity name ' {name} ' is not found

Название действия Floodlight, указанное в столбце segmentationName , неверно или еще недоступно. Если вы видите эту ошибку, проверьте наличие следующих распространенных проблем:

  • Имена чувствительны к регистру, поэтому убедитесь, что ваш запрос точно соответствует регистру.
  • Убедитесь, что в названии действия Floodlight нет непечатаемых символов Юникода или двойных пробелов.
  • Убедитесь, что вы указали название действия Floodlight , а не столбца Floodlight .
  • Убедитесь, что действие Floodlight существует для рекламодателя, указанного в столбце advertiserId . (Возможно, вы указали не того рекламодателя.)
  • После создания или изменения действия Floodlight подождите пару часов, прежде чем загружать конверсии для этого действия.
0x00000115 Custom dimension ' {name} ' is not found

Убедитесь, что указанная вами пользовательская переменная Floodlight настроена как параметр (а не показатель) для рекламодателя, связанного с идентификатором clickId , criterionId или productGroupId , который вы приписываете для конверсии.

0x00000116 Custom metric ' {name} ' is not found

Убедитесь, что указанная вами пользовательская переменная Floodlight настроена как метрика (а не параметр) для рекламодателя, связанного с идентификатором clickId , criterionId или productGroupId , который вы приписываете для конверсии.

0x0000011A The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}

Кто-то уже загрузил конверсию для той же области действия и идентификатора конверсии рекламодателя, указанного в столбце conversionId .

«Идентификатор конверсии рекламодателя» – это идентификатор, который вы создаете. Поисковая реклама 360 требует, чтобы этот идентификатор был уникальным для определенной области действия. Идентификатор конверсии Search Ads 360 генерируется Search Ads 360 и гарантированно будет уникальным.

0x0000011B Advertiser conversion ID ' {ID} ' is not found

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

0x0000011D User does not have permission to view advertiser {advertiser ID}

У аккаунта Google, который использует ваш клиент, нет разрешения на просмотр рекламодателя, указанного в запросе.

При входе в консоль API Google для получения идентификатора и секрета клиента, а также при получении токена обновления обязательно используйте учетную запись Google, которой предоставлен доступ к указанному вами рекламодателю.

0x0000011F Advertiser conversion ID is already specified in this request

Для двух или более конверсий в запросе указана одна и та же область действия и идентификатор конверсии рекламодателя.

Идентификатор конверсии рекламодателя – это идентификатор, который вы создаете и указываете в столбце conversionId . Поисковая реклама 360 требует, чтобы этот идентификатор был уникальным для определенной области действия.

0x0000011E The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)

Указанный вами идентификатор или название действия Floodlight не соответствует указанному типу конверсии.

Коды ответов отчетов и сообщения об ошибках

Если вы запрашиваете отчет и получаете сообщение об ошибке, см. Коды ответов в Search Ads 360 API и стандартные ответы об ошибках для получения дополнительной информации об ошибке.

Данные в пользовательском интерфейсе Search Ads 360 не соответствуют отчету, возвращаемому API.

Данные в пользовательском интерфейсе Search Ads 360 должны соответствовать данным, возвращаемым API по умолчанию. Если вы установили для includeRemovedEntities значение true в запросе отчета, убедитесь, что флажок «Показать удаленные» также установлен в пользовательском интерфейсе .