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.
Что значит строка состояния
| Сообщение | Что делать |
|---|---|
| «Приём конверсий настроен и работает» | Ничего — круг замкнут |
| «Постбэки приходят, но клики с такими ID не найдены» | Keitaro шлёт не тот параметр: проверьте, что в постбэк подставляется именно значение из external_id, а не собственный ID клика трекера |
| «Осталось указать URL нашего постбэка в настройках трекера» | Постбэк из 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 возвращает в клоаку конверсии и доход. Выбирайте по тому, где у вас уже стоят кампании и насколько глубокая проверка нужна вашему трафику.
