Списки

Списки — это автоматический фильтр трафика на редиректе. Чёрный список отсекает конкретные IP, страны, рефереры или значения sub_id. Белый список пропускает только перечисленное. Вкладка: Автоматизация → Списки.

1. Тип и измерение — колонки «Тип» и «Измерение». Фильтры по типу и измерению над таблицей.
2. Значение — то, что сравнивается с кликом.
3. Добавить в список — добавление одного или нескольких значений сразу.

Измерения

Измерение	Что сравнивается	Пример значения
Sub ID	Значение параметра sub_id_N. Имя параметра указывается отдельно.	sub1, trash_traffic
IP-адрес	IP клика: точный адрес, CIDR или маска.	192.0.2.1, 198.51.100.0/24
Referer	Домен реферера. Допустим * как маска.	spam-site.com, *.badnet.ru
Страна	Код страны ISO-2, сравнение без учёта регистра.	RU, UA

Для sub_id обязательно указать имя параметра, например sub_id_1. Без имени запись не сохранится.

Как работает блокировка

• Записи группируются по типу, измерению и имени параметра.
• Внутри чёрного списка клик блокируется, если совпал хотя бы с одним значением.
• Белый список требует совпадения: клик блокируется, если не попал ни в одно значение своей группы.
• Группы складываются по И: клик блокируется, если сработал хотя бы один чёрный список или не прошёл хотя бы один белый.

Что происходит с заблокированным кликом:

1. Обычные потоки (гео, устройство, A/B, ротация) пропускаются.
2. Принудительные потоки применяются как обычно.
3. Срабатывает поток по умолчанию. Если его нет, трафик идёт на основной URL ссылки.
4. Клик записывается в статистику, он не теряется.

Списки действуют только на ссылки с потоками

Фильтр применяется только к ссылкам, у которых есть правила роутинга. Ссылка без потоков списками не фильтруется, даже если в списке есть её IP.

Задержка до 5 минут

Списки кешируются в памяти процесса и обновляются раз в 5 минут. Добавленное значение может не сработать сразу.

Добавление значений

• Введите значения по одному в строке. Тип списка и измерение применяются ко всей пачке.
• Поле «Причина» необязательно. Она помогает через месяц понять, зачем добавляли.
• Система пропускает значения, которые уже есть в списке, и показывает сколько добавлено и сколько пропущено.
• Пакетная отправка принимает до 500 записей за запрос.

Удаление

Удаление записи — кнопка корзины в строке. Удалённое значение перестаёт блокироваться после обновления кеша, то есть в течение 5 минут.

Права

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

API

/api/v1/lists/entries — только с сессией (JWT). Ключи API сюда не допускаются. Список постранично: page и limit (до 200), поиск по подстроке значения через search.

Связанное

• Правила роутинга — без потоков списки не работают.
• Фильтрация ботов — автоматическая отсечка ботов, отдельно от списков.
• Правила алертов — автоматическое выключение потока по метрикам.