Разделы документации

Перенос из Keitaro

Перенесите кампании и страницы из архива Keitaro при первой установке, проверьте удержания и затем переведите домены.

Перенос выбирается на шаге 2 мастера первого запуска, после подключения HTTPS. Он предназначен для новой установки. В уже работающей панели можно посмотреть результат и разобрать замечания; запустить новый перенос из файла через панель нельзя.

Подходящий архив

Поддерживается архив переноса Keitaro 10, созданный механизмом kctl transfers dump, со статистикой ClickHouse. Обычный ZIP с лендингами, отдельный SQL-дамп и выгрузка Keitaro 11 не подходят. Мастер проверяет формат до записи кампаний.

Сохраните исходный архив отдельно. Micator читает его, не изменяет и не удаляет. Большому архиву нужно место не только под скачанный файл, но и под страницы, подготовку истории и базы. Мастер покажет оценку места; загрузчик истории проверит свободное место ещё раз.

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

  • Кампании с трафиком за выбранный срок и их адреса — alias.
  • Потоки, поддерживаемые фильтры и действия.
  • Источники трафика, партнёрские сети, группы и домены.
  • Офферы, лендинги и подходящие локальные файлы страниц.
  • После запуска — история кликов и конверсий за 90 суток UTC для перенесённых кампаний. Она загружается отдельно, в фоне.

Пользователи, пароли, административные API-ключи и HTTPS-сертификаты Keitaro не переносятся. Владелец Micator создаётся в мастере. Сертификаты для доменов выпускаются заново.

Сохранённый alias позволяет оставить путь рекламной ссылки. До смены DNS проверьте домен и его назначение в Micator. Один только перенос архива не переключает трафик с прежнего сервера.

Архив на другом сервере

  1. На шаге 2 раскройте Перенести из Keitaro.
  2. Выберите Архив на другом сервере.
  3. Укажите IP сервера с архивом, Порт SSH, Логин SSH и полный Путь к файлу архива. По умолчанию порт — 22, логин — root.
  4. Выберите вход паролем или SSH-ключом. Для ключа вставьте приватный ключ; если он защищён паролем, укажите и пароль ключа.
  5. Нажмите Проверить сервер.
  6. Сверьте показанный отпечаток SSH-ключа с сервером, на котором лежит архив. Команда для проверки показана прямо в мастере.
  7. Отметьте Отпечаток совпадает с ключом моего сервера и нажмите Скачать архив.

Скачивание идёт по SFTP. Вкладку можно закрыть: работа продолжится на сервере. Кнопка Остановить прерывает загрузку; при продолжении мастер докачает тот же файл, если исходник не изменился. Доступы придётся ввести заново: мастер их не хранит.

Архив уже на сервере Micator

  1. Выберите Архив уже на этом сервере.
  2. Укажите абсолютный путь, например /var/lib/micator-import/keitaro.tar.gz.
  3. Нажмите Проверить архив.

Файл должен лежать в одном из разрешённых каталогов: /var/lib/micator-import, /var/lib/micator-keitaro, /root, /home, /srv, /mnt, /media, /opt, /data, /backup. Файл по этому пути не загружается из браузера: предварительно скопируйте его на сервер самостоятельно.

Сводка и решения

После чтения архива мастер покажет версию Keitaro, количество объектов, контрольную сумму и варианты срока: 30, 60, 90 или 180 дней. Срок определяет, какие кампании выбирать по наличию трафика; это не срок фоновой истории, для неё используется отдельное окно 90 суток UTC.

Проверьте дополнительные вопросы, если они появились:

РешениеЧто означает
CorporateПо умолчанию кампании с этим условием остаются на паузе. Вариант переноса без условия меняет правила допуска трафика — выбирайте его только осознанно
Выход в сеть из PHPНужен страницам, которые отправляют заявки серверным HTTP/cURL. Разрешайте для проверенного кода, подробнее — PHP с доступом в сеть
РеферерУкажите, откуда прежняя кампания брала реферер: из параметра ссылки или заголовка браузера. Если не знаете, выберите соответствующий вариант и проверьте замечания; после переноса этот ответ в мастере изменить нельзя

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

  1. Введите слово ПЕРЕНЕСТИ и нажмите Подтвердить перенос.
  2. Заполните команду, владельца, пароль и лицензию ниже.
  3. Нажмите Запустить трекер.

Во время записи конфигурации трафик новой установки закрыт. Мастер переносит объекты и файлы, проверяет результат, затем открывает трафик. Кампании с нерешёнными удержаниями остаются на паузе.

После запуска

Откройте Настройки → Перенос из Keitaro. Вкладка доступна владельцу и администратору. Здесь находятся сводка, состояние истории, группы замечаний и кнопка Скачать замечания · CSV.

  1. Подключите базу IP2Proxy, если её требуют правила кампаний.
  2. Раскройте каждую причину удержания и перейдите к указанной кампании или странице.
  3. Исправьте настройки и проверьте переходы и отправку формы.
  4. Если у причины доступна кнопка Проверить и снять удержание…, откройте подтверждение и нажмите Проверить и снять.

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

CSV содержит неснятые замечания, а не полный архив данных. Подробнее о фоновой истории и старых постбеках — История после переноса.

Перевод доменов

  1. Проверьте несколько кампаний по трекинговой ссылке Micator, включая локальные страницы и формы.
  2. Проверьте исходящие постбеки источников и кампаний, внешние шлюзы и макросы.
  3. В мастере постбека выберите перенесённый источник и сеть. Укажите партнёру актуальный адрес постбека Micator, сохранив секрет источника.
  4. Дождитесь нужной истории старых кликов, если по ним ещё придут конверсии.
  5. Переводите DNS доменов по одному. Проверяйте новые клики, конверсии и журнал доставки событий.

Историческая загрузка сама не отправляет накопленные конверсии в рекламные сети. Новый корректный постбек обрабатывается по обычным правилам Micator и с учётом состояния лицензии.

Ошибка или отмена

При отказе мастер показывает причину. Устраните её и нажмите Повторить запуск. Чтобы запустить чистый трекер, выберите Продолжить без переноса: мастер завершит отмену уже начатого переноса перед открытием трафика.

Не удаляйте исходник и рабочие файлы вручную во время операции. Состояние можно прочитать на сервере:

bash
sudo micatorctl keitaro-import --step status

Удаление скачанной копии в мастере относится только к файлу, который скачал Micator. Оно не удаляет оригинал на сервере Keitaro. Пока история использует файл, удаление копии заблокировано.

Обновлено Нужна помощь? ↗