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

Трафік

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

Щоб потік запрацював, зв’яжіть його з вашим сайтом. Відкрийте меню потоку → Підключення і виберіть один спосіб — одного достатньо. У рекламу йде адреса вашого сайту: сторінки лишаються у вас.

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