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

Фраза «не спеціалізується на окремих джерелах» і є відповіддю. База знає пошукових роботів і парсери, але не пристосована до перевірки реклами Meta, Google Ads або TikTok: підмережі AdsBot, краулери meta-externalads, мережі ByteDance, headless-перевірки без підпису. Для первинного відсіювання очевидних краулерів фільтра «Бот» достатньо, а для роботи із сірими вертикалями під конкретну рекламну мережу його доповнюють зовнішнім сервісом.
Списки ботів: що можна додати самостійно
Розділ «Списки ботів» у налаштуваннях трекера дає змогу додати до бази власні значення: окремі IP або CIDR-підмережі та сигнатури User-Agent. Там само є перемикачі: увімкнути додатковий внутрішній список UA ботів, увімкнути додатковий список 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 й відповідає, чи пройшов клік фільтр.

Модуль KLO для Keitaro влаштовано саме так: файл BoostRouter.php розміщується в каталозі фільтрів, у потоці з’являється фільтр BoostRouter, а всередині isPass модуль запитує рішення в KLO за даними кліку (IP, User-Agent, заголовки, параметри) та повертає його потоку. Тобто клоака стає звичайним фільтром потоку, а не окремим прошарком перед трекером.
Схема потоків із модулем KLO
- Завантажте модуль. У кабінеті KLO виберіть інтеграцію Keitaro: файл BoostRouter.php уже містить ваш секретний ключ.
- Покладіть файл до каталогу фільтрів Keitaro і переконайтеся, що в редакторі потоку з'явився фільтр BoostRouter.
- Потік «Офер». Фільтр BoostRouter у режимі «пропускати тих, хто пройшов перевірку» плюс ваші фільтри за гео, пристроями та параметром мітки. Дія: локальний лендинг або попереднє завантаження, щоб адреса не змінювалася.
- Потік «White» нижче у списку без фільтрів, як потік за замовчуванням: усе, що не пройшло, потрапляє сюди.
- Прогрівання. Для перших кліків нової кампанії встановіть ліміт кліків або розклад, за якого потік «Офер» ще не активний.
- Перевірте. Симуляція трафіку в Keitaro та відвідування з різних пристроїв, порядок у посібнику «Як перевірити клоаку».
Про дії потоку. Локальний лендинг і попереднє завантаження віддають сторінку з адреси трекера без зміни URL. Дія «перенаправлення» змінює адресу, і робот перевірки бачить два URL. Для VK Реклами перенаправлення прямо названо в правилах ознакою підміни, для решти мереж це просто зайвий слід.


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, картка не потрібна.
Почати безкоштовно