О сервисе Ads-Pilot
Ads-Pilot — SaaS-платформа для автоматизации контекстной рекламы в Яндекс Директ с использованием искусственного интеллекта. Сервис позволяет малому и среднему бизнесу запускать и оптимизировать рекламные кампании без специальных знаний в маркетинге.
1. Назначение сервиса
Ads-Pilot решает ключевую проблему малого бизнеса — сложность и дороговизну настройки контекстной рекламы. Наш AI-агент автоматизирует весь цикл работы с Яндекс Директом:
- Вводит сайт, бюджет и регион
- Нажимает «Запустить AI-агента»
- Через 10–15 минут реклама работает
- AI оптимизирует кампании 24/7
- Анализирует сайт и бизнес
- Подбирает ключевые слова
- Генерирует объявления
- Оптимизирует ставки по данным
Целевая аудитория: малый и средний бизнес (кафе, автосервисы, салоны красоты, интернет-магазины), маркетологи без опыта настройки Директа, предприниматели которым нужен результат без погружения в детали рекламы.
2. Интеграция с Яндекс Директ API
Сервис использует официальный API Яндекс Директ версии 5 для управления рекламными кампаниями от имени пользователей. Доступ осуществляется исключительно через механизм OAuth 2.0 с явного согласия пользователя.
2.1. Авторизация
Пользователь проходит OAuth 2.0 авторизацию через официальную страницу Яндекса. Полученный access_token шифруется алгоритмом AES-256-CBC и сохраняется в базе данных. Токен никогда не передаётся на клиентскую сторону (браузер).
2.2. Используемые методы API
2.3. Соблюдение лимитов API
| Лимит Яндекс Директ | Наша реализация | Статус |
|---|---|---|
| 10 запросов/сек | Rate limiter: максимум 8 запросов/сек | ✓ Соблюдается |
| 100 000 запросов/сутки | Все API-вызовы проходят через очередь BullMQ с приоритетами | ✓ Соблюдается |
| Заголовок объявления ≤ 35 символов | Валидация и обрезка после AI-генерации | ✓ Соблюдается |
| Текст объявления ≤ 81 символ | Строгая валидация длины перед загрузкой | ✓ Соблюдается |
2.4. Обработка ошибок API
| Код ошибки | Наше действие |
|---|---|
401 Unauthorized | Токен истёк — уведомляем пользователя, запрашиваем переавторизацию |
400 Bad Request | Валидация не прошла — логируем детали, уведомляем пользователя |
429 Too Many Requests | Exponential backoff: 1с → 2с → 4с → 8с, максимум 4 попытки |
500 Server Error | Повторяем 3 раза с интервалом, затем логируем и уведомляем |
3. Искусственный интеллект
Для генерации рекламных объявлений используется локальная AI-модель Gemma 2 (2B параметров), запущенная на наших серверах через Ollama. Данные о бизнесе пользователей не передаются во внешние AI-сервисы.
- Ключевые слова — 15 релевантных запросов на основе анализа бизнеса и региона
- Заголовки объявлений — 5 вариантов, строго до 35 символов каждый
- Тексты объявлений — до 81 символа с призывом к действию
- Минус-слова — для исключения нецелевого трафика
После генерации все тексты проходят постобработку: удаление emoji, markdown-разметки, проверка длины символов согласно требованиям Яндекс Директ.
4. Техническая архитектура
| Компонент | Технология | Назначение |
|---|---|---|
| Frontend | React 18 + TypeScript + Vite | Пользовательский интерфейс (SPA) |
| Backend | Node.js 20 + Fastify + TypeScript | API сервер, бизнес-логика |
| База данных | PostgreSQL 16 + Prisma ORM | Хранение данных пользователей и кампаний |
| Кэш / Очереди | Redis 7 + BullMQ | Фоновые задачи, оптимизация ставок |
| AI-модель | Gemma 2 (2B) via Ollama | Генерация объявлений локально |
| Web-сервер | Nginx + Let's Encrypt | HTTPS, проксирование, статика |
| Process manager | PM2 | Управление Node.js процессами |
| Сервер | VPS Ubuntu 24.04 (Россия) | Хостинг всех компонентов |
5. Безопасность
- HTTPS — все соединения зашифрованы (TLS 1.2+), сертификат Let's Encrypt.
- OAuth 2.0 — авторизация через Яндекс ID, пароли пользователей мы никогда не видим.
- Шифрование токенов — токены Яндекс Директ хранятся в БД зашифрованными (AES-256-CBC), ключ в переменных окружения сервера.
- JWT — сессии пользователей защищены JWT-токенами с TTL 7 дней.
- Rate limiting — ограничение количества запросов на все API endpoints.
- SQL-инъекции — невозможны благодаря использованию Prisma ORM с параметризованными запросами.
- CORS — настроен строго, разрешены только домены сервиса.
- Локальный AI — данные бизнеса не передаются сторонним AI-сервисам.
6. Тарифные планы
| Функция | Free | Pro (4 990 ₽/мес) | Business (24 990 ₽/мес) |
|---|---|---|---|
| Активные кампании | 1 | До 10 | Безлимит |
| Объявлений на кампанию | 3 | 10 | 50 |
| AI-оптимизация | Раз в сутки | Каждые 6 часов | Каждый час |
| Аналитика | Базовая | Детальная | Продвинутая + экспорт |
| Еженедельные PDF-отчёты | — | — | ✓ |
| Поддержка | Email + чат | Персональный менеджер |
7. Автономная оптимизация AI-агента
После запуска кампании AI-агент работает автономно в фоновом режиме. Все действия логируются и доступны пользователю в разделе «Действия AI».
Алгоритм оптимизации ставок
- Получение свежей статистики из Яндекс Директ API (метод reports.get)
- Анализ CTR и конверсий по каждому ключевому слову
- Применение правил: CTR < 0.5% более 3 дней → снизить ставку на 20%; CTR > 5% → повысить ставку на 15%; нет конверсий 7 дней → приостановить ключ
- Применение изменений через API (keywords.update)
- Запись действия в лог с объяснением причины
- Уведомление пользователя о выполненных изменениях