Миграция

Перенос с Amplitude или Mixpanel. Концепты совпадают практически один-в-один, SDK API похож — основная работа это экспорт исторических данных и повторная интеграция SDK.

Соответствие концептов

Amplitude	Тректик
Проект Amplitude	Проект Тректик
Событие	Событие
Свойства события	Свойства события (str_properties / num_properties)
Свойства пользователя	Свойства пользователя
Идентификация	identify()
ID пользователя / ID устройства	user_id / device_id
Эксперимент Amplitude	Эксперимент + флаг функции
Когорты	Сегменты
Поиск путей	Пути пользователей
Анализ воронки	Воронки

SDK — до и после

Было (Amplitude)

import * as amplitude from '@amplitude/analytics-browser';

amplitude.init('AMPLITUDE_KEY');
amplitude.track('checkout_started', { plan: 'pro' });
amplitude.setUserId('user-123');

Стало (Тректик)

import { init } from '@trektik/browser';

const trektik = init({ apiKey: 'pk_...' });
trektik.track('checkout_started', { plan: 'pro' });
trektik.identify('user-123');

Импорт исторических данных

Есть два пути.

1. Через пакетный сбор данных

Экспортируйте события из текущего инструмента (CSV / JSON), преобразуйте в формат Тректик и шлите на /v1/batch батчами до 100 событий.

// Пример: импорт предварительно экспортированных событий
for (const batch of chunks(events, 100)) {
  await fetch('https://collect.trektik.ru/v1/batch', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      api_key: 'pk_...',
      events: batch.map((e) => ({
        event: e.event_type,
        user_id: e.user_id,
        device_id: e.device_id ?? e.user_id,
        timestamp: e.time,
        properties: e.event_properties,
      })),
    }),
  });
}

2. Прямой SQL-импорт в ClickHouse

Для корпоративного плана доступен прямой доступ к ClickHouse — это быстрее для больших объёмов. Обратитесь в поддержку.

Чек-лист миграции

Запросить экспорт исторических событий из текущей системы
Зарегистрироваться, создать проект, получить SDK-ключ
Определить таксономию событий (имена, обязательные свойства) — и внести в раздел таксономии
Заменить SDK в основных клиентах (веб / iOS / Android / бэкенд)
Проверить приём событий в дашборде
Настроить параллельную отправку в обе системы на 1–2 недели для верификации
Импортировать исторические события (пакетно или через SQL)
Перенастроить ключевые отчёты и алерты
Отключить старый инструмент и SDK

Частые вопросы

Совпадут ли числа после импорта?

Обычно да, если соблюдена таксономия и дедупликация. Незначительные расхождения (до 1–2%) возможны из-за разной обработки поздних событий и сессий.

Сохранятся ли user_id?

Да. Передайте тот же user_id, что использовали. Профили объединятся автоматически.

Что с эспериментами?

Исторические эксперименты импортировать не требуется — создайте новые в Тректике. Активные можно переносить постепенно, включая флаг в новом SDK и выключая в старом.