Розділи документації
Трафік
Підключення до сайту
Щоб потік почав працювати, зв’яжіть його з вашим сайтом. Достатньо одного способу. У рекламі стоїть адреса вашого сайту, і сторінки лишаються у вас.
На цій сторінці
Який спосіб вибрати
- Сайт на Tilda, Webflow, Unbounce, Shopify або WordPress → конструктор.
- Трафік уже йде через власний Keitaro чи Binom → фільтр Keitaro або шлюз Binom.
- Потрібен режим «Трекер» → лише PHP-файл.
- Код сайту редагувати не можна, але домен у Cloudflare → Cloudflare.
- В інших випадках → JS-тег, перший спосіб у вікні підключення.
| Спосіб | Що потрібно | Режим «Трекер» | Наш код у вихідному коді сторінки | Складність |
|---|---|---|---|---|
| JS-тег | доступ до <head> | ні | видно | просто |
| PHP-файл | хостинг із PHP | так | не видно: рішення на сервері | середньо |
| Keitaro / Binom | власний трекер | ні | не видно: рішення на сервері | середньо |
| Конструктори, Cloudflare | акаунт сервісу | ні | видно (це той самий тег) | просто |
Якщо сайт потоку розміщено в нас (Де розмістити сайт → На нашому сервері), підключати нічого не потрібно: файл потоку ми ставимо на сервер і оновлюємо самі. Докладно — у розділі Сайти.
Відкрийте вікно підключення
Знайдіть потік
Розділ Потоки → у рядку потрібного потоку натисніть ⋯ → Підключення.

Рядок потоку: 1 — меню дій потоку, 2 — вікно підключення. Розгорніть один спосіб
Способи згорнуті, розгорнути можна лише один за раз. Робочий спосіб позначено зеленим і позначкою «Встановлено».

Вікно підключення потоку: 1 JS-тег, 2 PHP-файл — тут він уже стоїть на сайті.
Потік у режимі «Трекер» підключається лише PHP-файлом — тег, Keitaro, Binom і конструктори для нього не показуються.
JS-тег
Скопіюйте код
Розгорніть Встановлення JS-скрипта на лендинг і натисніть кнопку копіювання праворуч від коду 1.

У демо-акаунті код приховано; у вашому кабінеті в полі 1 буде код вашого потоку. Рядок 2 — куди вставляти: одразу після <head>.Вставте його першим рядком у <head>
На кожній сторінці лендингу — одразу після
<head>, вище за всі інші скрипти 2. Збережіть і оновіть сторінку.index.html<head> <!-- код із вікна підключення --> <meta charset="utf-8"> … </head>Не підключайте код через Google Tag Manager чи інші менеджери тегів і не додавайте
asyncабоdefer: з ними скрипт запускається пізніше, і сторінка встигає показатися всім, поки рішення ще немає.Перевірте підключення
Натисніть Перевірити інтеграцію: кабінет відкриє головну сторінку папки, у якій лежить офер потоку, і пошукає там код. Без адреси офера перевірка не запуститься.

Кнопка перевірки — останнім кроком у JS-тега і PHP-файлу. 
1 кнопка перевірки, 2 відповідь: код знайдено на сторінці. У блоку з’явиться позначка «Встановлено».
Тег ховає сторінку, поки не прийшло рішення. Якщо рішення не прийшло за 5 секунд, тег відправляє на White Page. А якщо в White Page немає своєї адреси (режим «Код відповіді» або наша готова сторінка), відвідувач побачить порожню сторінку.
PHP-файл
Для сайтів на хостингу з PHP. Єдиний спосіб для режиму «Трекер». Тіньовий режим працює з PHP-файлом, фільтром Keitaro і шлюзом Binom.
Завантажте файл
Розгорніть Підключення через PHP-файл і натисніть Завантажити PHP-файл 1.

Блок PHP-файлу: 1 кнопка завантаження і схема папки лендингу 2. Покладіть його в корінь лендингу під іменем index.php
А свій лендинг перейменуйте, наприклад на
offer.php:Папка лендингу/ ├── index.php ← наш файл └── offer.php ← ваш лендинг (був index.php або index.html)Вкажіть нову адресу лендингу в офері потоку
Наприклад,
https://ваш-сайт.com/offer.php.Покладіть поруч файл .htaccess
Ці рядки однакові для всіх потоків; якщо
.htaccessу папці вже є, допишіть їх під наявнимRewriteEngine On..htaccessRewriteEngine On RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^ index.php [L,QSA]Перевірте підключення
Кнопка Перевірити інтеграцію — кабінет перевірить, що файл відповідає.
Правило спрямовує в наш файл усі запити до адрес, яких на сайті немає. Це потрібно для двох речей.
Прелендинг. Після кнопки прелендингу офер відкривається за адресою start у тій самій папці, що й рекламне посилання: ваш-сайт.com/start?мітки для офера ваш-сайт.com/offer.php, ваш-сайт.com/папка/start?мітки для ваш-сайт.com/папка/offer.php. Без правила, якщо оновити цю сторінку, буде помилка 404. З правилом кнопка {click_url} веде на ваш домен — ваш-сайт.com/start?мітки, а не на нашу адресу переходу: натискання файл передає нам сам, і нашого домену в коді прелендингу немає.
White Page з іншого домену. Її сторінки, зображення й стилі файл віддає за адресами вашого домену: посилання меню white-site.com/kontakt.html стає ваш-сайт.com/kontakt.html, і відвідувач не йде на домен White Page. Без правила посилання так і ведуть на домен White Page.
На nginx без Apache додайте правило нижче (замість /folder/ — ваша папка) і все одно покладіть поруч з index.php файл .htaccess з тими самими рядками: nginx його не читає, а наш файл за ним розуміє, що правило налаштовано. Якщо лишити тільки try_files, сторінка оновлюється нормально, але кнопка прелендингу й посилання White Page ведуть на наші адреси.
location /folder/ {
try_files $uri $uri/ /folder/index.php?$query_string;
}Файл на сервері сам не оновлюється. Якщо вийшла нова версія, у вікні з’явиться повідомлення «Доступна нова версія PHP-файлу» і список того, чого не вміє ваша версія. Завантажте файл знову й замініть.
Як залити файл на хостинг
Покладіть PHP-файл і .htaccess у ту папку сайту, на яку веде реклама. Якщо реклама веде на my-landing.com/promo/, це папка public_html/promo/; якщо на корінь my-landing.com/ — сама public_html/.
Якщо в папці вже є index.php або index.html — це ваш лендинг. Спершу перейменуйте його, наприклад на offer.php, і вкажіть нову адресу в офері потоку; лише потім завантажуйте наш index.php. Інакше він замінить лендинг. Якщо є і index.html, і index.php, багато хостингів відкривають index.html першим — тоді наш файл не спрацює.
Через файловий менеджер панелі хостингу
Відкрийте файловий менеджер
У панелі хостингу — розділ «Файли» або «Файловий менеджер» 1.
Перейдіть у папку лендингу
Зазвичай
public_html(буваєwwwабоhtdocs), потім папка, на яку веде реклама 2.Натисніть «Завантажити»
Кнопка 3 відкриє вікно завантаження.

Приклад інтерфейсу — у вашого хостингу кнопки можуть називатися інакше. 1 файловий менеджер, 2 папка лендингу, 3 завантаження. Виберіть файли
Перетягніть
index.phpі.htaccessу вікно 4 і дочекайтеся позначки «завантажено» 5. Ім’я має бути самеindex.php: під час повторного завантаження браузер іноді дописує до імені «(1)».
Приклад інтерфейсу. 4 зона завантаження, 5 завантажені файли. Перевірте права й відкрийте сайт
Права файлів —
644, папок —755. Файл.htaccessу деяких менеджерах прихований — увімкніть «показувати приховані файли». Відкрийте адресу лендингу в браузері й натисніть Перевірити інтеграцію в кабінеті.
Через FTP- або SFTP-клієнт
Підключіться
Хост, користувача й пароль беруть у панелі хостингу, розділ FTP/SSH 1. Порт: 21 для FTP, 22 для SFTP. Натисніть «Підключитися» 2.
Відкрийте папку лендингу на сервері
Праворуч — сервер: перейдіть у
public_html/папка3.Перенесіть файли
Ліворуч — ваш комп’ютер: виберіть
index.phpі.htaccess4 і перетягніть праворуч 5.
Приклад інтерфейсу — у вашого клієнта кнопки можуть називатися інакше. 1 дані підключення, 2 підключитися, 3 папка на сервері, 4 файли на комп’ютері, 5 перенести.
| Помилка | Як побачити | Що зробити |
|---|---|---|
| Файл в іншій папці | Перевірка: «Сторінка відкрилася, але цей спосіб на ній не відповів» | Покладіть файл у папку, яка відкривається за адресою з реклами |
| Старий PHP | Сторінка пише «PHP 7.2 or higher is required.» | Увімкніть у панелі хостингу PHP 7.2 або новіший |
| Немає .htaccess або він прихований | Після кнопки прелендингу сторінка start дає 404 | Завантажте .htaccess поруч з index.php |
| Проксі хостингу | У всіх візитів у журналі одна й та сама IP-адреса | Пропустіть домен через Cloudflare (помаранчева хмара) або попросіть хостинг передавати справжню IP-адресу відвідувача (див. Якщо не працює) |
| Кеш хостингу або CDN | Сторінку бачать усі, або рішення змінюється із затримкою | Виключіть лендинг із кешування |
Фільтр для Keitaro

Якщо трафік уже йде через ваш Keitaro, ArtisanClo стає фільтром у потоці Keitaro: Keitaro питає в нас, чи пускати відвідувача на офер, а куди саме вести — вирішують ваші потоки в Keitaro.
Завантажте файл фільтра цього потоку
Покладіть його на сервер Keitaro
У папку
/var/www/keitaro/var/filters(у старих версіях —application/filters) і перезавантажте сторінку Keitaro.Додайте фільтр у кампанію
У кампанії Keitaro відкрийте потік з офером і додайте фільтр із тим самим ім’ям, що й у файлу, у режимі «Так». Нижче поставте потік із вашою White Page — туди потраплять усі, хто не пройшов фільтр.
Keitaro звертається до фільтра раніше, ніж відповідає відвідувачу, тому сторінки очікування тут немає: перевірка JavaScript, час на сторінці й жива взаємодія на цьому способі не діють, рішення ухвалюється лише за мережею й даними запиту. Адреси офера й White Page у потоці ArtisanClo не використовуються — їх задають потоки Keitaro. Якщо наш сервіс не відповів за 3 секунди, візит іде на White Page. Перевірку JavaScript, часу й взаємодії можна ввімкнути окремо — див. Перевірка браузера на прелендингу.
Шлюз для Binom

Якщо трафік іде через ваш Binom, ArtisanClo підключається до лендингу шлюзом: наша перевірка стоїть першим рядком лендингу і вирішує, кому його показати, ще до того, як він відкриється. Людина бачить ваш лендинг зі звичайним посиланням Binom на офер; бот і перевіряльник — White Page.
Завантажте файл шлюзу цього потоку
І покладіть його поруч із файлом лендингу Binom на вашому сервері.
Підключіть файл першим рядком лендингу
До будь-якого виводу:
Лендинг Binom<?php require __DIR__ . '/ac_binom_NNN.php'; ?>Перевірте підключення
Людина проходить на лендинг, бот отримує White Page.
Шлюз вирішує раніше, ніж лендинг відповідає відвідувачу, тому сторінки очікування на ньому немає: перевірка JavaScript, час на сторінці й жива взаємодія не діють, рішення ухвалюється лише за мережею й даними запиту. Якщо наш сервіс не відповів за 3 секунди, відвідувач побачить White Page, адресу якої записано у файл під час завантаження. Змінили White Page — завантажте файл знову. Якщо в White Page немає своєї адреси (режим «Код відповіді» або наша готова сторінка), шлюз у такій ситуації відповість помилкою 503. У Binom немає папки для фільтрів, як у Keitaro, тому підключаємося файлом у самому лендингу. Перевірку JavaScript, часу й взаємодії можна ввімкнути окремо — див. Перевірка браузера на прелендингу.
Перевірка браузера на прелендингу
Фільтр трекера бачить лише IP-адресу й заголовки запиту — сам браузер він не перевіряє. Щоб перевірити і його, поставте наш тег на прелендинг, куди трекер відправляє тих, хто пройшов фільтр. Тег подивиться, чи працює JavaScript, скільки відвідувач провів на сторінці, чи рухав мишею або гортав і чи не автоматичний це браузер. Не пройшов перевірку — побачить White Page. Пройшов — лишиться на прелендингу й піде далі вашою кампанією. У статистиці візит буде пораховано один раз, а не двічі.
Вмикається у вікні підключення потоку, у блоці фільтра Keitaro або шлюзу Binom. Там само показано точний параметр для адреси прелендингу (нижче його позначено як NAME) і три рядки, за якими видно, що все підключено правильно.

Keitaro
Додайте параметр до адреси прелендингу
У Keitaro, у потоці з офером, додайте до адреси прелендингу (або лендингу) цей параметр — через
?, якщо параметрів в адресі ще немає, або через&, якщо є. За ним ми на прелендингу впізнаємо відвідувача, якого пропустив фільтр:ПараметрNAME={subid}Вставте наш тег на самий початок <head> цього прелендингу
Оновіть файл фільтра
Завантажте його знову й замініть старий — нова версія передає нам subid. Потім відкрийте посилання кампанії самі: після першого візиту три рядки перевірки стануть зеленими.
Binom
Додайте параметр до адреси лендингу
У Binom додайте до адреси лендингу цей параметр — через
?або&. За ним ми на лендингу впізнаємо відвідувача, якого пропустив шлюз:ПараметрNAME={clickid}Вставте наш тег на самий початок <head> цього ж лендингу
Оновіть файл шлюзу
Завантажте його знову й замініть старий — нова версія читає clickid. Потім відкрийте посилання кампанії самі: після першого візиту три рядки перевірки стануть зеленими.
Без параметра ми однаково зв’яжемо візит за IP-адресою і браузером, але менш точно: у мобільних операторів одну адресу часто ділить багато людей. Візит, який пропустив трекер, з’явиться в журналі, щойно відповість тег. Якщо відвідувач до прелендингу так і не дійшов, візит запишеться приблизно через дві хвилини з тим рішенням, яке ухвалив фільтр у трекері. Той, хто відкриє прелендинг напряму, оминаючи трекер (наприклад, модератор рекламної мережі), пройде повну перевірку тега. У тіньовому режимі й у режимі «Трекер» ця перевірка не працює.
Конструктори сайтів

На Starter доступні JS-тег, PHP-файл, фільтр Keitaro і шлюз Binom. Плагін WordPress, воркер Cloudflare і покрокові інструкції для конструкторів — з Professional і на пробному періоді. Сайт на Tilda, Webflow, Unbounce або Shopify на Starter теж можна підключити — звичайним JS-тегом, просто без інструкції.
- WordPress з Professional — Завантажити плагін → у WordPress «Плагіни» → «Додати новий» → «Завантажити плагін» → «Встановити» → «Активувати» → «Налаштування» → Traffic Gate (так називається наш плагін) → вставте API-токен із розділу «Інтеграція через API» (меню під аватаром) і виберіть потік. Якщо на сайті є плагін кешування, очистьте кеш після підключення.
- Tilda, Webflow з Professional — потрібен платний тариф самого конструктора. Вставте код у розділ head і опублікуйте сайт.
- Unbounce з Professional — Script Manager, місце — Head. На піддомені unbouncepages.com не працює: потрібен власний домен.
- Shopify з Professional — вставте код у шаблон теми одразу після
<head>.
У кожного конструктора у вікні підключення свій блок: 1 код для вставки — його копіюють кнопкою праворуч, 2 кроки для цього конструктора.




Cloudflare з Professional — тег вставляє воркер на боці Cloudflare, файли сайту не змінюються. Покроково — у розділі Підключення через Cloudflare.
Перевірка підключення
- Відповіді перевірки: «Підключення знайдено на вашій сторінці», «Сторінка відкрилася, але цей спосіб підключення на ній не відповів» або відповідь, що сторінку відкрити не вдалося, — з причиною:
- сторінка не пустила нашу перевірку — найчастіше це захист від ботів у хостингу чи CDN (наприклад, перевірка Cloudflare). Підключення при цьому може стояти правильно: його підтвердить перший живий візит;
- за адресою офера сторінки немає;
- сервер із вашою сторінкою відповів помилкою;
- сторінка не відповіла вчасно;
- сторінка переадресовує деінде.
- Якщо на сторінці стоїть тег іншого вашого потоку, перевірка так і скаже: «На сторінці стоїть тег іншого вашого потоку — «…». Замініть сніпет на сніпет цього потоку» (сніпет — це код тега).
- Перевіряти можна раз на 20 секунд; якщо натиснути раніше, кабінет відповість «Щойно перевіряли». Кожна перевірка знімає позначки «Встановлено» і «Підключення активне» в усіх способів, включно з Keitaro і Binom. «Встановлено» повернеться одразу, якщо перевірка знайшла підключення, інакше — з першим візитом. «Підключення активне» завжди повертається з першим візитом.
- Під способом видно «Активне зараз» або дату останньої активності.
Якщо скрипт тега не завантажиться (наприклад, його блокує мережа чи захист на сервері), сторінка не сховається і її побачить модерація. Ставте код першим рядком і перевіряйте підключення після кожного редагування сайту.
ArtisanClo · Документація кабінету. Запитання — info@artisanclo.com або підтримка в Telegram.