User agent filter

streams.md

@@ -131,7 +131,7 @@ https://tracker.test/lander/index.php?subid={zoneid}
 
 Для каждого клика рекламная сеть заменит этот макрос `{zoneid}` фактическим номером зоны, из которой пришел клик,
 а далее трекер извлечет его из кликовой ссылки для сбора статистики. В данном примере `subid` является параметром
-ссылки, в котором содержится номер зоны. Если вы укажете `subid` в поле "Sub ID" в потоке, то сможете получать
+ссылки, в котором содержится номер зоны. Если вы укажете `subid` в поле «Sub ID» в потоке, то сможете получать
 статистику по каждой отдельной зоне в потоке. Это может быть очень полезным для сбора черных списков зон с высокой
 плотностью ботов.
 
@@ -169,6 +169,51 @@ https://tracker.test/lander/index.php?subid={zoneid}-{platform}
 должен быть отфильтрован. Включайте настройку только в том случае, если ваш рекламный формат так или иначе основан
 на мобильных приложениях.
 
+## Фильтр user agent
+
+Эта настройка позволяет вам указать собственное [Perl-совместимое регулярное выражение (PCRE)](http://www.pcre.ru/docs/perl/text/intro/)
+для фильтрации посетителей по их [строке user agent](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/User-Agent).
+Сравнение производится с учетом регистра символов. По умолчанию поиск вхождения производится в любой части строки
+user agent; вы можете использовать якоря `^` и `$` для привязки шаблона к началу или концу строки (см. примеры ниже).
+
+Синтаксис PCRE очень богатый и мощный и находится за рамками данной документации. Отдельные выражения могут быть
+объединены с помощью различных синтаксических конструкций, что позволяет создавать сколь угодно сложные шаблоны,
+однако обратите внимание, что в текущей реализации длина регулярного выражения не может превышать 1023 символа.
+
+Несколько примеров:
+
+```
+Firefox|Nexus|Miui
+```
+
+Это выражение совпадет с любым user agent, который содержит слова «Firefox», «Nexus» или «Miui». Его можно
+использовать для фильтрации посетителей с Mozilla Firefox, Google Nexus и встроенного браузера Xiaomi.
+
+```
+^Mozilla/4[.]0
+```
+
+Это выражение совпадет с любым user agent, который начинается с «Mozilla/4.0». Оно отфильтрует всех подозрительных
+посетителей, которые якобы используют очень старые браузеры, но тем не менее поддерживают современные конструкции
+JavaScript (подразумевается тем, что посетитель смог сформировать машинный отпечаток.)
+
+```
+^Mozilla/5[.]0$
+```
+
+Это выражение отфильтрует тех посетителей, чей user agent строго совпадает с «Mozilla/5.0», то есть не содержит
+сведений о конкретном бразуре, HTML-движке и платформе, что очень необычно и подозрительно.
+
+Все выражения выше могут быть объединены в одно с использованием логического «или» (т.е. совпадет первое *или* второе
+*или* третье) следующим образом:
+
+```
+Firefox|Nexus|Miui|^Mozilla/4[.]0|^Mozilla/5[.]0$
+```
+
+**Будьте осторожны! Неправильно сформированное регулярное выражение может привести к ошибочным срабатываниям
+и фильтрации больших объемов хорошего трафика. Используйте эту настройку только если вы точно знаете что делаете.**
+
 ## Черный список IP
 
 Это черный список IP-адресов, которым всегда будет показана белая страница. Поддерживаются адреса IPv4 и IPv6, но