Аккаунты фильтрации

Аккаунты фильтрации - это подключение внешнего сервиса, который отделяет живых людей от ботов. Идея простая: реальный человек видит ваше приложение (PWA), а бот - «белую» страницу. Так «сырой» трафик и боты не попадают на само предложение. Подключается сервис один раз в разделе INTEGRATIONS → Filter Accounts, а дальше выбирается в форме PWA на вкладке General в поле Filter Account.

Как устроен список

Раздел открывается таблицей подключённых аккаунтов. Сверху - поле поиска, справа кнопки фильтров и колонок, обновление и зелёная кнопка Add (о поповерах фильтров и колонок - в разделе «Интерфейс»). Столбцы таблицы:

• ID - внутренний номер аккаунта.
• Name - название, под которым вы завели аккаунт.
• Type - тип сервиса фильтрации.
• Created At - дата добавления.
• Primary - метка основного аккаунта.
• Actions - меню «⋮» для каждой строки: редактировать или удалить.

Список постраничный - по 100 записей на страницу.

Основной аккаунт

Основным (Primary) может быть только один аккаунт - его система берёт по умолчанию, когда для конкретного PWA фильтр-аккаунт явно не выбран. Переключить основной можно прямо в списке, кликнув по метке в колонке Primary.

Основной аккаунт защищён от случайного отключения: его нельзя удалить через Actions - сначала назначьте основным другой аккаунт. Точно так же нельзя снять метку Primary с единственного основного аккаунта - в системе всегда должен оставаться хотя бы один основной.

Добавление аккаунта

Кнопка Add открывает окно New Filter Account. Заполните поля:

1. Name - понятное название, чтобы вы узнавали аккаунт в списке и в форме PWA.
2. Type - сервис фильтрации: Adspect, TrafficArmor или FraudFilter (см. ниже).
3. Ключи сервиса - набор полей зависит от типа, под каждым полем подсказка, где взять значение.
4. Primary - переключатель: сделать этот аккаунт основным.

Внизу окна - Cancel и Save. Нажмите Save, чтобы сохранить аккаунт. Если сервис отклонил ключ, панель подсветит поле с ошибкой.

Тип сервиса

У каждого PWA в сервисе фильтрации есть свои правила: у Adspect это поток (Stream), у TrafficArmor и FraudFilter - кампания (Campaign). Аккаунт подключается один раз, а поток или кампания выбирается в форме PWA, рядом с фильтр-аккаунтом. Так один аккаунт обслуживает много PWA, у каждого - свои правила.

Adspect

adspect.ai. Поле API Key необязательное:

• с ключом - в форме PWA потоки выбираются из списка, а кнопка + создаёт новый поток, настроенный под приложение;
• без ключа - ID потока вписывается вручную, его видно в кабинете Adspect.

TrafficArmor

Поля:

• API Key - необязательный. С ним кампании выбираются из списка и создаются кнопкой + прямо из формы PWA, а ключ кампании панель подставит сама. Где взять: TrafficArmor → Dashboard → API.
• Campaign key (_ta_campaign_key) - обязателен, только если API Key не указан. Где взять: TrafficArmor → Dashboard → API → TA Campaign Key.

Без API Key ID кампании вписывается в форме PWA вручную.

Настройки кампании TrafficArmor

Кампания, созданная кнопкой +, уже настроена как нужно. Если заводите кампанию в кабинете TrafficArmor сами, выключите в ней Hybrid Mode и JavaScript-тесты: посетитель проверяется с сервера, и с ними фильтр не сработает.

FraudFilter

Единственное поле - Token (X-FF-JS-TOKEN), оно обязательное. Где взять: кампания в FraudFilter → Integration → Process clicks → вкладка API.

Кампании FraudFilter создаются только в их кабинете, а в форме PWA ID кампании вписывается вручную.

Открыть поток или кампанию в сервисе

Для Adspect и для TrafficArmor с API Key рядом с выбранным потоком или кампанией в форме PWA есть кнопка, которая открывает его в кабинете сервиса: там правятся страны и правила фильтрации.

Где потом выбрать аккаунт

Сохранённый аккаунт появляется в форме PWA на вкладке General в поле Filter Account. Подробнее про саму форму приложения - в разделе «PWA-приложения». Общую подготовку к работе описывает раздел «Требования и подготовка».

Без фильтра всё считается ботом

Система работает по принципу fail-closed: если для PWA не настроен фильтр-аккаунт, ключ сервиса неверный или сервис не ответил, все посетители считаются ботами и видят «белую» страницу. Это защита, а не ошибка - она не даёт «сырому» трафику попасть на предложение, пока фильтрация не подключена и не проверена. Поэтому настройте аккаунт фильтрации заранее, до запуска трафика.