Разделы документации
Трафик
Подключение к сайту
Чтобы поток начал работать, свяжите его с вашим сайтом. Откройте меню потока → Интеграция и выберите один способ — достаточно одного. В рекламу уходит адрес вашего сайта: страницы остаются у вас.
- Способы свёрнуты, одновременно открыт один. Работающий способ отмечен зелёным и плашкой «Установлен».
- Поток в режиме «Трекер» подключается только PHP-файлом — тег, Keitaro, Binom и конструкторы для него не показываются.
JS-тег
- Скопируйте код.
- Вставьте его первой строкой в
<head>на каждой странице лендинга, сохраните и обновите страницу. Не подключайте код через Google Tag Manager или другие менеджеры тегов и не добавляйтеasyncилиdefer: они запускают скрипт позже, и страница успевает показаться всем до решения. - Проверьте подключение кнопкой Проверить интеграцию: кабинет откроет страницу и найдёт на ней код.
Тег прячет страницу, пока не пришло решение, и уводит на White Page, если решения нет.
PHP-файл
Для сайтов на хостинге с PHP. Подходит для режима «Трекер». Теневой режим работает на PHP-файле, фильтре Keitaro и шлюзе Binom.
- Скачайте файл кнопкой Скачать PHP-файл.
- Положите его в корень лендинга под именем
index.php, а свой лендинг переименуйте, например вoffer.php. - Укажите новый адрес лендинга в оффере потока, например
https://ваш-сайт.com/offer.php. - Проверьте подключение — кабинет проверит, что файл отвечает.
Файл на сервере сам не обновляется. Если вышла новая версия, в окне появится плашка «Доступна новая версия PHP-файла» со списком того, чего не умеет ваша текущая версия. Скачайте файл заново и замените.
Фильтр для Keitaro
Если трафик уже идёт через ваш Keitaro, ArtisanClo встаёт в него фильтром потока: Keitaro спрашивает нас, пускать ли визит на оффер, а куда вести, решают ваши потоки в Keitaro.
- Скачайте файл фильтра этого потока.
- Положите его на сервер Keitaro в /var/www/keitaro/var/filters (в старых версиях — application/filters) и перезагрузите страницу Keitaro.
- В кампании Keitaro откройте поток с оффером и добавьте фильтр с именем файла в режиме «Да». Ниже поставьте поток с вашей White Page — туда уйдут все остальные.
Keitaro спрашивает фильтр до ответа посетителю, поэтому страницы проверки здесь нет: проверка JavaScript, время на странице и живое взаимодействие на этом способе не действуют, решение принимается по сети и признакам запроса. Адреса оффера и White Page в потоке ArtisanClo не используются — их задают потоки Keitaro. Если наш сервис не ответил за 3 секунды, визит уходит на White Page.
Шлюз для Binom
Если трафик идёт через ваш Binom, ArtisanClo встаёт шлюзом в лендинг: проверка стоит первой строкой лендинга и решает до его показа. Человек видит ваш лендинг с обычной ссылкой Binom на оффер; бот и проверяющий — White Page.
- Скачайте файл шлюза этого потока и положите его рядом с файлом лендинга Binom на вашем сервере.
- Сделайте первой строкой лендинга, до любого вывода, подключение файла:
<?php require __DIR__ . '/ac_binom_NNN.php'; ?> - Проверьте подключение: человек проходит на лендинг, бот получает White Page.
Шлюз решает до ответа посетителю, поэтому страницы проверки на нём нет: проверка JavaScript, время на странице и живое взаимодействие не действуют, решение принимается по сети и признакам запроса. Если сервис не ответил за 3 секунды, посетитель уходит на White Page, вшитую в файл при скачивании, — если вы смените White Page, перескачайте файл. У Binom нет папки фильтров, как у Keitaro, поэтому способ — файл в самом лендинге, а не фильтр потока.
Конструкторы сайтов
На Starter сайт подключается JS-тегом или PHP-файлом. Плагин WordPress, воркер Cloudflare и инструкции для конструкторов — с тарифа Professional.
- WordPress с Professional — Скачать плагин → в WordPress «Плагины» → «Загрузить» → «Активировать» → «Настройки» → ArtisanClo → вставьте API-ключ и выберите поток. Если на сайте есть плагин кэширования, очистите кэш после подключения.
- Tilda, Webflow с Professional — нужен платный тариф конструктора: вставьте код в раздел head и опубликуйте сайт.
- Unbounce с Professional — Script Manager, размещение Head. На домене unbouncepages.com не работает.
- Shopify с Professional — вставьте код в шаблон темы сразу после
<head>. - Cloudflare с Professional — код вставляется на стороне Cloudflare, файлы сайта не меняются. Домен должен проксироваться через Cloudflare (оранжевое облако).
- Workers & Pages → Create application → Start with Hello World: задайте имя и нажмите Deploy.
- Edit code: замените стандартный код на код из окна подключения и нажмите Deploy.
- Settings → Variables and Secrets → Add: тип Text, имя
AC_SNIPPET, значение — код для вставки целиком. Нажмите Deploy. - Settings → Domains & Routes → Add → Route: выберите домен и укажите шаблон, например
example.com/*.
Проверка подключения
- Ответы проверки: «Подключение найдено на вашей странице», «Страница открылась, но этот способ подключения на ней не ответил» или «Не удалось открыть вашу страницу». Последний ещё не значит, что подключение не работает: некоторые сайты не пускают проверку.
- Проверять можно раз в 20 секунд. Проверка сбрасывает прежние отметки «Установлен» и «Интеграция активна» — они вернутся с первым визитом.
- Под способом видно «Активно сейчас» или дату последней активности.
Если скрипт тега не загрузится (например, его режет сеть или блокировщик на сервере), страница не спрячется и её увидит модерация. Ставьте код первой строкой и проверяйте подключение после каждой правки сайта.
ArtisanClo · Документация кабинета. Вопросы — info@artisanclo.com или @artisanclo_support в Telegram.