Платформа
Яндекс Директ
Кампании, статистика, ставки и контролируемые изменения в рекламе.
Яндекс Директ
Приложение Яндекс Директ подключает рекламный аккаунт к Promto. Агент читает кампании, объявления, группы и ключевые фразы, строит отчёты по расходам и после вашего подтверждения может остановить или возобновить кампанию, изменить бюджет или ставки.
Назначение
Директ помогает:
- собрать расходы, показы, клики, CTR и среднюю цену клика;
- сравнить кампании и периоды;
- найти неэффективные ключевые фразы и объявления;
- проверить статусы, модерацию и дневные бюджеты;
- подготовить рекомендации по перераспределению средств;
- выполнить согласованное изменение в рекламном аккаунте.
Подключение
Подключить или отключить Директ может владелец рабочего пространства.
- Откройте Яндекс Директ → Настройки.
- Нажмите Получить код подтверждения.
- На странице Яндекса войдите под аккаунтом, в котором ведутся нужные кампании.
- Введите код и разрешите доступ к API Директа.
- Дождитесь появления списка кампаний.
Для ручного подключения создайте приложение Яндекс OAuth с правом direct:api, укажите ClientID, получите OAuth-токен и вставьте его в Promto. Client secret не требуется.
Если токен принадлежит агентскому аккаунту, в ручной форме дополнительно укажите Client-Login рекламодателя. Доступ к API Директа должен быть одобрен на стороне Яндекса.
Интерфейс
На Главной доступны сценарии расходов, эффективности, ключевых фраз, объявлений, бюджетов и сравнения периодов.
В Настройках отображаются:
- состояние подключения и маска токена;
- Client-Login для агентского доступа;
- кампании, их ID, тип, состояние, статус, валюта и дневной бюджет;
- ошибка отозванного токена;
- кнопка отключения.
Возможности агента
Основной агент использует promto_direct.
| Задача | Действия |
|---|---|
| Кампании | list_campaigns, get_campaign |
| Структура рекламы | list_adgroups, list_ads, list_keywords |
| Статистика | report |
| Управление | suspend_campaign, resume_campaign, update_budget, set_bids |
| Дополнительные сервисы API | request |
Для отчёта агент указывает период и нужные поля. Отчёт готовится на стороне Директа и может выполняться заметно дольше обычного чтения. Денежные значения Promto возвращает в единицах валюты аккаунта, а не в микросуммах API.
Сценарии
Отчёт по расходам
Попросите собрать кампании за 30 дней, отсортировать их по расходу и показать показы, клики, CTR и среднюю цену клика.
Найти неэффективные кампании
Агент сопоставит расход с кликами и доступными конверсиями, выделит проблемные кампании и сначала предложит изменения без их применения.
Проверить и изменить бюджет
Агент получает текущий дневной бюджет и статус кампании, показывает точное старое и новое значение и выполняет изменение только после вашего явного согласия.
Ограничения и безопасность
- Остановка, запуск, изменение бюджета и ставок влияют на живой рекламный аккаунт и реальные расходы.
- Перед каждой операцией проверьте ID кампании, текущее состояние, валюту и точное новое значение. Не подтверждайте пакет несвязанных изменений одним сообщением.
- Агент должен сначала получить существующие ID через
list_campaigns, а не угадывать их. - Отчёт может ожидать подготовки на стороне Директа; не запускайте одинаковые отчёты подряд без необходимости.
- Набор конверсий зависит от настроенных целей и доступных полей отчёта.
- При ограничении частоты запросов нужно дождаться указанного времени.
- OAuth-токен хранится на сервере, не передаётся агенту и не должен попадать в чат, логи или файлы.
Если что-то не работает
Кампании не появились. Проверьте, что вошли под нужным рекламным аккаунтом. Для агентского аккаунта используйте ручное подключение и заполните Client-Login.
Яндекс сообщает о незавершённой регистрации. Дождитесь одобрения доступа к API Директа в аккаунте Яндекса.
Нет прав на изменение. Проверьте право direct:api и полномочия подключённого пользователя для конкретного рекламодателя.
Отчёт готовится долго. Это нормально для офлайн-отчёта. Дождитесь результата и только затем решайте, нужен ли повтор.
Токен истёк или отозван. Отключите Директ и подключите аккаунт заново.