OneTrace.pro Справка

Переезд с других платформ

Мастер миграции переносит в OneTrace.pro данные из Customer.io, Mindbox и Retail Rocket: профили с атрибутами и идентификаторами, согласия, сегменты, историю событий и сообщений, заказы и шаблоны писем. Перенос можно остановить и продолжить с того же места, а после переезда — догрузить новое.

Раздел находится в меню Данные → Миграция данных. Работать с ним могут роли «Менеджер», «Администратор» и «Владелец» (право «Изменение профилей и импорт»).

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

Платформа Откуда берутся данные Что переносится
Customer.io App API профили и атрибуты, согласия и темы подписок, сегменты, события за последние 30 дней, история сообщений до 12 месяцев, шаблоны писем
Mindbox операции экспорта Mindbox клиенты с доп. полями, балансами и дисконтными картами, подписки, сегментации, объединения клиентов, действия, заказы с позициями
Retail Rocket файлы выгрузок из кабинета база подписчиков, сегменты (каждый — отдельным файлом), события, заказы

Как данные выглядят после переноса:

  • Профили склеиваются по email, телефону и вашему идентификатору клиента. Исходный id платформы сохраняется как Anonymous ID вида mindbox:12345 — по нему удобно искать профиль в разделе Профили.
  • Согласия появляются в карточке профиля в блоке «Подписки» с источником, например «миграция из Mindbox».
  • Сегменты становятся статическими сегментами с текущим составом и названием «Платформа: название». Правила сегментов не переносятся — при необходимости соберите их заново в конструкторе.
  • События и заказы сохраняют исходное время. Заказы приходят событием order_completed с товарами.
  • История сообщений превращается в события отправок, открытий, кликов и отписок.
  • Шаблоны писем попадают в раздел «Шаблоны». Если переменные платформы не удалось преобразовать, к названию шаблона добавляется пометка «нужна правка».

Как запустить миграцию

  1. Нажмите Новая миграция.
  2. Шаг Платформа: выберите Customer.io, Mindbox или Retail Rocket.
  3. Шаг Подключение: укажите название и параметры доступа.
    • Customer.io — регион аккаунта, App API key и глубину истории сообщений.
    • Mindbox — домен API, Endpoint ID, секретный ключ, внешний идентификатор клиента (станет User ID профиля), дату «История с» и имена операций экспорта клиентов, объединений, действий и заказов.
    • Retail Rocket — нажмите Сохранить, затем выберите в поле «Что в файле» тип выгрузки и нажмите Загрузить файл. Подходят CSV, JSON и JSON Lines до 500 МБ, не больше 50 файлов.
  4. Нажмите Проверить подключение: ключ и регион проверяются без импорта данных. Затем — Далее.
  5. Шаг Данные и запуск: в блоке «Что переносить» отметьте нужные виды данных. Кнопка Оценить объём покажет, сколько записей отдаёт платформа.
  6. Прочитайте блок «Что ещё запросить у платформы» — там перечислено, что нужно подготовить на стороне платформы или перенести отдельно.
  7. Нажмите Запустить импорт.

Шаг выбора данных в мастере миграции

Черновик сохраняется на каждом шаге: мастер можно закрыть и вернуться к нему кнопкой Продолжить настройку в карточке миграции.

Ход миграции

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

Карточка миграции с прогрессом

Статус Что означает
Черновик настройка не завершена
В очереди, Идёт данные переносятся
Ждёт платформу Mindbox готовит выгрузку, проверка повторится через минуту
Завершена все выбранные данные перенесены
Ошибка перенос прервался, текст ошибки виден в карточке
Остановлена вы остановили перенос

Ошибки в отдельных записях (например, «В записи нет идентификатора профиля») не останавливают миграцию: первые 20 из них можно раскрыть в блоке «Ошибки в записях».

Остановка, продолжение и дозагрузка

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

Что важно знать

  • Customer.io отдаёт события только за 30 дней. Более раннюю историю выгрузите из исходных систем или через Data Warehouse sync. Объекты и связи, а также список подавленных адресов (suppressions) не переносятся.
  • Mindbox: заранее создайте в Mindbox операции экспорта в формате JSON и включите в них все нужные поля. Для email и телефонов нужна выгрузка без хэширования. Каталог товаров и промокоды Mindbox не выгружает: подключите тот же товарный фид через источники данных.
  • Retail Rocket: колонки файлов распознаются по названиям на русском и английском, остальные колонки базы подписчиков станут трейтами. Шаблоны писем и каталог переносятся вручную.
  • Перенесённые события учитываются в месячном лимите событий тарифа. Если лимит закончится, миграция остановится с ошибкой — после увеличения лимита нажмите Продолжить.
  • Большие объёмы переносятся долго, особенно у Mindbox: каждую выгрузку платформа готовит сама. Можно закрыть страницу — перенос продолжится.