Правила алертов

Правило алерта — это условие вида «если метрика упала ниже порога за окно, сделай действие». Например: «если ROI по ссылке меньше 0% за последние 2 часа при 300 кликах — уведомить в Telegram и выключить поток». Так вы не сидите у отчётов, а узнаёте о сливе вовремя.

Вкладка: Автоматизация → Правила алертов. Проверка условий идёт каждые 5 минут.

1. Конструктор правила — в одном диалоге задаются условие (метрика, оператор, порог, окно, разрез), минимальный размер выборки, действие и каналы. Фраза внизу диалога собирает правило словами, её удобно перечитать перед сохранением.

Метрики

Метрика	Что означает	Формула
ROI	Окупаемость	(доход − расход) / расход × 100%
CR	Конверсия в лид или продажу	(лиды + продажи) / клики × 100%
EPC	Доход на клик	доход / клики
Клики	Число кликов	количество
Конверсии	Конверсии без отклонённых	всего − отклонено
Доход	Выплаты подтверждённых конверсий	сумма, в базовой валюте
Расход	Затраты	ручные записи, если есть, иначе авто-цена клика
Ошибки постбеков	Неудачные исходящие постбеки в источник	число, не процент
Здоровье оффера	Подряд неудачных проверок оффера	число, не процент

Доход считается только по sale, rebill и upsell, как в отчётах. Ручной расход и авто-цена клика не складываются: если есть ручные записи, берутся они. Подробнее — в отчётах.

Оператор и порог

Операторы: меньше (<), меньше или равно (<=), больше (>), больше или равно (>=). Равно и не равно не предусмотрены.

Порог — число в единицах метрики. Для ROI и CR это проценты, для остальных метрик — абсолютное значение. Для «Здоровья оффера» и «Ошибок постбеков» порог — количество, а не процент.

Окно

• Время — минуты, часы или дни, например «за 2 часа».
• Клики — последние N кликов. Для «Расхода» берётся временной интервал, в который попали эти клики.

Разрез

Разрез	Что проверяется
Весь воркспейс	Все клики и конверсии
Ссылка	Одна ссылка
Оффер	Один оффер
Источник трафика	Один источник
Sub ID	Каждое значение параметра отдельно, например каждый sub_id_2

Для sub_id правило срабатывает отдельно по каждому значению и имеет свой cooldown. Так можно поймать один плохой креатив среди остальных.

Допустимые пары метрики и разреза

Метрика	Разрезы
ROI, CR, EPC, клики, конверсии, доход, расход	весь воркспейс, ссылка, sub_id
Ошибки постбеков	только источник трафика
Здоровье оффера	только оффер

Пара, которой нет в таблице, отклоняется при сохранении.

Действия

Действие	Что делает
Уведомить	Отправляет сообщение во все выбранные каналы.
Отключить поток	Выключает все потоки ссылки, включая принудительные и поток по умолчанию. Трафик уходит на основной URL ссылки. Требует разрез «ссылка».
Отключить оффер	Переводит оффер в статус auto_disabled с причиной «Disabled by alert rule». Требует разрез «оффер», то есть метрику «Здоровье оффера».

«Отключить поток» отключает всё

Действие не выбирает отдельный поток. Если у ссылки есть поток по умолчанию, после срабатывания трафик пойдёт на основной URL ссылки — возможно, на другой оффер. Включите потоки обратно вручную.

Минимальный размер выборки

Правило не срабатывает, пока выборка в окне меньше порога. Для ROI, CR, EPC, дохода и расхода выборка — число кликов. Для ошибок постбеков — число постбеков. Для здоровья оффера выборка всегда 1, поэтому ставьте минимум 1.

Без выборки правило «ROI меньше 50%» сработает на третьем клике и даст ложную тревогу.

Cooldown

Пауза между повторными уведомлениями по одному правилу (или одному значению sub_id). Например, cooldown 30 минут — не чаще одного уведомления в полчаса.

Каналы

Выберите один или несколько каналов. Настройка каналов — в каналах уведомлений. Правило не сохранится без канала, если вы не добавили хотя бы один канал.

Как выглядит уведомление

🚨 Alert: Низкий ROI на офферах
roi < 50 — actual: 37.2 (sample: 812)
Scope: {"type":"link","linkId":"…"}
Action: notify
Fired at: 2026-10-13T09:15:00.000Z

Права

Создавать и менять правила могут владелец, администратор и редактор. Наблюдатель видит список, но не меняет.

API

Правила: /api/v1/alerts/rules. Ручки для правил с API-ключом не открыты: используйте сессию (JWT).

Связанное

• Каналы уведомлений
• Вебхуки — событие alert_fired для своего сервера.
• Списки — автоматическая блокировка трафика, не связанная с алертами.