Переезд с Keitaro за 10 минут

Самое неприятное в смене трекера — не установка, а перенос: десятки кампаний, сотни офферов, источники с настроенными sub-метками. Переносить это руками — дни работы и гарантированные опечатки в ссылках.

В inotrack есть импорт из Keitaro: он читает настройки через Admin API Keitaro и создаёт в inotrack сети, офферы, источники, ленды и потоки. Ваши действия — выпустить два ключа, отправить три запроса и прочитать отчёт; на это хватает десяти минут. Сам импорт идёт фоновым заданием, и его длительность зависит от объёма аккаунта. Ниже — что именно переносится, что нет и в каком порядке переключать трафик, чтобы ничего не потерять.

Что переносит импорт

Keitaro	inotrack
Партнёрские сети	Рекламодатели. Одноимённый уже существующий рекламодатель связывается, а не дублируется; параметр оффера сети дописывается к ссылкам офферов
Офферы	Офферы: ссылка с переведёнными макросами, гео, ставка и валюта, дневная капа
Источники трафика	Источники: параметры sub1–sub10 и шаблон ссылки, параметр внешнего click ID (gclid, fbclid, yclid, ttclid и другие)
Лендинги	Ленды — по URL
Кампании и потоки	Каждый поток Keitaro становится потоком inotrack с именем «Кампания / Поток»: сплит офферов и лендов по весам, фильтры по стране, типу устройства, ОС и языку

Офферы без партнёрской сети попадают к рекламодателю «Keitaro: офферы без партнёрки» — их легко найти и разнести.

Чего импорт не переносит

Честный список — из кода импорта, отчёт о каждой потере вы увидите сами.

• Статистику. Клики, конверсии и историю импорт не читает: в inotrack начинается новая история. Старые отчёты останутся в Keitaro.
• Домены и настройки постбеков. Их нужно настроить в inotrack заново — об этом ниже.
• Локальные ленды и офферы (загруженные архивом в Keitaro). Переносятся только ленды и офферы по внешнему URL; архивы загрузите в inotrack отдельно — хостинг лендов принимает zip.
• Потоки-действия — аналога в inotrack нет. Потоки-редиректы становятся адресом по умолчанию потока.
• Сложные фильтры. Если в потоке несколько фильтров объединены через «ИЛИ», фильтры этого потока не переносятся. Фильтры других типов, триггеры и веса потоков внутри кампании — тоже. Перехватывающие и дефолтные потоки переносятся отдельными потоками, но без своей роли: приоритет и запасной маршрут настройте заново. Всё это попадает в отчёт как предупреждение.
• Стоимость кампаний и CPC-ставки. Расходы в inotrack идут из интеграции с рекламным кабинетом или вручную, а CPC-выплаты импортируются как CPA — с предупреждением.
• Макросы без аналога. Большинство макросов Keitaro переводятся: {subid} → {clickid}, {sub_id_1}…{sub_id_10} → {sub1}…{sub10}, {country} → {geo}. То, чему аналога нет, остаётся в ссылке как есть и попадает в таблицу макросов отчёта.

Принцип, зашитый в импорт: отчёт не должен молчать ни об одной потере.

Что нужно до начала

1. Установленный inotrack. Если ещё не стоит — установка одной командой на чистый VPS.
2. Ключ Admin API Keitaro. Создаётся в настройках Keitaro; импорт только читает данные, ничего в Keitaro не меняет. Ключ не сохраняется в inotrack — он живёт только в памяти запроса и задания.
3. Keitaro доступен по HTTPS с публичного адреса. Из соображений безопасности импорт не ходит на http и на внутренние адреса.
4. API-токен inotrack со scope write. Выпускается в админке: «Настройки» → API-токены. Импорт создаёт записи от имени владельца токена; роль «только чтение» импорт запустить не может.

Раздела импорта в интерфейсе админки пока нет — запуск делается тремя запросами к API панели. Ниже они целиком.

Шаг 1. Предпросмотр

Предпросмотр читает Keitaro и показывает, что будет создано и обновлено, ничего не записывая:

curl -X POST https://<панель>/api/internal/import/keitaro/preview \
  -H "Authorization: Bearer <токен inotrack>" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://<ваш-keitaro>", "api_key": "<ключ Admin API>"}'

В ответе — отчёт: сколько сущностей каждого типа будет создано, обновлено, связано или пропущено, конфликты имён, предупреждения по каждому элементу и полная таблица перевода макросов.

На что смотреть:

• Конфликты имён. Если в inotrack уже есть оффер или поток с тем же именем, созданный не импортом, отчёт предупредит: «будет создана ещё одна запись».
• Предупреждения по потокам. Сложные фильтры и триггеры придётся воспроизвести вручную.
• Таблица макросов. Строки без аналога — кандидаты на ручную правку ссылок.

Если Keitaro отклонил ключ, ответ скажет об этом прямо; то же — если лицензия инстанса Keitaro не активна.

Шаг 2. Импорт

Тот же запрос на адрес /run запускает фоновое задание и сразу возвращает его идентификатор:

curl -X POST https://<панель>/api/internal/import/keitaro/run \
  -H "Authorization: Bearer <токен inotrack>" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://<ваш-keitaro>", "api_key": "<ключ Admin API>"}'

Шаг 3. Статус и отчёт

curl https://<панель>/api/internal/import/keitaro/jobs/<id> \
  -H "Authorization: Bearer <токен inotrack>"

Задание сообщает статус (идёт, готово, ошибка), прогресс и итоговый отчёт. Одно задание на пользователя и инстанс Keitaro за раз; лимит одного задания — 30 минут. Если не уложилось, уже записанное сохраняется, и повторный запуск продолжит без дублей. Запуск импорта пишется в журнал действий.

Из чего складываются десять минут

Чтобы не было разочарования, разложим время по шагам. Десять минут — это ваши действия: выпустить ключ Admin API в Keitaro и токен в inotrack, отправить запрос предпросмотра, прочитать сводку отчёта и запустить импорт. Сколько будет идти само задание, зависит от числа кампаний и потоков в аккаунте: импорт читает кампании страницами по 500 и потоки каждой кампании отдельными запросами. Аккаунт больше 5000 кампаний за один прогон не импортируется — отчёт об этом скажет.

Отдельно — время на то, что импорт не делает: домены, постбеки в кабинетах сетей, ленды из архивов и сложные фильтры. Его стоит заложить в план переезда, а не в первый вечер.

Импорт из Binom устроен так же: предпросмотр, фоновое задание, отчёт, повторный запуск без дублей.

Повторный импорт

Импорт идемпотентен: каждая перенесённая сущность запоминает свой идентификатор в Keitaro. Повторный запуск находит её и обновляет поля, не создавая копий. Статус — пауза или активен — при обновлении не меняется, рекламодатели повторно не трогаются. Это удобно на время переезда: пока вы правите кампании в Keitaro, inotrack можно догонять повторными запусками.

Что сделать после импорта

Импортированные офферы, ленды и потоки создаются на паузе — трафик на них не пойдёт, пока вы их не включите. Это сделано специально: сначала проверка, потом переключение.

1. Пройдитесь по предупреждениям отчёта. Задайте запасные офферы потоков, воспроизведите сложные фильтры, поправьте ссылки с непереведёнными макросами. Если источник передавал нестандартный click ID — передайте его через sub-метку.
2. Подключите домены. Трекинг-домены добавляются в разделе «Домены» админки или командой tracker-ctl domain add. DNS домена должен указывать на сервер inotrack.
3. Настройте постбеки. В разделе «Постбэки» создайте подключение для каждой сети — с пресетом, если он есть, или своим маппингом. Как это сделать для конкретных сетей, разобрано в статье о постбеках Unicom24, Leads.su и Admitad. Новый постбек-URL нужно добавить в кабинет сети.
4. Подключите расходы. Если считали ROI по стоимости из Keitaro — подключите рекламные кабинеты в inotrack: импорт расходов.
5. Пропустите тестовый клик. Включите один поток, откройте его трекинговую ссылку и проверьте, что клик попал в отчёт, а в ссылке оффера подставился clickid.

Как переключать трафик без потерь

Главный риск переезда — конверсии по старым кликам. Сеть пришлёт постбек на clickid, который знает только Keitaro, и если Keitaro уже выключен, конверсия потеряется.

Порядок, который этого избегает:

1. Оставьте постбеки Keitaro в кабинетах сетей. Если сеть позволяет несколько постбеков, добавьте постбек inotrack вторым, а не вместо старого. Если сеть разрешает только один постбек, переключайте его в последнюю очередь, когда трафик уже идёт через inotrack, а конверсии по старым кликам сверяйте с отчётом сети.
2. Переключайте ссылки в рекламных кабинетах по одной кампании. Новая кампания — новая трекинговая ссылка inotrack.
3. Сверяйте цифры. Первые дни смотрите одну и ту же кампанию в обоих трекерах и в кабинете сети.
4. Выключайте Keitaro, когда закончится окно атрибуции. Пока по старым кликам могут прийти конверсии, Keitaro должен их принимать. Длина окна зависит от оффера — для заявок с долгим холдом это может быть несколько недель.

Потоки после переезда

Перенесённые потоки работают по тем же правилам, что были в Keitaro: веса, гео, устройства. Но в inotrack у потока есть то, чего могло не быть раньше: атомарные капы в Redis, правила по метрикам, ротация по EPC и правка без рестарта. Всё это — на странице потоков.

Если нужна помощь

На тарифе Enterprise помощь с миграцией с Keitaro и Binom входит в тариф — смотрите тарифы. Если вы выбираете трекер не только по удобству переезда, пригодится чек-лист как выбрать трекер для арбитража.