Keitaro — один із найпоширеніших трекерів в арбітражних командах: у ньому налаштовано кампанії, потоки, офери й звіти, і переїжджати з нього ніхто не хоче. Добра новина — і не треба. ArtisanClo стає поруч із Кейтаро й відповідає лише за одне завдання: вирішити, хто перед вами — жива людина чи бот, і записати причину цього рішення. Усе інше лишається у вашому трекері. Keitaro встановлюють на власний сервер; чим це відрізняється від хмарного варіанта, розібрано в статті хмарний трекер чи серверний.
Навіщо зв’язувати Keitaro і клоаку
Трекер і клоака розв’язують різні завдання. Трекер рахує: звідки прийшов клік, куди пішов, скільки коштував і скільки заробив. Клоака вирішує: кому показати офер, а кому — нейтральну White Page. Докладно різницю описано в статті клоака й трекер: у чому різниця.
Коли ви вже працюєте в Keitaro, вам потрібна не друга система обліку, а надійна відповідь «пускати чи ні» просто всередині звичної схеми. Звідси два варіанти зв’язки.
| Схема 1: фільтр у Keitaro | Схема 2: клоака на лендингу + Keitaro | |
|---|---|---|
| Хто першим бачить візит | Keitaro | Ваш лендинг із тегом або PHP-файлом |
| Де стоїть перевірка | Фільтр потоку в кампанії Keitaro | На сторінці лендингу |
| Куди веде візит | Вирішують потоки Keitaro | Вирішує потік ArtisanClo, офер — посилання на Keitaro |
| Перевірка браузера (JavaScript, час на сторінці) | Немає | Є |
| Що потрібно зробити | Покласти файл фільтра на сервер Keitaro | Поставити JS-тег або PHP-файл і налаштувати постбек |
| Коли обирати | Трафік уже йде через посилання Keitaro | Потрібна повна перевірка й конверсії в статистиці клоаки |
Схема 1: клоакінг через Кейтаро — ArtisanClo як фільтр потоку
Тут рекламне посилання веде в кампанію Keitaro, як і раніше. Перш ніж віддати відвідувачеві офер, Keitaro запитує ArtisanClo: пускати цей візит чи ні. Якщо відповідь «так» — працює потік з офером. Якщо «ні» — візит провалюється нижче, у потік із White Page.
Покрокове налаштування
- Створіть в ArtisanClo потік. Це одна кампанія: джерело, правила фільтрації, гео й захист.
- Відкрийте меню потоку → Підключення → Фільтр для Keitaro і завантажте файл фільтра цього потоку.
- Покладіть файл на сервер Keitaro в папку
/var/www/keitaro/var/filters(у старих версіях —application/filters) і перезавантажте сторінку Keitaro. - У кампанії Keitaro відкрийте потік з офером і додайте фільтр з ім’ям файлу в режимі «Так».
- Нижче поставте потік із вашою White Page — туди підуть усі, кого фільтр не пропустив.
Зверніть увагу: адреси офера й White Page, указані в потоці ArtisanClo, у цій схемі не використовуються. Куди вести людину, а куди — бота, вирішують ваші потоки в Keitaro. ArtisanClo лише відповідає на запитання «пропустити?». По суті Keitaro тут працює як TDS-система — розподіляє трафік, а фільтр тільки дає йому відповідь.
Обмеження фільтра
Keitaro звертається до фільтра до того, як відповість відвідувачеві. Показати браузеру сторінку перевірки в цей момент неможливо, тому:
- перевірка JavaScript, мінімальний час на сторінці й жива взаємодія не діють;
- рішення ухвалюється за мережею та ознаками запиту: IP-адреса, провайдер, дата-центр, VPN і проксі, заголовки, мітка кліку, правила гео, пристроїв і розкладу;
- якщо сервіс не відповів за 3 секунди, візит іде на White Page.
Для багатьох джерел цього досить: серверний трафік, дата-центри й проксі-мережі видають себе ще на рівні мережі. Ботів, які запускають справжній браузер і вдають людей, за мережею видно не завжди — їх ловить перевірка браузера зі схеми 2.
Тіньовий режим і режим «Трекер»
Фільтр Keitaro підтримує тіньовий режим: фільтр нікого не відсікає, а лише позначає в журналі, кого заблокував би. Це зручно, коли ви підозрюєте, що втрачаєте живих людей, або хочете подивитися, як позначиться посилення правил, не ризикуючи трафіком. Не тримайте тінь довго: поки вона увімкнена, офер доступний усім.
Режим потоку «Трекер» на фільтрі Keitaro теж працює: усі йдуть на офер, а ботів лише позначають у звітах. Це корисно, коли ви хочете знати частку ботів в оплаченому трафіку, але фільтрувати поки не готові.
Порада. Одразу після підключення відкрийте журнал кліків в ArtisanClo й подивіться причини рішень щодо перших візитів. Якщо всіх ріже та сама причина, найімовірніше, правило аудиторії (наприклад, гео) налаштовано не під ваш трафік.
Схема 2: клоака на лендингу і Keitaro як зовнішній трекер
У другій схемі першим візит зустрічає ваш сайт. На ньому стоїть JS-тег або PHP-файл ArtisanClo — сайт лишається у вас, на вашому хостингу й домені. Клоака перевіряє відвідувача повністю, зокрема браузер, і вирішує: White Page чи офер. А «офер» тут — це посилання на вашу кампанію Keitaro, далі все працює як завжди.
Як підключити клоаку до сайту, докладно описано в статті про підключення клоаки: JS-тег чи PHP-файл.
Як повернути конверсії з Keitaro в клоаку
Сама собою клоака в режимі «Клоакінг» конверсій не бачить: вона знає, кого пропустила, але не знає, хто з них купив. Щоб у її статистиці з’явилися CR і дохід, треба замкнути коло:
- У потоці ArtisanClo відкрийте крок 3. Трекінг → блок Зовнішній трекер і виберіть зі списку Keitaro. Кнопка «?» поруч покаже нотатку й посилання на документацію трекера.
- Скопіюйте параметр для рекламного посилання вигляду
external_id={click_id}. Кнопка Додати до посилання допише його в усі офери потоку. Поле світиться зеленим, якщо параметр уже стоїть у посиланні офера, і червоним, якщо ні. - У Keitaro прийміть цей параметр в одну з міток кампанії, щоб номер кліку ArtisanClo зберігся в трекері.
- Відкрийте в ArtisanClo вікно з адресою постбека й вставте її в налаштування постбеків кампанії Keitaro, підставивши збережену мітку та статус конверсії.
- Надішліть тестову конверсію й перевірте рядок стану.
Посилання офера в потоці виглядатиме приблизно так:
https://trk.ваш-домен.com/AbCdEf?external_id={click_id}
Замість {click_id} ArtisanClo підставить номер конкретного кліку. Keitaro його запам’ятає, а коли партнерська мережа надішле трекеру конверсію, Keitaro перешле її далі — і конверсія прив’яжеться до початкового кліку в клоаці. Схема «Як click_id проходить коло» в кабінеті показує цей шлях наочно. Якщо тема click id для вас нова, зазирніть у статтю Click ID і Sub ID.
Що означає рядок стану
| Повідомлення | Що робити |
|---|---|
| «Конверсії вже надходять» | Нічого — коло замкнуто |
| «Постбеки надходять, але жоден поки не зіставився з кліком» | Keitaro надсилає не той параметр: перевірте, що в постбек підставляється саме значення з external_id, а не власний ID кліку трекера |
| «Залишився один крок: вкажіть нашу адресу постбека в налаштуваннях трекера» | Постбек із Keitaro ще жодного разу не надходив |
Додатково зазирніть у розділ Приймання конверсій → Журнал: там останні вхідні повідомлення з результатом — «конверсію зафіксовано», «клік не знайдено», «немає click_id». За результатом одразу видно, на якому кроці рветься ланцюжок.
Яку схему обрати
- Кампанії вже зібрано в Keitaro, і переробляти лендинги не хочеться — схема 1: вона вбудовується в наявний потік і не чіпає сторінок.
- Потрібні перевірка браузера та CR із доходом просто в статистиці клоаки — схема 2: тег або PHP-файл на лендингу плюс постбек із Keitaro.
- Джерело з великою часткою серверного трафіку (натив, пуш, поп) — схеми 1 часто досить, бо такий трафік видно за мережею. Докладніше про майданчики — у розділі джерел трафіку.
- Потрібен лише облік ботів без відсіву — схема 1 з режимом «Трекер» або тіньовим режимом.
Обидві схеми можна поєднувати в різних кампаніях: одна кампанія — один потік, кожен зі своїм способом підключення.
Як перевірити зв’язку перед запуском трафіку
Перш ніж вмикати бюджет, проженіть зв’язку вручну. Це займає десять хвилин і заощаджує день з’ясувань.
- Власний перехід. Відкрийте рекламне посилання з телефона через мобільний інтернет. У журналі кліків ArtisanClo має з’явитися візит із причиною рішення, а в Keitaro — клік у потрібному потоці. Якщо не хочете, щоб ваші тестові переходи перевірялися, додайте свою адресу в білий список IP потоку кнопкою Додати мій IP.
- Перехід із дата-центру. Відкрийте те саме посилання через VPN або із сервера. Візит має піти в потік із White Page, а в журналі — отримати причину на кшталт «VPN або проксі» чи «Ризикована мережа».
- Мітки. Переконайтеся, що мітки кампанії (
utm_campaign,sub1та інші) доходять до Keitaro без втрат: відкрийте картку кліку в журналі ArtisanClo й порівняйте з тим, що записав трекер. - Конверсія. Для схеми 2 надішліть тестову конверсію з Keitaro й перевірте, що рядок стану змінився на «Конверсії вже надходять».
Лише після цього переводьте потік у статус «Активний» і запускайте рекламу.
Типові помилки зв’язки Keitaro і клоаки
- Потік із White Page стоїть вище за потік з офером. Тоді до фільтра візит просто не доходить. Порядок: спершу потік з офером і фільтром «Так», нижче — White Page.
- Фільтр у режимі «Ні». Логіка перевертається: на офер ідуть ті, кого клоака відсіяла.
- Файл фільтра від іншого потоку ArtisanClo. Файл прив’язаний до конкретного потоку, у кожної кампанії — свій.
- Постбек з ID кліку Keitaro замість
external_id. Конверсії приходять, але «кліків не знайдено». - Порівняння цифр за різні дати. Журнал конверсій за замовчуванням відбирає їх за датою надходження, а звіти відносять дохід до дати кліку. Перемкніть журнал на «Дата кліку», і цифри клоаки зійдуться з Keitaro. Про те, як звіряти дохід за статусами, — у статті про статуси конверсій.
Що ви бачите в підсумку
Після зв’язки в ArtisanClo для кожного візиту є причина рішення: «Пропущено на офер», «VPN або проксі», «Бот-верифікатор / спай-сервіс», «Поза розкладом показу» і десятки інших. У Keitaro лишаються гроші, офери й звичні звіти. Якщо щось пішло не так — конверсій менше, ніж зазвичай, прохід упав, — розбір починається з журналу кліків і діагностики потоку, про які розповідаємо в статті чому клік пішов на White Page.
Деталі інтеграції зібрано на сторінці ArtisanClo і Keitaro.
Підсумок
Keitaro і клоака не конкурують, а доповнюють одне одного. Схема з фільтром потоку вбудовується в наявні кампанії за кілька хвилин і вирішує за мережею та ознаками запиту. Схема з тегом або PHP-файлом на лендингу дає повну перевірку браузера, а постбек із Keitaro повертає в клоаку конверсії й дохід. Обирайте залежно від того, де у вас уже стоять кампанії і наскільки глибока перевірка потрібна вашому трафіку.
