Как получить токен Яндекс.Директа

Токен — ключ, по которому Nelvo читает кампании и счётчики вашего кабинета. Получается один раз за пару минут, только на чтение. Ниже — по шагам, ровно как выглядит интерфейс Яндекса сейчас.

1. Откройте oauth.yandex.ru и нажмите «+ Создать»
   Войдите под аккаунтом, в котором ведёте Директ (агентский или клиентский). Откроется раздел «Ваши приложения» — кнопка «+ Создать» справа сверху.
   скриншот: раздел «Ваши приложения» с кнопкой «+ Создать»
2. Выберите тип «Для доступа к API или отладки»
   В окне «Какое приложение хотите создать?» выберите Для доступа к API или отладки — второй вариант («доступ к API сервисов Яндекса, нет доступа к данным пользователей»). Затем — «Перейти к созданию».
   Не берите первый вариант «Для авторизации пользователей» — он для входа через Яндекс на чужом сайте, не для доступа к API.
   скриншот: окно выбора типа приложения, выбран «Для доступа к API»
3. Заполните карточку приложения
   • Название вашего сервиса — любое, например Nelvo доступ.
   • Почта для связи — уже подставлена ваша, оставьте.
   • Доступ к данным — кликните в поле «Название доступа», начните печатать и выберите:
     • «Использование API Яндекс.Директа» (direct:api);
     • затем снова кликните в это поле, введите «Метрика» и добавьте доступ к Яндекс.Метрике на чтение (получение статистики) — чтобы подтянулись счётчики и цели.
   • Redirect URI — уже стоит https://oauth.yandex.ru/verification_code и помечен «Нельзя изменить». Ничего не трогайте.
   Нажмите «Создать приложение».
   скриншот: форма создания с добавленными доступами Директ + Метрика
4. Скопируйте ClientID
   После создания откроется карточка приложения — там есть ClientID (длинная строка). Скопируйте его.
5. Получите токен (access_token)
   Откройте в браузере ссылку, заменив слова ВАШ_CLIENT_ID на скопированный ClientID (длинную строку из шага 4):
   https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENT_ID
   Нажмите «Войти» / «Разрешить» → Яндекс перекинет на страницу, где в адресной строке будет access_token=…. Скопируйте значение после access_token= (до символа &) — это и есть токен.
   Не оставляйте в ссылке буквы ВАШ_CLIENT_ID — это подсказка, а не значение. Если оставить, Яндекс ответит «400 — неизвестно приложение с таким client_id».
6. Примите соглашение API в Директе
   В Яндекс.Директе: Инструменты → Доступ к API → нажмите «Согласен» / «Принять».
   Главная грабля: без принятого соглашения Яндекс отклоняет любые запросы, даже с правильным токеном.
7. Вставьте токен в Nelvo
   В окне «Подключить кабинет клиента» вставьте токен и нажмите «Показать доступные аккаунты и счётчики». Появятся ваши клиентские аккаунты и счётчики — выберите нужные, затем отметьте цели (можно несколько).
   Токен хранится в зашифрованном виде и используется только для чтения вашего кабинета.