Trektik
Назад к документации

Быстрый старт

Семь шагов от создания аккаунта до первой воронки конверсий. Занимает ≈15 минут для разработчика. Используем браузерный SDK @trektik/browser@0.2.2; для других платформ — см. Справочник SDK.

Шаг 1.Создайте проект

Зарегистрируйтесь на app.trektik.ru/register. После регистрации создайте проект в разделе Settings → Projects и сгенерируйте SDK-ключ (тип sdk, префикс pk_) в Settings → API keys.

SDK-ключ публичный — его можно класть в клиентский код. Не путайте с backend-ключом (sk_) для серверных SDK.

Шаг 2.Установите SDK

Через npm — фиксируйте версию для воспроизводимых билдов:

npm install @trektik/browser@0.2.2

Или через CDN (готовый IIFE-bundle):

<script src="https://cdn.trektik.ru/sdk.js"></script>

Шаг 3.Инициализируйте

Минимальная инициализация:

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

const trektik = init({
  apiKey: 'pk_...',
  autocapture: true,   // просмотр страницы, клик, отправка формы, глубина скролла
});

Или, если подключили через CDN — глобальный объект Trektik:

<script>
  Trektik.init({ apiKey: 'pk_...', autocapture: true });
</script>

Шаг 4.Отправляйте события

trektik.track('checkout_started', {
  plan: 'pro',
  amount: 4990,
  currency: 'RUB',
});

trektik.revenue({
  amount: 4990,
  currency: 'RUB',
  productId: 'pro-month',
});
Свойства автоматически делятся на строковые и числовые при записи в ClickHouse — числовые можно агрегировать без кастов.

Шаг 5.Идентифицируйте пользователей

После логина свяжите анонимный device_id с user_id и сохраните свойства:

trektik.identify('user-123', {
  email: 'ivan@example.com',
  plan: 'pro',
});

Шаг 6.Постройте первый отчёт

Откройте app.trektik.ru → раздел События. Первые события появятся в реальном времени — от сбора данных до отображения обычно меньше 10 секунд.

Чтобы построить отчёт по сегментации событий: нажмите «Новый отчёт», выберите событие (например checkout_started), метрику (Количество событий или Уникальных пользователей), интервал (Day/Week), период. Опционально — группировка по свойству (plan, device_type). Сохраните отчёт — он будет доступен для виджета на дашборде.

Если события не приходят: откройте DevTools → Network, проверьте запрос на collect.trektik.ru, статус 200 и валидный apiKey.

Шаг 7.Постройте первую воронку

Перейдите в раздел Воронки → «Новая воронка» и добавьте 2-4 шага: например page_view signup_startedsignup_completed checkout_started.

Укажите окно конверсии (по умолчанию 1 день — подходит для большинства продуктовых воронок) и период для анализа. Трекер покажет % конверсии каждого шага и drop-off; клик по шагу → drill-down в список пользователей, которые на нём застряли.

Включите переключатель «Тренд» чтобы увидеть как меняется конверсия по дням. Это нужно для быстрой диагностики регрессий после релизов.

Что дальше