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

Трафік

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

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

На цій сторінці

Який спосіб вибрати

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

Якщо сайт потоку розміщено в нас (Де розмістити сайт → На нашому сервері), підключати нічого не потрібно: файл потоку ми ставимо на сервер і оновлюємо самі. Докладно — у розділі Сайти.

Відкрийте вікно підключення

  1. Знайдіть потік

    Розділ Потоки → у рядку потрібного потоку натисніть ⋯ → Підключення.

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

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

    Вікно «Підключення»: список способів — JS-скрипт, PHP-файл (позначено «Встановлено»), Keitaro, Binom, WordPress, Cloudflare, Tilda
    Вікно підключення потоку: 1 JS-тег, 2 PHP-файл — тут він уже стоїть на сайті.

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

JS-тег

  1. Скопіюйте код

    Розгорніть Встановлення JS-скрипта на лендинг і натисніть кнопку копіювання праворуч від коду 1.

    Блок «Встановлення JS-скрипта на лендинг»: поле з кодом і кнопкою копіювання, схема вставлення в head, попередження про менеджери тегів
    У демо-акаунті код приховано; у вашому кабінеті в полі 1 буде код вашого потоку. Рядок 2 — куди вставляти: одразу після <head>.
  2. Вставте його першим рядком у <head>

    На кожній сторінці лендингу — одразу після <head>, вище за всі інші скрипти 2. Збережіть і оновіть сторінку.

    index.html
    <head>
      <!-- код із вікна підключення -->
      <meta charset="utf-8">
      …
    </head>

    Не підключайте код через Google Tag Manager чи інші менеджери тегів і не додавайте async або defer: з ними скрипт запускається пізніше, і сторінка встигає показатися всім, поки рішення ще немає.

  3. Перевірте підключення

    Натисніть Перевірити інтеграцію: кабінет відкриє головну сторінку папки, у якій лежить офер потоку, і пошукає там код. Без адреси офера перевірка не запуститься.

    Крок «Перевірте підключення» з кнопкою «Перевірити інтеграцію»
    Кнопка перевірки — останнім кроком у JS-тега і PHP-файлу.
    Крок «Перевірте підключення» після перевірки: кнопка «Перевірити інтеграцію» і рядок «Знайдено на сторінці»
     1 кнопка перевірки, 2 відповідь: код знайдено на сторінці. У блоку з’явиться позначка «Встановлено».

Тег ховає сторінку, поки не прийшло рішення. Якщо рішення не прийшло за 5 секунд, тег відправляє на White Page. А якщо в White Page немає своєї адреси (режим «Код відповіді» або наша готова сторінка), відвідувач побачить порожню сторінку.

PHP-файл

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

  1. Завантажте файл

    Розгорніть Підключення через PHP-файл і натисніть Завантажити PHP-файл 1.

    Блок «Підключення через PHP-файл»: кнопка «Завантажити PHP-файл», схема папки з index.php і offer.php, крок із новою адресою лендингу
    Блок PHP-файлу: 1 кнопка завантаження і схема папки лендингу 2.
  2. Покладіть його в корінь лендингу під іменем index.php

    А свій лендинг перейменуйте, наприклад на offer.php:

    Папка лендингу
    /
    ├── index.php   ← наш файл
    └── offer.php   ← ваш лендинг (був index.php або index.html)
  3. Вкажіть нову адресу лендингу в офері потоку

    Наприклад, https://ваш-сайт.com/offer.php.

  4. Покладіть поруч файл .htaccess

    Ці рядки однакові для всіх потоків; якщо .htaccess у папці вже є, допишіть їх під наявним RewriteEngine On.

    .htaccess
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^ index.php [L,QSA]
  5. Перевірте підключення

    Кнопка Перевірити інтеграцію — кабінет перевірить, що файл відповідає.

Навіщо правило .htaccess

Правило спрямовує в наш файл усі запити до адрес, яких на сайті немає. Це потрібно для двох речей.

Прелендинг. Після кнопки прелендингу офер відкривається за адресою 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 ведуть на наші адреси.

nginx
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. Відкрийте файловий менеджер

    У панелі хостингу — розділ «Файли» або «Файловий менеджер» 1.

  2. Перейдіть у папку лендингу

    Зазвичай public_html (буває www або htdocs), потім папка, на яку веде реклама 2.

  3. Натисніть «Завантажити»

    Кнопка 3 відкриє вікно завантаження.

    Приклад панелі хостингу: файловий менеджер, шлях /public_html/promo/ і кнопка «Завантажити»
    Приклад інтерфейсу — у вашого хостингу кнопки можуть називатися інакше. 1 файловий менеджер, 2 папка лендингу, 3 завантаження.
  4. Виберіть файли

    Перетягніть index.php і .htaccess у вікно 4 і дочекайтеся позначки «завантажено» 5. Ім’я має бути саме index.php: під час повторного завантаження браузер іноді дописує до імені «(1)».

    Приклад вікна завантаження: зона для файлів і два завантажені файли index.php і .htaccess
    Приклад інтерфейсу. 4 зона завантаження, 5 завантажені файли.
  5. Перевірте права й відкрийте сайт

    Права файлів — 644, папок — 755. Файл .htaccess у деяких менеджерах прихований — увімкніть «показувати приховані файли». Відкрийте адресу лендингу в браузері й натисніть Перевірити інтеграцію в кабінеті.

Через FTP- або SFTP-клієнт

  1. Підключіться

    Хост, користувача й пароль беруть у панелі хостингу, розділ FTP/SSH 1. Порт: 21 для FTP, 22 для SFTP. Натисніть «Підключитися» 2.

  2. Відкрийте папку лендингу на сервері

    Праворуч — сервер: перейдіть у public_html/папка 3.

  3. Перенесіть файли

    Ліворуч — ваш комп’ютер: виберіть index.php і .htaccess 4 і перетягніть праворуч 5.

    Приклад FTP-клієнта: поля підключення, ліворуч файли комп’ютера, праворуч папка /public_html/promo/ на сервері
    Приклад інтерфейсу — у вашого клієнта кнопки можуть називатися інакше. 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» у вікні підключення: три кроки й кнопка «Завантажити фільтр»
 1 завантажити фільтр, 2 куди покласти файл на сервері Keitaro, 3 як додати фільтр у потік Keitaro.

Якщо трафік уже йде через ваш Keitaro, ArtisanClo стає фільтром у потоці Keitaro: 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. Перевірку JavaScript, часу й взаємодії можна ввімкнути окремо — див. Перевірка браузера на прелендингу.

Шлюз для Binom

Блок «Шлюз для Binom» у вікні підключення: три кроки, рядок підключення файлу й кнопка «Завантажити шлюз»
 1 завантажити шлюз, 2 рядок для першого рядка лендингу, 3 перевірка: людина на лендингу, бот на White Page.

Якщо трафік іде через ваш Binom, ArtisanClo підключається до лендингу шлюзом: наша перевірка стоїть першим рядком лендингу і вирішує, кому його показати, ще до того, як він відкриється. Людина бачить ваш лендинг зі звичайним посиланням Binom на офер; бот і перевіряльник — White Page.

  1. Завантажте файл шлюзу цього потоку

    І покладіть його поруч із файлом лендингу Binom на вашому сервері.

  2. Підключіть файл першим рядком лендингу

    До будь-якого виводу:

    Лендинг Binom
    <?php require __DIR__ . '/ac_binom_NNN.php'; ?>
  3. Перевірте підключення

    Людина проходить на лендинг, бот отримує White Page.

Шлюз вирішує раніше, ніж лендинг відповідає відвідувачу, тому сторінки очікування на ньому немає: перевірка JavaScript, час на сторінці й жива взаємодія не діють, рішення ухвалюється лише за мережею й даними запиту. Якщо наш сервіс не відповів за 3 секунди, відвідувач побачить White Page, адресу якої записано у файл під час завантаження. Змінили White Page — завантажте файл знову. Якщо в White Page немає своєї адреси (режим «Код відповіді» або наша готова сторінка), шлюз у такій ситуації відповість помилкою 503. У Binom немає папки для фільтрів, як у Keitaro, тому підключаємося файлом у самому лендингу. Перевірку JavaScript, часу й взаємодії можна ввімкнути окремо — див. Перевірка браузера на прелендингу.

Перевірка браузера на прелендингу

Фільтр трекера бачить лише IP-адресу й заголовки запиту — сам браузер він не перевіряє. Щоб перевірити і його, поставте наш тег на прелендинг, куди трекер відправляє тих, хто пройшов фільтр. Тег подивиться, чи працює JavaScript, скільки відвідувач провів на сторінці, чи рухав мишею або гортав і чи не автоматичний це браузер. Не пройшов перевірку — побачить White Page. Пройшов — лишиться на прелендингу й піде далі вашою кампанією. У статистиці візит буде пораховано один раз, а не двічі.

Вмикається у вікні підключення потоку, у блоці фільтра Keitaro або шлюзу Binom. Там само показано точний параметр для адреси прелендингу (нижче його позначено як NAME) і три рядки, за якими видно, що все підключено правильно.

Блок «Перевірка браузера на прелендингу» у фільтрі Keitaro: параметр для адреси прелендингу, тег і три зелені рядки перевірки
 1 параметр для адреси прелендингу, 2 тег для його <head>, 3 три рядки перевірки — усе підключено.

Keitaro

  1. Додайте параметр до адреси прелендингу

    У Keitaro, у потоці з офером, додайте до адреси прелендингу (або лендингу) цей параметр — через ?, якщо параметрів в адресі ще немає, або через &, якщо є. За ним ми на прелендингу впізнаємо відвідувача, якого пропустив фільтр:

    Параметр
    NAME={subid}
  2. Вставте наш тег на самий початок <head> цього прелендингу

  3. Оновіть файл фільтра

    Завантажте його знову й замініть старий — нова версія передає нам subid. Потім відкрийте посилання кампанії самі: після першого візиту три рядки перевірки стануть зеленими.

Binom

  1. Додайте параметр до адреси лендингу

    У Binom додайте до адреси лендингу цей параметр — через ? або &. За ним ми на лендингу впізнаємо відвідувача, якого пропустив шлюз:

    Параметр
    NAME={clickid}
  2. Вставте наш тег на самий початок <head> цього ж лендингу

  3. Оновіть файл шлюзу

    Завантажте його знову й замініть старий — нова версія читає clickid. Потім відкрийте посилання кампанії самі: після першого візиту три рядки перевірки стануть зеленими.

Без параметра ми однаково зв’яжемо візит за IP-адресою і браузером, але менш точно: у мобільних операторів одну адресу часто ділить багато людей. Візит, який пропустив трекер, з’явиться в журналі, щойно відповість тег. Якщо відвідувач до прелендингу так і не дійшов, візит запишеться приблизно через дві хвилини з тим рішенням, яке ухвалив фільтр у трекері. Той, хто відкриє прелендинг напряму, оминаючи трекер (наприклад, модератор рекламної мережі), пройде повну перевірку тега. У тіньовому режимі й у режимі «Трекер» ця перевірка не працює.

Конструктори сайтів

Блок WordPress у вікні підключення: кроки встановлення плагіна й кнопка «Завантажити плагін»
 1 завантажити плагін, 2 встановити у WordPress, 3 вставити API-токен, 4 вибрати потік.

На 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 кроки для цього конструктора.

Блок Tilda: код для вставки і три кроки
Tilda. 1 «Код для вставки», 2 кроки встановлення.
Блок Webflow: код для вставки і три кроки
Webflow. 1 «Код для вставки», 2 кроки встановлення.
Блок Unbounce: код для вставки і чотири кроки
Unbounce. 1 «Код для вставки», 2 кроки встановлення.
Блок Shopify: код для вставки і чотири кроки
Shopify. 1 «Код для вставки», 2 кроки встановлення.

Cloudflare з Professional — тег вставляє воркер на боці Cloudflare, файли сайту не змінюються. Покроково — у розділі Підключення через Cloudflare.

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

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

Якщо скрипт тега не завантажиться (наприклад, його блокує мережа чи захист на сервері), сторінка не сховається і її побачить модерація. Ставте код першим рядком і перевіряйте підключення після кожного редагування сайту.

ArtisanClo · Документація кабінету. Запитання — info@artisanclo.com або підтримка в Telegram.