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

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

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

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

  • Номер проекта из Google API Console.

  • Имя пользователя аккаунта Google, который вы используете для доступа к API.
    Это аккаунт, которому предоставлен доступ к Поисковой рекламе 360. Он же используется для настройки авторизации.

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

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

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

Ниже приведены некоторые распространенные ошибки авторизации.

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

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

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

  1. Войдите в Google API Console.

  2. Выберите проект. Если вы ещё не создали проект, узнайте, как это сделать.

  3. На боковой панели слева разверните раздел APIs & auth (API и аутентификация). Затем нажмите API. Убедитесь, что в списке API для Search Ads 360 API установлен статус ВКЛ.

Invalid grant

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

sa360Api.py --login

Подробнее о рекомендуемом рабочем процессе авторизации…

Invalid client
no application name

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

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

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

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

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

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

Click ID '{ID}' is not found

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

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

  • Активировали сервис конверсий API.

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

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

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

0x00000106 Either a click ID or keyword ID is required

Для конверсии не указано, с чем она связана. Укажите столбец clickId или столбцы customerId, campaignId, adGroupId и criterionId, которые идентифицируют ключевое слово.

0x0000010C Either of Floodlight activity ID or Floodlight activity name is required

Укажите segmentationType: "FLOODLIGHT" и действие Floodlight в столбце segmentationName или segmentationId.

При редактировании конверсии, зарегистрированной Поисковой рекламой 360 с помощью тега Floodlight, для идентификации конверсии требуется действие Floodlight.

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

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

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

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

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

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

0x00000119 A conversion ID or advertiser conversion ID is required to modify an existing conversion

В запросе update не указан столбец conversionId. conversionId, чтобы указать, какую конверсию нужно изменить. Подробнее о прекращении поддержки dsConversionId…

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

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

Идентификатор конверсии рекламодателя создается вами. В Поисковой рекламе 360 этот идентификатор должен быть уникальным для заданной области применения. Идентификатор конверсии Поисковой рекламы 360 создается в Поисковой рекламе 360 и гарантированно является уникальным.

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

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

  • Убедитесь, что в столбце conversionId указан правильный идентификатор. Для конверсий, загруженных через API, это значение conversionId, которое вы указали при вставке конверсии. Для конверсий, зарегистрированных с помощью тегов Floodlight, это идентификатор заказа Floodlight.
  • Убедитесь, что conversionTimestamp – это временная метка существующей конверсии в миллисекундах по UTC. Временная метка, преобразованная из местного часового пояса или указанная в секундах, а не в миллисекундах, не соответствует существующей конверсии.
  • Если конверсии регистрируются с помощью тегов Floodlight, убедитесь, что вы указали действие Floodlight в столбце segmentationName или segmentationId и что конверсия произошла в течение последних 28 дней.
0x0000011D User does not have permission to view advertiser {advertiser ID}

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

При входе в Google API Console для получения идентификатора клиента и секретного кода клиента, а также при получении токена обновления используйте аккаунт 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 не соответствует выбранному типу конверсии.

0x00000124 Conversion timestamp is before click timestamp

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

0x00000125 Conversion age is older than the max supported age

Ваш запрос update содержит попытку изменить конверсию, которая была совершена слишком давно. Конверсии, зарегистрированные Поисковой рекламой 360 с помощью тегов Floodlight, можно изменять только в течение 28 дней после conversionTimestamp.

0x00000126 Service internal error

Повторите попытку позже. Скорее всего, это временная ошибка. Если ошибка не исчезнет, обратитесь в службу поддержки Поиска 360.

0x00000129 Invalid customer ID: {ID}

Поисковой рекламе 360 не удалось найти идентификатор клиента, указанный в столбце customerId. Укажите идентификатор клиента в новом интерфейсе Поисковой рекламы 360 для клиентского аккаунта, в котором содержится ключевое слово, например 123-456-7890.

0x0000012C Cannot find this keyword ID in Search Ads 360.

Поисковой рекламе 360 не удалось найти ключевое слово, указанное в столбцах customerId, campaignId, adGroupId и criterionId. Убедитесь, что все четыре идентификатора являются идентификаторами нового интерфейса Поисковой рекламы 360 и что ключевое слово относится к указанной группе объявлений, кампании и клиентскому аккаунту.

0x0000012E Please provide the full set of new Search Ads 360 IDs: {missing ID}

Для конверсии, связанной с ключевым словом, необходимо указать customerId, campaignId, adGroupId и criterionId. В сообщении будет указан отсутствующий идентификатор. Подробнее о том, как приписать конверсию только ключевому слову…

0x0000012F Editing a click ID older than 60 days is not supported.

В запросе update указан параметр clickId, который был создан более 60 дней назад. Данные можно изменить только для конверсий, которые были выполнены за последние 60 дней.

0x0000013C Conversion editing using integer DS conversion ID is deprecated. Please use conversion ID instead.

В вашем запросе update указан устаревший столбец dsConversionId или в столбце conversionId передан идентификатор конверсии Поисковой рекламы 360. Вместо этого идентифицируйте конверсию по ее идентификатору конверсии рекламодателя. Подробнее о прекращении поддержки dsConversionId…

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

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

Данные в интерфейсе Поисковой рекламы 360 не совпадают с данными в отчете, полученном через API

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