html JS-клоака, PHP-лоадер, SDK, Worker і .htaccess: чим відрізняються способи підключення фільтра | BoostRouter KLO
EN Увійти
Способи підключення

JS-клоака, PHP-лоадер, SDK, Worker та .htaccess: чим відрізняються способи підключення

Один і той самий фільтр можна підключити до сайту п'ятьма способами, і від вибору залежить, що побачить робот у вихідному коді сторінки, скільки часу займе рішення й чи витримає зв'язка кешування. Розбираємо кожен спосіб чесно, з його слабкими місцями.

Оновлено 22 вересня 20266 хв читання1159 слівBoostRouter KLO

Клоака є не файлом і не скриптом, а рішенням: кому біла сторінка, кому офер. Файл або скрипт лише спосіб доставити це рішення на ваш сайт. Від способу залежать три речі: де саме ухвалюється рішення, що робот перевірки побачить у вихідному коді сторінки та як зв'язка витримає кешування й особливості хостингу. Нижче п'ять варіантів, якими підключають KLO, і один, яким підключають «клоаку власноруч».

Зведена таблиця

СпосібДе ухвалюється рішенняЩо робот бачить у вихідному кодіКому підходитьТариф KLO
PHP-лоадерНа сервері до передавання HTMLЛише HTML білої сторінкиЗвичайні лендинги на хостингу з PHPSTART
Зворотна PHP-інтеграціяНа сервері, з боку сторінки офераWhite, якщо зайшов безпосередньо на оферЗахист прелендингу й офера від прямих відвідуваньSTART
SDKУ застосунку на Node.js або у фреймворкуЛише відрендерена біла сторінкаReact, Vue, Next.js, Nuxt, Remix, SvelteKit, FastifySTART
JS-фільтрУ браузері відвідувача після завантаження HTMLHTML white плюс сам скрипт фільтраСайти без доступу до PHP: конструктори, чужий хостингPROFIT
Модуль Keitaro, плагін WordPressУсередині трекера або CMSЛише HTML білої сторінкиТі, у кого трафік уже проходить через Keitaro або сайт працює на WordPressPROFIT
Cloudflare WorkerНа межі мережі до хостингуЛише HTML білої сторінки, на хостингу файлів немаєБудь-який стек, максимальна прихованістьDOMINATION
.htaccess і власні спискиНа сервері за статичними спискамиЛише HTML білої сторінки, але списки застаріваютьБілі вертикалі, перевірка ідеїБезкоштовно

PHP-лоадер: стандарт для лендингів

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

Що важливо: рішення ухвалюється до того, як сервер надіслав перший байт HTML. Робот отримує готову білу сторінку й не бачить у вихідному коді ні офера, ні ознак фільтра. Це ж робить PHP-лоадер стійким до перевірки «покажіть вихідний код сторінки», яку часто роблять вручну.

Є лише одне слабке місце: потрібен хостинг із PHP і доступ до файлів. На конструкторах сайтів і чужих платформах лоадер не встановити.

Зворотна PHP-інтеграція: захист офера з іншого боку

У кабінеті KLO поряд із прямою інтеграцією є зворотна, з тим самим файлом index.php. Логіка дзеркальна: файл установлюється з боку сторінки, яку потрібно захистити, прелендингу або офера. Якщо на неї заходять напряму, оминаючи вхідну адресу кампанії, без мітки кліку та з ознаками перевірки, файл віддає білу сторінку. Так закривається поширений сценарій: адреса офера потрапила назовні через спай-сервіс або спільний доступ у кабінеті, і її почали відкривати напряму.

SDK для застосунків на JavaScript

Якщо сайт написано на React, Vue, Next.js, Nuxt, Remix, SvelteKit або він працює на Node.js із Fastify, файлу index.php у вас немає. Для таких проєктів KLO надає пакет @boostclicks/klo з готовими адаптерами. Він встановлюється через npm, а рішення запитується на стороні сервера під час рендерингу: адаптер уже враховує IP відвідувача, мітки та вибраний спосіб доставки офера. Робот, як і у випадку з лоадером, отримує лише відрендерену white.

Кабінет KLO, крок 2 майстра: вибрано SDK для React, Vue, Next.js та Node.js
Крок 2 майстра: SDK, завантажувати файл не потрібно, токен і код показано на картці кампанії.

Про фреймворки з клієнтським рендерингом. Якщо застосунок повністю рендериться в браузері, рішення має ухвалюватися на сервері, що віддає перший HTML, інакше логіка потрапляє в клієнтський код. SDK для Next.js і Nuxt працює саме на серверній стороні.

JS-фільтр: коли PHP недоступний

JS-фільтр: це скрипт, який додається на сторінку й працює вже в браузері відвідувача: збирає ознаки, зокрема виконання JavaScript, розміри екрана, cookies та поведінку, запитує рішення й за ним завантажує офер. Його перевага в тому, що його можна встановити будь-де, навіть на конструкторі без доступу до сервера, а також додати поведінкові ознаки, яких немає в серверного рішення.

Кабінет KLO, крок 2 майстра: вибрано тип підключення JavaScript
Крок 2 майстра: JavaScript, фільтр підключається тегом script.

Недоліки принципові. Робот отримує HTML, у якому видно сам скрипт фільтра. Рішення ухвалюється після завантаження сторінки, а не до нього. Робот без виконання JavaScript просто побачить white, що добре, але робот із виконанням JavaScript побачить і роботу скрипту. Тому JS-фільтр правильно використовувати як другий шар поверх серверного рішення або як єдиний варіант там, де сервера немає. Для VK Реклами JS-варіант із перенаправленням на інший домен не підходить: правила VK прямо називають переадресацію ознакою підміни.

Модуль Keitaro та плагін WordPress

Обидва варіанти вбудовують рішення туди, де трафік уже обробляється: у потік трекера або в WordPress до передавання теми. Для робота вони не відрізняються від PHP-лоадера: у вихідному коді лише біла сторінка. Докладно розглянуто в окремих статтях: клоака й Keitaro, клоака для WordPress.

Cloudflare Worker: рішення до хостингу

Worker виконується на серверах Cloudflare ще до того, як запит дістався вашого сервера. Він запитує рішення в KLO та віддає білу сторінку чи офер за тією самою адресою, а на хостингу немає ні лоадера, ні модулів, ні коду клоаки. Підходить до будь-якого стеку й особливо зручний, коли доменів багато: один Worker і маршрути для кожного домену. Подробиці, ліміти Cloudflare та налаштування кешу в статті про Worker.

.htaccess і клоака власноруч

Найстаріший спосіб: списки IP та User-Agent у .htaccess або в PHP-умові на лендингу. Запит від відомого робота отримує білу сторінку, решта офер. Безкоштовно й повністю під контролем. Але таке рішення має три системні проблеми, які не подолати старанністю.

  • Списки застарівають. Google публікує діапазони IP роботів у датованих файлах і змінює їх. Meta, ByteDance, Яндекс розширюють мережі. Список, зібраний пів року тому, пропускає частину перевірок.
  • Немає ознак, крім IP та UA. Перевірка без підпису зі звичайного браузера в хмарі проходить будь-який статичний список.
  • Немає статистики. Ви не дізнаєтеся, хто пройшов на офер і чому, доки не отримаєте блокування.

Для білих вертикалей, де ціною помилки є відхилене оголошення, .htaccess допустимий. Для сірих, де ціною помилки є акаунт з історією, підписка дешевша. Розрахунок у статті про ціни на клоаку.

Як вибрати

  1. Є хостинг із PHP і звичайний лендинг: PHP-лоадер.
  2. Сайт на React, Vue, Next.js або Node.js: SDK.
  3. Трафік уже проходить через Keitaro: модуль Keitaro, за потреби плюс Worker на домені білої сторінки.
  4. Сайт на WordPress: плагін із вимкненим кешуванням сторінок на вхідних адресах.
  5. Конструктор або чужий хостинг без PHP: JS-фільтр з урахуванням його обмежень.
  6. Потрібно, щоб на сервері не було слідів фільтра, або доменів багато: Cloudflare Worker.

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

Що таке JS-клоака

Фільтр, який працює в браузері відвідувача після завантаження сторінки: збирає ознаки й підвантажує офер за рішенням сервісу. Встановлюється на будь-який сайт, але робот із виконанням JavaScript бачить сам скрипт, тому JS-фільтр краще використовувати як другий шар поверх серверного.

Чим PHP-лоадер кращий за JS-фільтр

Рішення ухвалюється до віддавання HTML, і робот отримує лише білу сторінку без слідів фільтра у вихідному коді. JS-фільтр ухвалює рішення після завантаження й видимий у коді.

Чи можна зробити клоаку через .htaccess

Можна, за списками IP та User-Agent. Але списки застарівають, ознак, окрім IP та UA, немає, статистики немає. Для сірих вертикалей такий варіант дорожчий за підписку через блокування.

Що таке зворотна PHP-інтеграція

Той самий файл index.php, встановлений на стороні сторінки офера або прелендингу: пряме відвідування без мітки та з ознаками перевірки отримує white.

Який спосіб входить до пробного періоду KLO

Пробний період надає функціонал START: PHP-лоадер, зворотну PHP-інтеграцію та SDK. JS-фільтр, Keitaro й WordPress входять до PROFIT, Cloudflare Worker до DOMINATION.

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

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

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

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

УСІ

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

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