html Клоака й Keitaro: фільтр «Бот», списки ботів і модуль KLO у потоках трекера | BoostRouter KLO
EN Увійти
Keitaro

Клоака й Keitaro: фільтр «Бот», списки ботів і модуль KLO

У Keitaro є власний фільтр ботів і списки IP та User-Agent, і багато хто починає з них. Розбираємо за документацією трекера, що цей фільтр уміє, чого не вміє, як улаштовано механізм власних фільтрів і як підключити KLO модулем, щоб рішення про білу сторінку або офер ухвалювалося прямо в потоці.

Оновлено 22 вересня 20265 хв читання983 словаBoostRouter KLO

Для багатьох медіабаєрів Keitaro є і трекером, і першою клоакою: у потоках кампанії є фільтр «Бот», а в налаштуваннях можна завантажити власні списки IP та User-Agent. Майже всі ставлять собі запитання: чи вистачить цього, чи потрібен зовнішній сервіс. Відповідь є в документації самого Keitaro, і ми розберемо її за пунктами, а потім покажемо, як KLO вбудовується в потоки модулем, щоб рішення ухвалювалося всередині трекера.

Що вміє фільтр «Бот» у Keitaro

У документації Keitaro фільтр «Бот» описано коротко: це фільтр за базою ботів трекера, база загального призначення й не спеціалізується на окремих джерелах, у ній зібрано краулерів, парсерів і дані про пошукових ботів. Режим «Так» пропускає до потоку бот-кліки, режим «Ні» пропускає кліки, не визначені як боти.

Документація Keitaro: фільтр «Бот» працює за загальною базою трекера, яка не спеціалізується на окремих джерелах
Документація Keitaro: база фільтра «Бот» спільна, без спеціалізації за рекламними мережами.

Фраза «не спеціалізується на окремих джерелах» і є відповіддю. База знає пошукових роботів і парсери, але не пристосована до перевірки реклами Meta, Google Ads або TikTok: підмережі AdsBot, краулери meta-externalads, мережі ByteDance, headless-перевірки без підпису. Для первинного відсіювання очевидних краулерів фільтра «Бот» достатньо, а для роботи із сірими вертикалями під конкретну рекламну мережу його доповнюють зовнішнім сервісом.

Списки ботів: що можна додати самостійно

Розділ «Списки ботів» у налаштуваннях трекера дає змогу додати до бази власні значення: окремі IP або CIDR-підмережі та сигнатури User-Agent. Там само є перемикачі: увімкнути додатковий внутрішній список UA ботів, увімкнути додатковий список IP ботів, вважати порожній User-Agent ознакою бота, увімкнути список спам-ботів і пропускати бот-трафік під час оновлення витрат.

Документація Keitaro: списки ботів, додавання IP та CIDR, сигнатур User-Agent, налаштування ознак ботів
Документація Keitaro: власні списки IP та User-Agent доповнюють базу.

Усі три перемикачі щодо додаткових списків і порожнього User-Agent варто ввімкнути одразу. Порожнього UA у реального користувача не буває. Але ручні списки мають межу: підмережі рекламних мереж змінюються, Google, наприклад, датує свої файли діапазонів та оновлює їх, а вручну підтримувати актуальність сотень префіксів неможливо. До того ж списки нічого не знають про мітки кліку, гео кампанії та поведінку.

Інші фільтри потоку, які працюють на клоаку

Окрім «Бота», у потоках Keitaro є фільтри, які самостійно перевіряють частину ознак.

Фільтр KeitaroЩо дає для клоаки
Країни, Регіони, МістаГео з таргетингу кампанії: відвідування з інших країн на білу сторінку.
Типи пристроїв, Операційні системи, БраузериМобільна кампанія не має пропускати комп’ютер на офер.
Провайдери, IP-фільтр, ПроксіХостинги, дата-центри та відомі проксі на white.
ПараметрВимога мітки кліку: gclid, fbclid, yclid, ttclid, msclkid або власний параметр.
Реферери, Порожній реферерВідповідність джерела переходу.
УнікальністьПовторні відвідування одного користувача.
Ліміт кліків, РозкладПрогрів: перші кліки нової кампанії на білу сторінку за розкладом або лімітом.

Зібрати з них зв’язку можна, і для білих вертикалей цього вистачає. Бракує двох речей: актуальної бази мереж і сигнатур під конкретні рекламні системи та поведінкового шару. Саме їх додає зовнішній фільтр.

Як влаштовані власні фільтри в Keitaro

Keitaro дає змогу розробникам додавати фільтри. За документацією додатковий фільтр є PHP-класом у каталозі /var/www/keitaro/var/filters/, що успадковує AbstractFilter і реалізує три методи: getModes повертає режими фільтра (прийняти або відхилити), getTemplate віддає HTML налаштувань із ng-model="filter.payload", а isPass отримує StreamFilter і RawClick й відповідає, чи пройшов клік фільтр.

Документація Keitaro: створення нового фільтра, клас у var/filters, методи getModes, getTemplate та isPass
Документація Keitaro: власний фільтр є класом із методом isPass.

Модуль KLO для Keitaro влаштовано саме так: файл BoostRouter.php розміщується в каталозі фільтрів, у потоці з’являється фільтр BoostRouter, а всередині isPass модуль запитує рішення в KLO за даними кліку (IP, User-Agent, заголовки, параметри) та повертає його потоку. Тобто клоака стає звичайним фільтром потоку, а не окремим прошарком перед трекером.

Схема потоків із модулем KLO

  1. Завантажте модуль. У кабінеті KLO виберіть інтеграцію Keitaro: файл BoostRouter.php уже містить ваш секретний ключ.
  2. Покладіть файл до каталогу фільтрів Keitaro і переконайтеся, що в редакторі потоку з'явився фільтр BoostRouter.
  3. Потік «Офер». Фільтр BoostRouter у режимі «пропускати тих, хто пройшов перевірку» плюс ваші фільтри за гео, пристроями та параметром мітки. Дія: локальний лендинг або попереднє завантаження, щоб адреса не змінювалася.
  4. Потік «White» нижче у списку без фільтрів, як потік за замовчуванням: усе, що не пройшло, потрапляє сюди.
  5. Прогрівання. Для перших кліків нової кампанії встановіть ліміт кліків або розклад, за якого потік «Офер» ще не активний.
  6. Перевірте. Симуляція трафіку в Keitaro та відвідування з різних пристроїв, порядок у посібнику «Як перевірити клоаку».

Про дії потоку. Локальний лендинг і попереднє завантаження віддають сторінку з адреси трекера без зміни URL. Дія «перенаправлення» змінює адресу, і робот перевірки бачить два URL. Для VK Реклами перенаправлення прямо названо в правилах ознакою підміни, для решти мереж це просто зайвий слід.

Кабінет KLO, крок 2 майстра: вибрано тип підключення Keitaro
Крок 2 майстра: тип підключення Keitaro, доступний із тарифу PROFIT.
Документація в кабінеті KLO: установлення фільтра Keitaro у три кроки
Документація в кабінеті: завантажити BoostRouter.php, перейти в Потоки, Фільтри, Завантажити PHP-фільтр, налаштувати потік.

Keitaro за Cloudflare: справжній IP

Якщо домен трекера проксіюється через Cloudflare, Keitaro за замовчуванням може бачити IP вузла Cloudflare замість IP відвідувача. Тоді й фільтр «Бот», і зовнішній модуль оцінюватимуть не відвідувача, а Cloudflare. Перевірте, що трекер відновлює справжню адресу із заголовка CF-Connecting-IP: у звіті за кліками IP мають бути з мереж операторів, а не з діапазонів Cloudflare. Ту саму проблему ми розглядали в шаблоні інтеграції KLO для Keitaro, із версії 1.3.0 справжня IP-адреса передається коректно.

Поширені запитання

Чи можна зробити клоаку лише засобами Keitaro

Частково. Фільтр «Бот» і списки відсікають очевидних краулерів, фільтри за гео, пристроями, параметрами та реферером охоплюють ще частину ознак. За документацією база фільтра загальна й не спеціалізується за джерелами, тому для Meta, Google чи TikTok на сірих вертикалях трекер доповнюють зовнішнім фільтром.

Як підключити KLO до Keitaro

Завантажити модуль BoostRouter.php із кабінету, розмістити в каталозі фільтрів Keitaro, додати фільтр BoostRouter до потоку з офером і зробити потік із білою сторінкою потоком за замовчуванням.

Чи потрібно змінювати лендинги під час переходу на модуль

Ні. Лендинги залишаються локальними або на попередньому завантаженні, змінюється лише набір фільтрів у потоках.

Що робити, якщо Keitaro бачить IP Cloudflare

Увімкнути відновлення справжнього IP із заголовка CF-Connecting-IP у трекері й перевірити у звіті за кліками, що адреси відвідувачів належать до мереж операторів, а не до Cloudflare.

Які налаштування у «Списках ботів» увімкнути одразу

Додатковий список User-Agent ботів, додатковий список IP ботів і «Порожній User Agent вважати ознакою бота». Список спам-ботів теж варто ввімкнути, якщо ви не працюєте з трафіком, на якому він дає хибні спрацьовування.

Перевірте зв’язку на своєму трафіку

KLO відсіює ботів, модераторів і шахрайський трафік до показу офера. Пробний період 3 дні з повним функціоналом тарифу START, картка не потрібна.

Почати безкоштовно

Читайте також

УСІ

Усі посібники з клоакінгу

П’ятнадцять матеріалів про джерела трафіку, інтеграції та основи: біла сторінка, перевірка зв’язки, ціни.