Розділи документації
Трафік
Підключення до сайту
Щоб потік запрацював, зв’яжіть його з вашим сайтом. Відкрийте меню потоку → Підключення і виберіть один спосіб — одного достатньо. У рекламу йде адреса вашого сайту: сторінки лишаються у вас.
- Способи згорнуті, одночасно відкритий лише один. Робочий спосіб позначено зеленим і плашкою «Встановлено».
- Потік у режимі «Трекер» підключається лише 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 «Плагіни» → «Завантажити» → «Активувати» → «Налаштування» → Traffic Gate → вставте 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.