Скилл Яндекс Директ в Aizor: как подключить API v5 и управлять рекламой

Что даёт скилл Яндекс Директ в Aizor

Официальное описание скилла от команды Aizor: управление рекламой в Яндекс Директе через API V5: кампании, группы, объявления, ключевые фразы, ставки и статистика. Вы ставите задачу обычными словами, агент обращается к Директу от вашего имени.

Скилл полезен маркетологу, владельцу небольшого бизнеса с собственной рекламой и специалисту, который ведёт несколько аккаунтов. Рутину вроде выгрузки отчётов, проверки ставок и остановки объявлений удобно отдать агенту. Что такое Aizor, читайте на странице «Что такое Aizor».

Что понадобится

• Аккаунт на Яндексе и логин в Яндекс Директе. По документации запросы идут от имени представителя бизнеса, агентства или клиента агентства.
• Хотя бы одна кампания, созданная в веб-интерфейсе Директ Про: без неё страница «Настройки API» недоступна.
• Приложение в Яндекс OAuth с доступом «Использование API Яндекс Директа» (direct:api) и одобренная заявка на доступ к API.
• Установленный Aizor (приложение для macOS и Windows) и скилл из каталога.

Если агентство дало клиенту доступ в веб-интерфейс только на чтение, то и через API этот представитель сможет только получать данные. Если есть право редактирования, он сможет управлять кампаниями и через API.

Как получить ключ API: по шагам

1. Войдите на Яндекс под логином, с которого будете работать. Откройте страницу создания приложения в Яндекс OAuth и выберите пункт «Для доступа к API или отладки».
2. Заполните название сервиса (любое), почту для связи и в поле «Доступ к данным» добавьте «Использование API Яндекс Директа» (direct:api). Нажмите «Создать приложение». Яндекс покажет ClientID и Client secret.
3. Откройте в Директе страницу «Настройки API» и вкладку «Мои заявки». При первом входе примите пользовательское соглашение. Нажмите «Новая заявка», выберите свой ClientID, укажите актуальную почту и точные сведения о приложении, подтвердите согласие и нажмите «Отправить».
4. Дождитесь решения. Срок рассмотрения до 7 дней, статус виден на той же вкладке. Если заявку отклонили, там же будут причины, заявку можно исправить.
5. После одобрения получите токен: войдите на Яндекс, откройте ссылку https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENTID и подтвердите доступ. Яндекс покажет токен, скопируйте его.

Документация советует зарегистрировать в Директе отдельного представителя для приложения и получить токен для него. Срок жизни токена числом в документации не указан, она лишь перечисляет случаи отзыва токена (о них ниже).

В Aizor установите скилл Яндекс Директ из каталога и вставьте токен в его настройки. Подробности по тарифам и каталогу смотрите в разделе о тарифах.

Проверка: первые запросы агенту

• «Покажи список моих кампаний Директа и их статусы» (только чтение).
• «Выведи статистику по кампаниям за прошлую неделю» (только чтение).
• «Покажи ключевые фразы и текущие ставки в этой кампании» (только чтение).
• «Приостанови это объявление» (изменение, включите подтверждение вручную).

Сценарии автоматизации

Утренняя сводка по рекламе

Агент по расписанию берёт статистику кампаний и присылает короткий итог в чат или в Telegram. Планировщик задач в Aizor нужен именно для таких повторяющихся дел.

Проверка ставок и фраз

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

Остановка и запуск объявлений

Закончилась акция или товар: вы просите приостановить группу объявлений, а после возобновить. Агент выполняет это через API без захода в кабинет.

Подготовка новых групп

Вы даёте список фраз и тексты, агент создаёт группу и объявления. Создание и правки расходуют баллы, а для новых кампаний полезно сначала отработать запрос в песочнице.

Частые ошибки

Что видите	Причина	Что делать
Ошибка с кодом 53	В запросе указан неверный токен	Проверьте токен в настройках скилла, при необходимости получите новый
Токен перестал работать	Сменили пароль, нажали «Выйти на всех компьютерах», отозвали доступ приложения или истёк срок токена	Получите токен заново по ссылке авторизации
Запросы не проходят, хотя токен верный	Не одобрена заявка на доступ или не принято соглашение на странице «Настройки API»	Проверьте статус на вкладке «Мои заявки»
Запросы отклоняются из-за нагрузки	Закончились баллы или больше пяти одновременных запросов	Подождите: лимит делится на 24 часовых интервала. Не запускайте много задач сразу
Запросы не проходят с вашего компьютера	В «Настройках API» включено ограничение по IP-адресу	Добавьте нужный адрес в список разрешённых или уберите ограничение

Про баллы подробнее. В ответе на каждый запрос Директ возвращает заголовок Units: сколько баллов потрачено, сколько осталось и каков суточный лимит. Баллы списываются и за успешные вызовы, и за ошибочные. За ошибку вызова метода документация называет 20 баллов.

Песочница работает по адресу api-sandbox.direct.yandex.com. Это отдельная среда с тестовыми данными: у неё нет веб-интерфейса, а данные хранятся месяц с последнего обращения.

Безопасность

• Токен даёт доступ к вашей рекламе. Не отправляйте его в чаты и не вставляйте в общие документы.
• Заведите в Директе отдельного представителя под агента, как советует документация. Для задач «только смотреть» дайте ему права на чтение.
• Остановку кампаний, смену ставок и любые изменения оставьте под ручным подтверждением в Aizor.
• Если токен мог попасть в чужие руки, отзовите доступ приложения в настройках Яндекс ID, а затем получите новый токен.
• При необходимости ограничьте доступ к API по IP-адресу в «Настройках API».

Инструкция написана по официальной документации Яндекс Директа (yandex.ru/dev/direct, раздел «API версии 5»), состояние на октябрь 2026 года. Интерфейс кабинета и условия могут измениться. Автор Aizorlab участвует в партнёрской программе Aizor.