Настроить рабочее подключение к Amazon Ads API
Цель: нужно, чтобы данные по рекламе Amazon Ads (кампании, расходы, показы, клики, продажи и т.п.) стабильно тянулись по API в наш внешний инструмент (Google Sheets / БД / отчёт - уточним отдельно).
1. Контекст и текущая ситуация
Есть действующий Amazon Seller / Ads аккаунт и созданное приложение в Developer Console.
Сейчас подключение к Amazon Ads API не работает:
* при запросе профилей (profiles) приходит пустой массив [] — профиль рекламного кабинета не подтягивается;
* при подключении через существующее приложение была ошибка requested scopes not found;
* есть подозрение, что рекламный аккаунт некорректно привязан к приложению / не даны нужные права.Refresh token получается через ссылку вида:
https://www.amazon.com/ap/oa?client_id=...&scope=advertising::campaign_management&response_type=code&redirect_uri=http://localhost
но дальше цепочка авторизации до рабочего Profile ID не доведена.Все доступы (Client ID, Client Secret, Refresh Token, Developer ID, ссылка на Developer Console, доступ к тикет-системе поддержки) передадим отдельно.
2. Что нужно сделать
Проверить и правильно настроить приложение в Amazon Developer Console
* Убедиться, что указаны корректные scopes для Amazon Ads (advertising::campaign_management и др., если нужны).
* Проверить, что рекламный кабинет действительно привязан к приложению (через Amazon Advertising Console / Developer Console).
* При необходимости пере-создать приложение «с нуля» по best practices.Наладить корректный OAuth-флоу
* Настроить получение authorization code → access_token / refresh_token.
* Проверить, что refresh token рабочий и не устаревает каждые полчаса из-за ошибок в настройке.
* Документировать, какую именно ссылку и параметры мы должны использовать для обновления токенов.Получить рабочий Profile ID
* Добиться, чтобы запрос к /v2/profiles (или актуальному endpoint’у) возвращал список профилей, а не [].
* Выяснить и устранить причину, почему сейчас профиль не подтягивается (права, регион, неправильный аккаунт и т.п.).
* Зафиксировать нужный Profile ID и описать, как его повторно получить.Проверить доступ к Amazon Apps & Services
* При необходимости — сформулировать, какие права и роли нужно выдать на аккаунте, чтобы раздел Apps & Services → Develop Apps был доступен и всё корректно работало.
* Коротко описать, какие именно галочки/разрешения нужны от владельца аккаунта.Настроить базовую выгрузку отчётов Amazon Ads
* Реализовать пример запроса к Amazon Ads API (например, Sponsored Products / Sponsored Brands) с использованием полученного Profile ID.
* Получить и сохранить первый тестовый отчёт (хотя бы в JSON или CSV) по кампаниям за выбранный период.
* Описать, какие endpoints и параметры можно использовать дальше (чтобы мы могли развивать отчётность сами или с вашей помощью).
3. Что важно на выходе
На выходе нам нужен:
Рабочий API-доступ к Amazon Ads, который:
* корректно авторизуется;
* видит профиль(и) рекламного кабинета;
* позволяет запрашивать данные по рекламе.Мини-документация (коротко, по пунктам):
* где в Seller Central / Advertising Console что настроено;
* какие Client ID / Developer ID / scopes используются;
* как обновлять токены (шаги и пример запроса);
* пример запроса к Ads API (с curl или Postman);
* какие права нужны от владельца аккаунта.Понимание ограничений:
* если есть какие-то лимиты / ограничения по региону, типу аккаунта или политике Amazon — описать это.
Если для старта нужны ещё какие-то данные (конкретный стек, куда выводить отчёты, доступ к хостингу и т.п.) — отдельно перечисли, пожалуйста, что именно требуется.
