INOTrackбыстрота, надежность и ахуенность
Переезд

Переезд с Keitaro и Binom без ручного переноса кампаний

Дай inotrack адрес старого трекера и API-ключ — он сам заберёт партнёрские сети, офферы, источники, ленды и кампании с потоками, весами и фильтрами. Сначала покажет план, потом перенесёт всё на паузе: трафик не сдвинется, пока ты не проверишь и не включишь.

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

Каталог и маршрутизация — целиком

Из Keitaro — через Admin API v1, из Binom — через API v2. Старый трекер импорт только читает.

ЧтоKeitaroBinomВ inotrack
Партнёрские сетиAffiliate networksAffiliate networksРекламодатели (CPA-сети). Из Keitaro: сеть с таким же именем уже есть — оффер привязывается к ней, дубля не будет. Из Binom: при совпадении имени заводится новая сеть с пометкой «(Binom #id)». Офферы без сети собираются в общего рекламодателя.
ОфферыOffers (кроме локальных)OffersОфферы с URL, где макросы заменены нашими (таблица ниже), гео, ставка и валюта. Из Keitaro — ещё дневная капа и параметры партнёрки, дописанные к URL.
Источники трафикаTraffic sourcesTraffic sources (токены t1…t10)Источники: параметры источника → sub1…sub10, шаблон ссылки. Из Keitaro — ещё параметр click id площадки, у Binom его нужно задать руками.
ЛендингиLanding pagesЛендинги путей кампанииЛендинги по внешнему URL. Загруженные в трекер архивы не скачиваются — их нужно залить заново.
Кампании и потокиCampaigns → streamsCampaigns → paths и rulesПотоки «Кампания / Поток»: сплит офферов и лендов с весами, фильтры по гео, устройству, ОС и языку. У Binom пути сводятся в один сплит (вес = доля пути × доля внутри пути), каждое правило — отдельный поток со своими фильтрами.
Как

API-ключ → предпросмотр → импорт

  1. 1

    Адрес трекера и API-ключ

    Keitaro: Account → API keys (Admin API v1). Binom: Settings → блок API внизу страницы, параметр api_key. Ключ живёт только в памяти на время импорта — не сохраняется ни в базе, ни в логах, ни в отчёте.

  2. 2

    Предпросмотр

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

  3. 3

    Импорт в фоне

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

  4. 4

    Проверка и запуск

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

Повторный импорт обновляет уже перенесённое по внешнему id и не создаёт дублей — можно доносить изменения из старого трекера, пока переезжаешь.

Руками

Что останется сделать самому

Постбеки сетей — на новый домен

Постбек-ссылки живут в кабинетах сетей, импорт до них не дотянется. Заведи эндпоинт постбека в inotrack (для популярных сетей есть пресеты) и замени ссылку в кабинете сети на https://<твой-домен>/pb/<токен>?clickid={clickid}…

Архивы лендингов

Локальные ленды Keitaro и архивы Binom не скачиваются: переносится только внешний URL. Ленды, которые лежали внутри трекера, загрузи в inotrack архивом.

Ссылки в рекламных кабинетах

Каждый поток у нас — своя ссылка. Когда поток проверен и включён, замени трекинговую ссылку в кабинете площадки.

То, что в отчёте помечено предупреждением

Фильтры по ИЛИ, триггеры потоков, веса потоков внутри кампании, запасной оффер при капе, sub-метки после 10-й, постбеки в источники Binom — всё это перечислено в отчёте по конкретной сущности. Настрой вручную то, что нужно.

Формат ссылки постбека и пресеты сетей — в документации по постбекам и на странице «Постбеки».

Не переносится

Что остаётся в старом трекере

Ничего не теряется молча: всё, что не перенеслось или перенеслось с потерями, есть в отчёте импорта с причиной.

  • Статистика: клики, конверсии и расходы остаются в старом трекере
  • Домены, пользователи и права доступа
  • Файлы лендингов, загруженные в трекер, и локальные офферы Keitaro
  • Триггеры потоков Keitaro и фильтры, объединённые по ИЛИ
  • Правила Binom с условиями, кроме гео, устройства, ОС и языка, — целиком: поток без части условий ловил бы чужой трафик
Макросы

Таблица соответствия макросов

В URL офферов, лендов и потоков макросы Keitaro и Binom заменяются нашими. Полная таблица — в отчёте каждого импорта; все наши макросы — в справочнике.

inotrackKeitaroBinomПримечание
{clickid}{subid}{clickid}id клика
{sub1}…{sub10}{sub_id_1}…{sub_id_10}{t1}…{t10}—
{geo}{country}, {country_code}{country_code}, {country}ISO-код страны; название страны ({country:ru} в Keitaro) не переносится
{city}{city}{city}—
{device}{device_type}{device_type}desktop, mobile, tablet, tv
{os}{os}{os_name}, {os}—
{browser}{browser}{browser_name}, {browser}—
{source}{ts_id}{traffic_source_id}, {trafficsource}id источника в inotrack
{flow}{campaign_id}, {stream_id}{campaign_id}, {campaign}токен потока inotrack: кампания разворачивается в потоки
{offer}{offer_id}{offer_id}id оффера в inotrack
{campaign}{ad_campaign_id}—кампания площадки (параметр campaign / utm_campaign)
{creative}{creative_id}——
{rnd}{random}—случайный токен; диапазон {random:1,100} не поддержан

Макросы без аналога — {sub_id_11}…{sub_id_30} и {t11}…{t30}, {ip}, {user_agent}, {referrer}, {isp}, {region}, {language}, названия кампаний, офферов и источников — не вырезаются: остаются в URL как есть и попадают в отчёт. Оффер на паузе, поэтому «сырой» макрос не уйдёт в сеть незамеченным.

FAQ

Вопросы

Перенесётся ли статистика из Keitaro или Binom?

Нет. Импорт переносит настройки: сети, офферы, источники, ленды и потоки. Клики и конверсии остаются в старом трекере — исторические CSV-выгрузки можно поднять в отчётах через прямой SQL-доступ к ClickHouse.

Что будет с трафиком, пока идёт переезд?

Ничего. Из Keitaro и Binom импорт только читает, а в inotrack офферы и потоки создаются на паузе. Трафик идёт через старый трекер, пока ты сам не переключишь ссылки в кабинетах.

Можно запустить импорт ещё раз?

Да. Импорт помнит внешний id каждой сущности: повторный запуск обновит уже перенесённое, а не создаст дубли. Статус (пауза или запуск) он не трогает — включённые потоки не встанут на паузу.

Где хранится API-ключ старого трекера?

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

Где запускается импорт?

Сейчас — запросами к API трекера от пользователя с правом записи (баер получает личные записи, админ — командные; viewer импортировать не может): POST /api/internal/import/keitaro/preview и …/run (для Binom — /api/internal/import/binom/…), прогресс и отчёт — GET …/jobs/{id}. Пошаговый мастер в панели готовим.

Можно перенести не все кампании Binom?

Да: в запрос можно передать список id нужных кампаний. Без списка импорт берёт все активные кампании.

В каком тарифе есть импорт?

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

Переезжаешь с Keitaro или Binom?

Поставь inotrack на свой сервер и перенеси кампании импортом. На тарифе Enterprise поможем с миграцией: разберём отчёт и настроим то, что не переносится автоматически.

Вопросы — в Telegram @SmokeJung.

Поддержка