Фильтры потока

Фильтры решают, какой трафик попадёт в поток. Они настраиваются в окне Настройки потока на вкладке Фильтры. Поток без условий принимает весь трафик.

Как добавить условие

1. Откройте кампанию на вкладке Потоки.
2. Нажмите + Поток или кнопку с шестерёнкой в карточке существующего потока.
3. Перейдите на вкладку Фильтры.
4. Нажмите + Условие. Появится строка с полем Гео, оператором в списке и пустым полем значений.
5. Выберите поле и оператор.
6. Впишите значения через запятую.
7. Если условий несколько, выберите между соседними И или ИЛИ. По умолчанию стоит И.
8. Нажмите Сохранить поток.

В карточке потока каждое условие показано меткой вида «Гео: US, CA»; у потока без условий написано «без фильтров — весь трафик». Лишнее условие удаляется кнопкой × справа от строки.

Общие правила

• Условие — это поле, оператор и список значений через запятую. Пробелы вокруг запятых не учитываются.
• Сравнение в операторах в списке, не в списке, = и ≠ идёт без учёта регистра: chrome и Chrome — одно и то же.
• Если значение у клика не определилось (страна неизвестна, реферера нет), условие в списке не выполняется, а не в списке выполняется.
• Условие с пустым списком значений и оператором в списке или = не выполняется никогда. С оператором не в списке или ≠ оно выполняется всегда.
• Условия действуют в потоках любого типа. Замыкающий поток с условиями получит только те клики, которые им соответствуют.
• Расписание и состояние потока проверяются раньше фильтров: выключенный поток и поток вне расписания трафик не получает.
• У вернувшегося посетителя с привязкой фильтры привязанного потока повторно не проверяются.

Операторы

Особенности regex:

• Синтаксис RE2: просмотр вперёд и обратные ссылки не поддерживаются.
• Регистр учитывается. Для поиска без учёта регистра начните выражение с (?i).
• Выражение ищется в любой части значения. Для точного совпадения поставьте ^ в начале и $ в конце.
• В форме панели запятая разделяет значения, поэтому выражение с запятой будет разбито на два.
• Выражение с ошибкой не совпадает ни с чем.
• Для поля IP / CIDR оператор regex не работает — поток не сохранится.

Логика И / ИЛИ

Переключатель И / ИЛИ стоит между соседними условиями. ИЛИ объединяет соседние условия в группу, И начинает новую группу. Поток подходит, если в каждой группе выполнено хотя бы одно условие.

Пример. Три условия подряд:

Гео в списке US, CA
        И
ОС в списке iOS
       ИЛИ
Браузер в списке Chrome

Получается «Гео И (ОС ИЛИ Браузер)»: поток получит клики из США и Канады, у которых ОС — iOS либо браузер — Chrome.

Чтобы убедиться, что условия собраны верно, нажмите Проверить поток на вкладке Потоки. В колонке Условия по порядку видно, выполнено ли каждое условие, см. Проверка выбора потока.

Поля условий

В списке поля доступны 14 вариантов. Подсказка в пустом поле значений показывает формат: US, CA для гео, подсеть для IP, false для бота и прокси.

Гео

Страна посетителя по гео-базе. Значения — двухбуквенные коды стран: US, CA, DE.

Регистр не важен: введённые значения переводятся в верхний регистр. Это касается и выражений regex, поэтому страны перечисляйте операторами в списке и не в списке.

Рядом с полем значений есть список Гео-профиль…. Выберите профиль — его страны добавятся к уже введённым. Профили настраиваются отдельно, см. Гео-профили.

В кампании с клоакой список разрешённых стран берётся из условий Гео денежных потоков, см. Потоки для клоаки.

Устройство

Тип устройства по User-Agent. Значения: mobile, tablet, desktop, unknown.

ОС

Название операционной системы по User-Agent. Примеры значений: Windows, Android, iOS, macOS, Linux, ChromeOS.

Браузер

Название браузера по User-Agent. Примеры значений: Chrome, Safari, Firefox, Edge, Opera, Samsung Browser, Facebook App, Instagram App, TikTok App.

Язык

Первый язык из заголовка Accept-Language, без кода региона и в нижнем регистре: для en-US,en;q=0.9 это en. Примеры значений: en, de, ru.

Коннект

Тип соединения по базе IP2Proxy. Значения: hosting (дата-центр), vpn, tor, proxy. У обычного соединения и при неподключённой базе значение пустое.

ISP

Провайдер посетителя. Название дают базы IP2Location и IP2Proxy; без них значение пустое. Название пишется так, как оно записано в базе. Если точное название неизвестно, используйте regex: (?i)telecom.

Регион

Регион посетителя по гео-базе. Название — как в базе, например California.

Город

Город посетителя по гео-базе. Название — как в базе, например Berlin.

IP / CIDR

IP-адрес посетителя. В одном списке можно смешивать три формата:

• точный адрес: 203.0.113.10;
• маска со звёздочкой по октетам IPv4: 203.0.113.*;
• подсеть в формате CIDR: 203.0.113.0/24.

С оператором в списке или = условие выполнено, если адрес подошёл под любое значение. С не в списке или ≠ — если не подошёл ни под одно.

Реферер

Заголовок Referer целиком, вместе с https:// и путём. Чтобы отобрать переходы с одного сайта, используйте regex: example\.com.

sub_id_1

Значение параметра sub_id_1 клика. Учитывается и значение, которое пришло через токены источника.

Бот

Значение — true или false. Бот определяется по User-Agent, по типу соединения hosting (дата-центр) и по вашим бот-листам.

Прокси / ДЦ

Значение — true или false. true — соединение через дата-центр, прокси, VPN или Tor. Тип соединения даёт база IP2Proxy; без неё значение всегда false.

Защита потока без клоаки

В кампании с включённой клоакой ботов отсекает она, а дата-центры, прокси и VPN — при включённом флажке Блокировать дата-центры / прокси / VPN. Без клоаки добавьте в денежный поток два условия, соединённые И:

1. Бот = false.
2. Прокси / ДЦ = false.

Клики, которые не прошли эти условия, получит другой подходящий поток или замыкающий.

Дополнительные поля через API и импорт

Эти поля нельзя выбрать в списке, но можно задать через API или импорт потока. В форме такое условие показывается с кодом вместо названия и сохраняется без изменений.

Частые ошибки

неизвестный тип или оператор фильтра

Поток не сохраняется, если в условии указано поле, которого трекер не знает, или оператор regex выбран для IP / CIDR. После двоеточия в сообщении стоит код поля, например ip. Для IP / CIDR замените оператор на в списке и перечислите адреса, маски или подсети.

Поток с условием «Гео» не получает трафик

Проверьте, что в поле значений вписаны коды стран. Условие в списке с пустыми значениями не пропускает никого. Если коды вписаны, проверьте гео-базу: без неё страна клика не определяется.

Условие по коннекту или «Прокси / ДЦ» не срабатывает

Тип соединения определяется только при подключённой базе IP2Proxy. Её состояние видит владелец установки: Настройки → Боты и гео, блок IP2Proxy, строка Состояние.

Трафик уходит в 404

Клик не подошёл ни одному потоку. Добавьте поток с типом Замыкающий без условий и проверьте распределение кнопкой Проверить поток.