Документация

Трафик

Подключение к сайту

Чтобы поток начал работать, свяжите его с вашим сайтом. Откройте меню потока → Интеграция и выберите один способ — достаточно одного. В рекламу уходит адрес вашего сайта: страницы остаются у вас.

  • Способы свёрнуты, одновременно открыт один. Работающий способ отмечен зелёным и плашкой «Установлен».
  • Поток в режиме «Трекер» подключается только PHP-файлом — тег, Keitaro, Binom и конструкторы для него не показываются.

JS-тег

  1. Скопируйте код.
  2. Вставьте его первой строкой в <head> на каждой странице лендинга, сохраните и обновите страницу. Не подключайте код через Google Tag Manager или другие менеджеры тегов и не добавляйте async или defer: они запускают скрипт позже, и страница успевает показаться всем до решения.
  3. Проверьте подключение кнопкой Проверить интеграцию: кабинет откроет страницу и найдёт на ней код.

Тег прячет страницу, пока не пришло решение, и уводит на White Page, если решения нет.

PHP-файл

Для сайтов на хостинге с PHP. Подходит для режима «Трекер». Теневой режим работает на PHP-файле, фильтре Keitaro и шлюзе Binom.

  1. Скачайте файл кнопкой Скачать PHP-файл.
  2. Положите его в корень лендинга под именем index.php, а свой лендинг переименуйте, например в offer.php.
  3. Укажите новый адрес лендинга в оффере потока, например https://ваш-сайт.com/offer.php.
  4. Проверьте подключение — кабинет проверит, что файл отвечает.

Файл на сервере сам не обновляется. Если вышла новая версия, в окне появится плашка «Доступна новая версия PHP-файла» со списком того, чего не умеет ваша текущая версия. Скачайте файл заново и замените.

Фильтр для Keitaro

Если трафик уже идёт через ваш Keitaro, ArtisanClo встаёт в него фильтром потока: Keitaro спрашивает нас, пускать ли визит на оффер, а куда вести, решают ваши потоки в Keitaro.

  1. Скачайте файл фильтра этого потока.
  2. Положите его на сервер Keitaro в /var/www/keitaro/var/filters (в старых версиях — application/filters) и перезагрузите страницу Keitaro.
  3. В кампании Keitaro откройте поток с оффером и добавьте фильтр с именем файла в режиме «Да». Ниже поставьте поток с вашей White Page — туда уйдут все остальные.

Keitaro спрашивает фильтр до ответа посетителю, поэтому страницы проверки здесь нет: проверка JavaScript, время на странице и живое взаимодействие на этом способе не действуют, решение принимается по сети и признакам запроса. Адреса оффера и White Page в потоке ArtisanClo не используются — их задают потоки Keitaro. Если наш сервис не ответил за 3 секунды, визит уходит на White Page.

Шлюз для Binom

Если трафик идёт через ваш Binom, ArtisanClo встаёт шлюзом в лендинг: проверка стоит первой строкой лендинга и решает до его показа. Человек видит ваш лендинг с обычной ссылкой Binom на оффер; бот и проверяющий — White Page.

  1. Скачайте файл шлюза этого потока и положите его рядом с файлом лендинга Binom на вашем сервере.
  2. Сделайте первой строкой лендинга, до любого вывода, подключение файла: <?php require __DIR__ . '/ac_binom_NNN.php'; ?>
  3. Проверьте подключение: человек проходит на лендинг, бот получает 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 (оранжевое облако).
    1. Workers & Pages → Create application → Start with Hello World: задайте имя и нажмите Deploy.
    2. Edit code: замените стандартный код на код из окна подключения и нажмите Deploy.
    3. Settings → Variables and Secrets → Add: тип Text, имя AC_SNIPPET, значение — код для вставки целиком. Нажмите Deploy.
    4. Settings → Domains & Routes → Add → Route: выберите домен и укажите шаблон, например example.com/*.
    Без Deploy после добавления переменной код не вставится, а с серым облаком воркер не запускается.

Проверка подключения

  • Ответы проверки: «Подключение найдено на вашей странице», «Страница открылась, но этот способ подключения на ней не ответил» или «Не удалось открыть вашу страницу». Последний ещё не значит, что подключение не работает: некоторые сайты не пускают проверку.
  • Проверять можно раз в 20 секунд. Проверка сбрасывает прежние отметки «Установлен» и «Интеграция активна» — они вернутся с первым визитом.
  • Под способом видно «Активно сейчас» или дату последней активности.
Код должен загружаться первым

Если скрипт тега не загрузится (например, его режет сеть или блокировщик на сервере), страница не спрячется и её увидит модерация. Ставьте код первой строкой и проверяйте подключение после каждой правки сайта.

ArtisanClo · Документация кабинета. Вопросы — info@artisanclo.com или @artisanclo_support в Telegram.