Клоака работает только тогда, когда стоит перед вашей страницей: посетитель пришёл по рекламной ссылке, фильтр проверил визит и решил, что показать — оффер или 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 с переименованным лендингом. Сайт и домен остаются у вас. После установки нажмите «Проверить интеграцию», откройте ссылку в инкогнито и найдите визит в журнале кликов. Если что-то идёт не так, чаще всего причина в кэше, менеджере тегов или прокси хостинга — и журнал кликов обычно подсказывает, где именно.
