Клоака працює лише тоді, коли стоїть перед вашою сторінкою: відвідувач прийшов за рекламним посиланням, фільтр перевірив візит і вирішив, що показати — офер чи White Page. Поки код не встановлено, жодне налаштування потоку не діє: боти, сканери й спай-сервіси бачать те саме, що й покупець, а ви платите за їхні кліки. Тому підключення клоаки — перший технічний крок після створення потоку, і до нього варто поставитися уважно. Якщо сервіс ще не вибрано, почніть зі статті купити клоаку: що перевірити перед покупкою.
Де живе сайт, коли ви підключаєте клоаку
Поширена помилка новачків — думати, ніби сервіс фільтрації забирає лендинг до себе, а в рекламу йде якась чужа адреса. В ArtisanClo це не так. Сайт лишається у вас: ваш хостинг, ваш домен, ваші файли. На сторінку ставиться маленький код або файл, а все інше — перевірка візиту, оцінка довіри, вибір напрямку — відбувається на боці сервісу. Чим така хмарна схема відрізняється від саморобного скрипту, розібрано в статті хмарна клоака чи скрипт клоаки.
Звідси дві практичні речі:
- у рекламний кабінет іде адреса вашого сайту, а не посилання на сторонній домен;
- за доступність лендингу, SSL-сертифікат і швидкість хостингу відповідаєте ви — фільтр не виправить повільний сервер.
Якщо ви лише знайомитеся з темою, спершу прочитайте, що таке клоака і який шлях проходить клік — так буде зрозуміліше, чому код має спрацьовувати раніше за все інше на сторінці.
Два способи підключення: порівняння
Вікно підключення відкривається з меню потоку: Потоки → рядок потоку → Ще → Підключення. Там перелічено способи, згорнуті в картки; розгорнутий водночас лише один. Одного способу на потік достатньо. Робочий спосіб позначається зеленим і плашкою «Встановлено».
| JS-тег | PHP-файл | |
|---|---|---|
| Де спрацьовує | У браузері відвідувача | На вашому сервері, до віддачі сторінки |
| Що потрібно | Доступ до <head> сторінки |
Хостинг із PHP 7.2 або новішим |
| Залежить від блокувальників і порядку завантаження | Так | Ні |
| Режим «Трекер» і тіньовий режим | Фільтрує як звичайна клоака | Працюють |
| White Page кодом відповіді (403/404) | Не може змінити код відповіді | Працює |
| Оновлення | Не потрібне | Файл сам не оновлюється, потрібна свіжа версія |
Коротко: тег швидше поставити, файл надійніший. Налаштування фільтрації при цьому ті самі: вони зберігаються в потоці, а не в коді на сайті, і спосіб підключення можна змінити, не чіпаючи потоку.
JS-клоака: підключення тегом
JS-тег — це один рядок скрипту, який ви вставляєте в розмітку лендингу. Поки рішення не надійшло, тег ховає сторінку, а якщо рішення немає — веде відвідувача на White Page.
Встановлення JS-тегу покроково
- У вікні Підключення розгорніть спосіб «JS-тег» і скопіюйте код.
- Вставте його першим рядком у
<head>— на кожній сторінці лендингу, а не лише на головній. - Збережіть файл або опублікуйте сторінку й оновіть її в браузері.
- Натисніть Перевірити інтеграцію: кабінет сам відкриє сторінку і знайде на ній код.
Чого не можна робити з тегом
- Не підключайте код через Google Tag Manager чи інший менеджер тегів. Вони запускають скрипти пізніше, і сторінка встигає показатися всім, зокрема ботам і спай-сервісам, ще до рішення.
- Не додавайте
asyncабоdefer— з тієї самої причини. - Не ставте код нижче за інші скрипти: аналітика, пікселі й віджети мають іти після нього.
Порада. Якщо скрипт тегу не завантажиться — наприклад, його ріже мережа або блокувальник на сервері, — сторінка не сховається, і офер побачать боти й спай-сервіси. Тому після кожної правки сайту знову натискайте «Перевірити інтеграцію».
Обмеження тегу
Тег працює в браузері, а отже, не може змінити код відповіді сервера (докладніше — у статті серверна клоака). Якщо White Page налаштовано в режимі «Код відповіді (200/403/404)», то з JS-тегом на місці лендингу залишиться порожня сторінка. Режим «Трекер» і тіньовий режим на тегу теж не діють: потік із тегом фільтрує трафік як звичайна клоака.
PHP-клоака: підключення файлом на сервері
PHP-файл — спосіб для сайтів на хостингу з PHP. Рішення ухвалюється на сервері ще до того, як браузер отримає бодай один байт сторінки, тому цей спосіб не залежить від блокувальників реклами і швидкості завантаження скриптів.
Встановлення PHP-файлу покроково
- У вікні Підключення натисніть Завантажити PHP-файл.
- Покладіть файл у корінь лендингу під назвою
index.php. - Свій лендинг перейменуйте, наприклад на
offer.php. - У картці офера потоку вкажіть нову адресу лендингу, наприклад:
https://ваш-сайт.com/offer.php
- Натисніть Перевірити інтеграцію — кабінет перевірить, що файл відповідає.
Виходить така схема: реклама веде на ваш-сайт.com, там відвідувача зустрічає index.php, запитує рішення і показує або offer.php, або White Page.
Оновлення PHP-файлу
Файл на сервері сам не оновлюється. Коли виходить нова версія, у вікні підключення з’являється плашка «Доступна нова версія PHP-файлу» зі списком того, чого не вміє ваша поточна. Завантажте файл заново і замініть старий. Свіжа версія потрібна, наприклад, для готової White Page з каталогу, правил «Параметри посилання офера» і перевірки живої взаємодії.
Водночас після правки налаштувань потоку перезаливати файл не потрібно: налаштування не зберігаються у файлі, вони живуть у кабінеті й застосовуються з наступного візиту.
Що потрібно від хостингу
- PHP 7.2 або новіший;
- дозволені вихідні HTTPS-запити (файлу треба зв’язатися із сервісом);
- розширення curl або ввімкнений
allow_url_fopen.
Файл чекає на відповідь до 4 секунд. Якщо зв’язку немає, він протягом доби обслуговує візити за останньою відповіддю: відвідувачів із міткою рекламного кліку веде на офер, решту — на White Page. Візит, що прийшов раніше за найпершу відповідь, отримає помилку 503.
WordPress: плагін замість ручного встановлення
Якщо лендинг зроблено на WordPress, файли можна не чіпати: плагін встановлюється з адмінки і працює тим самим серверним способом. Він доступний із тарифу Professional; у пробному періоді сайт підключають JS-тегом або PHP-файлом. Покрокове встановлення, робота з кешем і типові помилки розібрані в окремій статті — клоака для WordPress.
Якщо ж трафік у вас іде через трекер, ArtisanClo вбудовується і туди — про це в матеріалах Keitaro і клоака та Binom і клоака. Список підтримуваних трекерів — у розділі інтеграції з трекерами.
Як перевірити, що клоаку підключено
Кнопка Перевірити інтеграцію дає одну з трьох відповідей:
| Відповідь перевірки | Що означає |
|---|---|
| «Підключення знайдено на вашій сторінці» | Усе гаразд |
| «Сторінка відкрилася, але цей спосіб підключення на ній не відповів» | Код не знайдено або він стоїть не на тій сторінці |
| «Не вдалося відкрити вашу сторінку» | Сайт або хостинг не пустив перевірку — це ще не означає, що підключення не працює |
Перевіряти можна раз на 20 секунд. Зважайте, що перевірка скидає попередні позначки «Встановлено» і «Підключення активне» — вони повернуться з першим же візитом. Під способом видно «Активне зараз» або дату останньої активності.
Після цього зробіть живу перевірку:
- Відкрийте рекламне посилання потоку у вікні інкогніто.
- Зайдіть у Журнал кліків — візит має з’явитися з рішенням і причиною.
- Якщо хочете самі побачити офер, додайте свою адресу в Білий список IP на кроці 4 потоку (кнопка «Додати мій IP»).
Порада. Повторний захід з тієї самої адреси й браузера протягом хвилини склеюється з попереднім кліком. Якщо тестового переходу немає в журналі, зачекайте хвилину або зайдіть з іншого пристрою.
Якщо в журналі візит має причину «Візит до початку фільтрації», значить, у потоку ввімкнено прогрів: перші кліки бачать White Page без перевірок, і білий список тут не допоможе. Докладніше про те, як читати причини, — у статті чому клік пішов на White Page.
Помилки під час підключення клоаки
Більшість звернень «клоака не працює» зводиться до п’яти ситуацій.
Сторінку бачать усі, навіть боти
Майже завжди винен кеш: плагін кешування, кеш хостингу або CDN віддають збережену копію сторінки замість того, щоб запитати рішення для кожного відвідувача. Виключіть лендинг із кешування, очистьте кеш і перевірте в інкогніто.
Сторінка блимає до рішення
Тег підключено через менеджер тегів, з async/defer або він стоїть не першим рядком. Перенесіть його на самий верх <head>.
Усі візити мають той самий IP
Перед сайтом стоїть проксі хостингу, і PHP-файл бачить адресу проксі замість адреси відвідувача. Попросіть хостинг передавати справжню адресу (налаштування real IP або mod_remoteip). Доки це не виправлено, фільтр оцінює не людей, а ваш сервер.
Хостинг відповідає 403
Захисний фільтр хостингу (WAF, ModSecurity) сприймає запити сторінки перевірки як атаку. Додайте адресу лендингу у винятки або попросіть підтримку хостингу вимкнути фільтр для цього сайту.
PHP-файл відповідає 503 або сторінка довго вантажиться
Сервер не може достукатися до сервісу: заборонено вихідні з’єднання або немає curl. Перевірте версію PHP і мережеві дозволи.
Повний розбір несправностей із порядком перевірки — у статті клоака не працює: як перевірити й полагодити.
Підключення і швидкість лендингу
Будь-який фільтр додає до завантаження сторінки час на рішення, тож баєри слушно запитують, чи не втратять вони конверсію на швидкості. Кілька практичних міркувань:
- Тег ховає сторінку до надходження рішення. Що раніше він завантажиться, то коротша пауза, — ще одна причина ставити його першим рядком.
- PHP-файл запитує рішення із сервера. Тут важить зв’язок вашого хостингу із зовнішнім світом: дешевий перевантажений хостинг сповільнить і лендинг, і перевірку.
- Мінімальний час на сторінці і перевірка живої взаємодії навмисно додають очікування. Вмикайте їх там, де суворість виправдана майданчиком, а не скрізь за замовчуванням.
- Важкий лендинг — великі картинки, десяток скриптів аналітики — зазвичай гальмує сильніше, ніж фільтр. Оптимізація самої сторінки часто дає більше, ніж вибір способу підключення.
Який спосіб вибрати під ваше завдання
- Лендинг на конструкторі або чужому хостингу без PHP — JS-тег. Головне — перший рядок
<head>. - Власний хостинг із PHP — PHP-файл. Він не залежить від браузера і дає більше можливостей: код відповіді замість White Page, тіньовий режим, режим «Трекер».
- WordPress — плагін, якщо тариф його відкриває; інакше PHP-файл.
- Потік у режимі «Трекер» — лише PHP-файл: тег для нього у вікні підключення не показується.
Для Google Ads, Facebook і TikTok документація рекомендує будь-який із двох способів, для нативних мереж — PHP-файл. Готові налаштування під майданчики зібрано в каталозі джерел трафіку, а про саме налаштування потоку — фільтри, White Page, офери — читайте в статті налаштування клоаки покроково.
Підсумок
Підключення клоаки — це або один рядок JS-тегу першим у <head>, або PHP-файл у ролі index.php з перейменованим лендингом. Сайт і домен лишаються у вас. Після встановлення натисніть «Перевірити інтеграцію», відкрийте посилання в інкогніто і знайдіть візит у журналі кліків. Якщо щось іде не так, найчастіше причина в кеші, менеджері тегів або проксі хостингу — і журнал кліків зазвичай підказує, де саме.
