Переход с Keitaro на Binom: что как называется и как работает

1. Как пользоваться статьей

Если кампании стоят и запуститься нужно сегодня, начните со словаря ниже, раздела 5 про маршрутизацию и раздела 13 про миграцию. Остальное дочитаете потом.

Статья объясняет, как определенные сущности назывались в Keitaro, и как они называются в Binom, где логика совпадает и где нет. Пункты меню Binom названы так, как в документации.

2. Кампания и путь клика

Настраивайте в привычном порядке: домен, источник, партнёрская сеть, оффер, ленд, кампания. Сущности в Binom те же. Отличается то, как кампания выбирает, куда отправить клик. Keitaro проверяет перехватывающие потоки, затем обычные (по позиции или случайно по весу), затем отдаёт клик замыкающему, а без него выполняет Do nothing. В Binom порядок такой:

1. Правила проверяются сверху вниз. Клик уходит в первое правило, где выполнены все критерии, остальные не проверяются.

2. Не подошло ни одно правило – клик идёт в default paths.
3. Внутри правила или среди default paths путь выбирается случайно, по весам.
4. Из пути клик попадает на ленд (или сразу на оффер, если вместо ленда стоит Direct), с ленда – на оффер.

Ссылка кампании в Keitaro – домен плюс идентификатор:example.com/cloudservers. В Binom ссылка (Campaign URL) появляется после сохранения кампании и уже содержит токены источника. Есть и короткая форма без служебных параметров click и key: tracker.com/ключ-кампании?token=value. Ключ задаётся в Advanced settings → Campaign key, это аналог кейтаровского идентификатора.

3. Источники и токены

Создайте источник в Traffic sources → Create, для популярных сетей есть шаблоны (Load from template).

Кейтаровские Sub ID 1–30 в Binom – токены t1–t30. Они включаются галкой Use tokens, у каждого три поля: Parameter (имя параметра в ссылке), Placeholder (макрос источника) и Name (подпись в отчётах). External ID и Cost – отдельные поля, как в Keitaro.

Постбек в источник настраивается в двух местах: Postback URL в источнике и S2S Postback в расширенных настройках кампании. Заполнены оба – уходят оба.

Postback %, Payout % и Traffic loss % в источнике – значения по умолчанию для новых кампаний: правка в источнике уже созданные кампании не меняет, а при расхождении работает значение кампании. Исключение – S2S postback mode (все конверсии, только первая или только подтверждённые схемой E-commerce): он действует на все кампании источника.

Модели расхода – CPC, CPM и CPA. Галка Auto берёт стоимость из параметра, указанного в поле Cost источника. Валюту выбираете в кампании, трекер переводит её в доллары по курсу ЕЦБ. Формула traffic loss та же, что в Keitaro: new CPC = CPC / (1 − losses / 100).

CPuC, CPS и RevShare нет. RevShare собирается так: CPA + Auto, тогда выплата за конверсию умножается на Payout % кампании. Для этого должен срабатывать постбек из настроек источника.

Проблема с «#»

.Некоторые сети, например Adsterra, используют # в токенах. Если источник не подставил значение, браузер считает всё после # якорем, и токены дальше по ссылке до трекера не дойдут. То же со ссылками лендов и офферов. Ставьте такие токены в конец ссылки и проверяйте значения в Clicklog.

4. Лендинги и офферы

Локальный ленд из Keitaro создавайте в Binom интегрированным: в разделе лендингов Create → No-redirect, затем загрузите zip или один файл index.html /index.php. В архиве – один index в корне, размер до 20 МБ. Файлы лежат на сервере трекера и правятся во вкладке Files встроенным редактором. С версии 2.36 так же загружаются офферы: .html, .php или .zip.

Предзагрузки и действия как типов ленда в Binom нет. Импорт превращает предзагрузку во внешний ленд, а действие – в PHP-файл, который его повторяет.

Токены пишутся прямо в HTML: {country}, {isp}, {device_name}. Ссылка на оффер – {offer_link} вместо кейтаровского {offer}. Трекер работает на PHP 8.4 (с версии 2.28), старый PHP-код в лендах проверьте.

Защита от прямого захода.

Для интегрированного ленда включите галку LP Protect в его настройках: html- и php-файлы откроются только после перехода по ссылке кампании. Картинки, CSS и JS остаются доступны напрямую. Дляленда на своём хостинге код берётся в Settings → LP Protect и ставится в начало .php-файла, а в URL ленда добавляется токен LP Key. По умолчанию такой ленд открывается, если с клика прошло не больше 5 минут и совпадают IP и User-Agent.

Скрыть ленд от партнёрки помогает Hide referrer в кампании: Meta refresh, Double meta refresh, Smart meta refresh или None. Свой домен для реферера задаётся в Hide referrer domain. На интегрированном ленде Hide referrer не работает.

У оффера одно поле страны, а не список. Ограничить можно конверсии (Conversion cap) и клики (Click cap)

5. Маршрутизация: потоки, правила, веса, ротации

Чтобы перенести поток, разложите его на две части: фильтры станут правилом, а схема с лендами и офферами – путём внутри этого правила. Документация Keitaro сама сравнивает потоки с правилами Binom, и импорт переносит их так же.

Пример – пуш-кампания:

Порядок правил меняется стрелками в колонке Weight: у правил она отвечает за приоритет, а не за долю трафика. Критерий Bot срабатывает по пометкам модулей защиты, включённых в кампании (раздел 6).

Условия и синтаксис

В Keitaro для фильтров потока выбирается одно отношение: И или ИЛИ. В Binom оно фиксировано: между критериями правила – И, между значениями одного критерия и между правилами – ИЛИ. Поток с ИЛИ между разными фильтрами («страна DE или язык de») переносится двумя правилами с одинаковым путём. Правило копируется иконкой в колонке Actions.

Последняя строка таблицы – частая причина «правило ловит не то». Binom по умолчанию сравнивает частично: критерий iOS 16 поймает и iOS 16.3.1. Где в Keitaro было строгое совпадение (например, фильтр «Параметр»), ставьте Exact match. Операторы «между» , «не меньше» и «не больше» у версий ОС и браузера импорт не переносит: значения остаются, условия перепроверьте.

В критериях Binom работают и сравнения: <{=>100}> – значение от 100, также >, <, =< и <>.

Лимит кликов частично заменяют Click cap на оффере, триггер «клики больше N → выключить элемент» (условие проверяется раз в 60 секунд по умолчанию) и метод FIRST в Binom Protect, если первые клики нужно отдать модераторам на белую страницу. Интервала дат нет – только дни недели и время суток.

Веса и привязка

В Keitaro вес – процент, в Binom – пропорция: ленды с весами 200 и 100 получат две трети и треть трафика. Вес потока соответствует весу пути, веса в схеме – весам лендов и офферов внутри пути. Чтобы убрать ленд, но оставить его тем, кто к нему привязан, ставьте вес 0: так работает в обоих трекерах. Выключенный элемент недоступен и старым кликам.

«Привязать пользователей» в Binom – тип распределения Fix On с теми же вариантами: путь; путь и ленд; путь, ленд и оффер. Поведение отличается. В Keitaro привязанный клик идёт в свой поток, минуя фильтры. В Binom повторный клик каждый раз заново проходит правила: сменилось гео или клик попал под бот-правило – он уйдёт в другое правило.

Ещё два типа распределения. Smart Rotation показывает пользователю путь, ленд и оффер, которых он не видел, и не возвращает на оффер, где он уже сконвертился. Top to bottom задаёт очередь для повторных визитов: первый клик – ленд A, второй – B, третий – C. В Keitaro похожее собирали фильтрами уникальности.

Ротации

На этом слове путаются чаще всего. В Keitaro «ротация» – настройка кампании «Ротация потоков: по позиции или по весу». Веса потоков в Binom задаются в путях кампании, раздел Rotations для этого не нужен.

Rotations в Binom – отдельный объект: шаблон правил и путей, который подключается к нескольким кампаниям живой связью. Правите ротацию один раз – меняются все подключённые кампании. Одна воронка на десять кампаний под разные источники – это одна ротация: сменили в ней оффер, и он сменился везде.

В Keitaro такого объекта нет. Избранные потоки общие для всех кампаний, но при добавлении клонируются. Клонирование в другую кампанию и импорт потоков из JSON тоже создают копии: исходник отредактировали – копии остались прежними. Копирование правил и путей между кампаниями в Binom тоже даёт копию.

Ротация подключается в Rotations → Create → + Campaigns или в настройках кампании вместо значения Custom. После сохранения трафик кампании пойдёт по ротации, а не по собственным путям и правилам кампании.

6. Защита от ботов и клоакинг

Включите защиту в настройках кампании (блоки Binom Protect, Adspect или Magicchecker) и создайте правило с критерием Bot. Модули только помечают клики: без правила помеченный клик пойдёт туда же, куда все.

В Keitaro фильтр «Бот» работает по встроенной базе трекера (краулеры, парсеры, поисковые боты) и вашим спискам IP и User-Agent. Прокси определяется по заголовкам, а VPN фильтруется только с дополнительной базой IP2Location PX2. В Binom устроено так:

• VPN/Proxy-детект бесплатный и включается в любой кампании. Он даётпризнаки VPN/Proxy, Datacenter (хостинги, облака) и Company (госструктуры, вузы, банки), их можно ставить критериями правил.
• Модуль ботов Binom Protect – платная лицензия, одна на все трекеры аккаунта. Пресеты Light, Medium и Paranoid; Light и Medium бывают в режиме Basic only или Basic + JS. По умолчанию документация советует Medium – Basic only.
• Basic-методы работают на сервере за 1–3 мс без лишнего редиректа: по IP (DC, VPN/ABUSE, CORP), по заголовкам (FAKE), по TLS-отпечатку (TLS) и другие. JS-методы добавляют локальный редирект на проверку браузера.
• Research mode проверяет клики всеми методами, но ботами не помечает, данные видны в отчётах. Так можно заранее посмотреть, сколько трафика отрежет защита.
• TLS, TCP и VPN не работают на доменах, проксируемых через Cloudflare.

Ещё три инструмента: галка Mark as bot на правиле (все клики правила считаются ботами); Settings → Stats → Do not assign cost for bot clicks (не начислять расход на новых ботов); &is_bot=1 или &is_bot=0 в ссылке, чтобы принудительно пометить клик при тесте.

Схема из документации для Facebook: белые ленд и оффер в default paths, «чёрный» путь – в правиле с критериями Referrer, Language, Country и Is not bot. Одного правила Is bot / Is not bot документация советует не ограничиваться.

7. Постбеки и конверсии

Адрес постбека Binom – в Settings → Tracking links, для многих сетей есть ьшаблоны на вкладке Aff. networks.

Пример для Binom: https://ваш-домен/click?cnv_id={sub1}&payout={sum}&cnv_status={status}, где {sub1}, {sum} и {status} – макросы партнёрки. В ссылку оффера ID клика передаётся в нужном ей параметре: &sub1={clickid}. Ещё в постбеке работают disable_postback=1 (не слать постбек в источник), disable_upsell=1 и to_offer=N.

Статусы.

В Keitaro есть типы конверсий – lead, sale, rejected, registration, deposit, trash,- а нестандартные статусы сопоставляются параметрами вроде sale_status=approved. В Binom статус – произвольная строка, а переходы между

статусами задают статус-схемы в Postback processing rules: группы статусов и блоки «если – то – иначе». Для e-commerce и подписок есть готовые шаблоны.

Пример: у клика статус lead, приходит reject. Схема находит группу reject, проверяет, что прежний статус – lead, и выполняет блок «то». Если не подошло ни одно условие, срабатывает «иначе», например постбек игнорируется.

Каждый статус должен быть только в одной схеме и одной группе, а события, которые использует схема, лучше держать отдельно от остальных.

Повторные постбеки.

В Keitaro постбек с тем же subid перезаписывает конверсию, а уникальный tid создаёт новую. В Binom выплата по умолчанию заменяется последней. Чтобы выплаты по одному клику складывались (апселлы), включите галку Upsell в оффере; disable_upsell=1 отключает сложение для отдельного постбека.

Разные постбеки в источник по статусам настраиваются в Status-postback relation источника. Секретного ключа в адресе постбека, как в Keitaro, нет; принимать постбеки только с нужных IP можно через белый список на вкладке Aff . networks.

8. Отчёты и статистика

Стройте отчёт по кампании до пяти уровней группировки, детализацию открывайте двойным кликом по строке на любом уровне. Каждый клик со всеми параметрами виден в Clicklog, конверсии – на вкладке Conversions, динамика – в Trends, свои метрики собираются кастомными колонками с формулами. С версии 2.36 токены источника можно группировать сразу по нескольким кампаниям, даже с разными источниками.

Две вещи выглядят как баг трекера, но им не являются:

• Все Android – десятые. С Chrome 110 (февраль 2023) браузер пишет в User- Agent «Android 10» и модель «K» независимо от устройства. Реальную версию и модель Binom получает через Client Hints: включите Use Client hints в Settings → Stats (уточните у поддержки).
• IP и провайдер – Cloudflare. Трафик через Cloudflare WARP приходит с IP Cloudflare: реальный адрес не передаётся, и гео определится по Cloudflare. Обычное проксирование домена через Cloudflare на это не влияет, трекер видит настоящий IP .

Расходы правятся в отчёте кампании: Report → Update costs. Можно выбрать период, токены, только уникальные клики и режим: общая сумма (Costs) или цена клика (CPC). Обновление идёт в фоне, прогресс виден на вкладке Monitor; 1 млн кликов обновляется примерно за 1 ч 45 мин на сервере с 4 ГБ RAM и за 20 мин с 64 ГБ.

9. Домены

Добавьте домен на вкладке Domains: имя в поле и Add new, несколько доменов – каждый с новой строки. Скрипт на сервере не нужен. В DNS направьте домен A-записью на IP сервера или CNAME на основной домен трекера: тогда при смене IP придётся править только основной.

• Index. Аналог кейтаровской Index-страницы – колонка Index на вкладке Domains: любую кампанию можно сделать главной страницей домена. Файлы для корня домена кладутся в папку custom-index через вкладку Files, своя страница 404 – файл 404.php там же.
• SSL выпускается автоматически после добавления домена (уточните у поддержки).
• Лимитов по числу доменов нет. В Keitaro их число зависит от тарифа, на Starter – один домен.

10. Команда: пользователи и права

Пользователей создают в Users → Create. Ролей три:

Права выдаются по типам объектов – кампании, ленды, офферы, ротации, источники, партнёрки, домены, колонки – целиком или поштучно, на уровне Read или Read & Write.

«Полный доступ» из Keitaro – это Read & Write на всеобъекты типа, «Только чтение» – Read, «Выбранные» – права на конкретныеобъекты. Вместо «Ограничения к отчётам» – доступ к колонкам и галка Hide profit (только для роли User).

Когда сотрудник уходит, смены пароля мало: доступ через API у него останется. Заблокируйте его API-ключ в настройках пользователя.

Число пользователей в Binom не ограничено, в Keitaro оно зависит от тарифа (наStarter и Advanced – один).

11. API и автоматизация

API-ключ текущего пользователя лежит в Settings → User, документация с примерами – на вашем трекере по адресу /api/doc. Ключ передаётся в заголовке api-key. Эндпоинты и сущности отличаются от кейтаровского Admin API (/admin_api/v1/), скрипты придётся переписать. Ключ суперадмина открывает все данные, поэтому для внешних сервисов заведите отдельного пользователя с доступом только к нужным кампаниям.

• Click API – PHP-скрипт, который вставляется в начало ленда (код в Settings → Click API). С Magicchecker он несовместим, а клик уходит в трекер уже после перехода на ленд, поэтому Client Hints определяют устройство хуже.
• Triggers – ближайший аналог мониторинга потоков: объект, условие по любой метрике отчёта и действие – включить или выключить элемент, поменять вес, сменить ротацию, написать в T elegram, вызвать вебхук. Условие проверяется раз в 60 секунд по умолчанию; чаще документация не советует, тяжёлые триггеры нагружают сервер.
• Резервная копия – Settings → Import/Export → Binom v2: переносится всё, кроме статистики и интегрированных лендов. Там же включается автобэкап.

12. Сервер и требования

Под Binom нужен чистый сервер на Ubuntu 24.04 или 26.04. Сервер из-под Keitaro (CentOS 9 или 10 Stream) без переустановки ОС не подойдёт.

Минимум: 4 ГБ RAM, 2 ядра, 50 ГБ свободного места, виртуализация KVM, HDD неподдерживается. Установка занимает около 10 минут:

wget https://data.binom.org/binom_v2_install.sh -O /root/binom_v2_install.sh

bash /root/binom_v2_install.sh install

Далее следуйте инструкциям.

После установки Tracker ID вставляется в лицензию в личном кабинете binom.org. Установить трекер может и поддержка.

Диск: в среднем 2 ГБ на 1 млн кликов. Когда свободно меньше 30%, трекер предупреждает; если место кончится, кампании начнут работать некорректно. Хранить клики только за последние N дней можно через Settings → Clearings.

Load на вкладке Monitor – это Load Average, делённый на число ядер: на 4 ядрах при Load Average 2 будет 50%. Выше 80% – пора на сервер мощнее. Во время обновления расходов нагрузка доходит до 100%, это нормально. Zabbix для мониторинга не ставьте, он мешает работе трекера; документация советует Node Exporter + Prometheus.

Цена лицензии не зависит от объёма трафика, числа доменов и пользователей. Заявленный потолок v2 – до 260 млн кликов в сутки.

13. Миграция: что переносится и что настроить руками

Перед импортом проверьте две вещи: у лицензии Keitaro есть Admin API (по документации Keitaro это тарифы Expert, T eam и Enterprise), а Binom установлен с нуля – импорт работает только на «чистый» трекер.

1. В Keitaro создайте API-ключ в профиле, в разделе API-ключей.
2. В Binom откройте Settings → Import/Export → Keitaro и вставьте адрес входа в Keitaro (обычно http://домен/admin) и ключ.

3. Сохраните пароли пользователей: новые пароли показываются в окне импорта.

Статистики в списке переносимого нет.

Кампании с ротацией потоков «по позиции» получают тип распределения Top to bottom, «по весу» без привязки – Normal, с привязкой – соответствующий Fix On. Проверьте тип после импорта: Top to bottom управляет повторными визитами (раздел 5), а правила Binom проверяет сверху вниз при любом типе.

После импорта вручную:

1. Пропишите постбеки Binom в партнёрских сетях (раздел 7).
2. Замените в лендах макросы Keitaro токенами Binom: {offer} → {offer_link}, остальные сверьте со списком токенов в документации.

3. Проверьте валюты и страны офферов.
4. Настройте уникальность: импорт её не переносит (где задаётся срок уникальности, уточните у поддержки).

5. Включите защиту от ботов в кампаниях (раздел 6).
6. Направьте DNS доменов на новый сервер.
7. Пройдите по ссылке каждой кампании и проверьте клик в Clicklog: правило, путь, ленд, токены.

Если в вашем тарифе Keitaro нет Admin API, автоимпорт недоступен. Переносите вручную в том же порядке: источники и партнёрки (есть шаблоны), офферы и ленды, затем кампании.

Комменты