Скрипты
Раздел Скрипты — это ваши собственные программы на JavaScript, которые Qubix запускает по расписанию или по кнопке. Скрипт получает доступ к данным объявлений через встроенный набор команд (SDK QubixApp), может ставить объявления на паузу, включать их обратно, выполнять read-only запросы к базе Qubix (команда sql), обращаться к внешним сервисам и хранить своё состояние между запусками.
Скрипты хорошо подходят, когда стандартных правил автопаузы Britva уже недостаточно: нужна нестандартная логика, вызов внешнего API или вычисления, которые трудно выразить условием.
Чем скрипты отличаются от Britva
И Britva, и Скрипты автоматизируют работу с объявлениями, но решают разные задачи.
| Britva (правила автопаузы) | Скрипты | |
|---|---|---|
| Как описывается логика | JavaScript-условие над одним объявлением (checkAd) → действие (пауза/возврат) | Свободный JavaScript-код |
| Кому подходит | Автопауза/возврат объявлений по условию на метрику | Нестандартные сценарии, своя логика |
| Запросы к базе | Да, read-only SQL (команда sql, при включении в системных настройках) | Да, read-only SQL к базе Qubix (команда sql) |
| Внешние сервисы | Нет | Да, запрос к внешнему API |
| Память между запусками | Нет | Да, своё состояние |
| Порог входа | Ниже: только условие (его может написать AI-ассистент) | Выше: целая программа (AI-ассистент может помочь) |
Если задача выражается простым условием «если ROAS ниже порога — поставить на паузу», начните с правил автопаузы Britva — это быстрее и понятнее. Скрипты используйте там, где нужна логика, которую правило выразить не может.
Список скриптов
Главный экран раздела — таблица всех ваших скриптов с колонками:
- Имя — имя скрипта (если не задано, показывается короткий идентификатор).
- Расписание — когда скрипт запускается автоматически, читаемой фразой (например, «Каждые 5 минут»). Прочерк означает, что расписание не задано, скрипт запускается только вручную.
- Статус — галочка, если скрипт активен; прочерк, если выключен.
- Последний запуск — время и результат последнего выполнения.
Кнопка + Создать скрипт в правом верхнем углу открывает редактор нового скрипта. Клик по строке таблицы открывает существующий скрипт для редактирования.