Предыдущий Search Ads 360 Reporting API выведен из эксплуатации. Теперь вы можете создавать свои отчеты с помощью нового Search Ads 360 Reporting API .
Обратите внимание, что методы get и getByCustomerId в Search Ads 360 Conversion API устарели в третьем квартале 2025 года. Чтобы продолжить доступ к данным о конверсиях, необходимо создать отчет с использованием ресурса конверсии с помощью нового Search Ads 360 Reporting API. Подробнее см. здесь.
Остальные функции API конверсий Search Ads 360 будут по-прежнему поддерживаться.
Устранение неполадок
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Если у вас возникли проблемы при использовании 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 для своей учетной записи. Убедитесь, что вы сделали следующее: Перейдите в консоль Google API . Выберите свой проект. Если вы еще не создали проект, см. раздел Создание проекта для клиента . На боковой панели слева разверните 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 не соответствует указанному типу конверсии. |
0x00000126 | Service internal error | Повторите запрос через некоторое время. Вероятно, это временная ошибка. Если ошибка не исчезнет, обратитесь в службу поддержки SA360. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-04-07 UTC.
[null,null,["Последнее обновление: 2025-04-07 UTC."],[[["\u003cp\u003eThis page provides troubleshooting information for common issues encountered while using the Search Ads 360 API, including authorization and conversion upload errors.\u003c/p\u003e\n"],["\u003cp\u003eIf the provided resources don't resolve your issue, contact support with specific information about your problem, including your Search Ads 360 and Google API Console credentials, code snippets, and JSON responses.\u003c/p\u003e\n"],["\u003cp\u003eThe page lists common authorization errors such as \u003ccode\u003eAccess Not Configured\u003c/code\u003e, \u003ccode\u003eInvalid grant\u003c/code\u003e, and \u003ccode\u003eInvalid client\u003c/code\u003e, with explanations and solutions.\u003c/p\u003e\n"],["\u003cp\u003eIt also includes a table of conversion upload errors, detailing their hexadecimal error codes, descriptions, and troubleshooting steps.\u003c/p\u003e\n"],["\u003cp\u003eFor report discrepancies, refer to the Response Codes and Standard Error Responses documentation and ensure the \u003ccode\u003eincludeRemovedEntities\u003c/code\u003e setting in your request matches the "Show removed" checkbox selection in the Search Ads 360 UI.\u003c/p\u003e\n"]]],["When troubleshooting the Search Ads 360 API, consult the provided resources. If issues persist, contact support, providing your Agency/Advertiser ID, Project Number, API access username, code snippet, and JSON response (including full error messages). Common authorization errors include `Access Not Configured`, `Invalid grant`, and `Invalid client`, often resolved by enabling the API, refreshing tokens, or naming your project. Conversion upload errors relate to invalid click IDs, Floodlight activity names, or custom dimensions/metrics. Ensure correct permissions and data consistency between UI and API.\n"],null,[]]
