Trektik
Документация

Руководство по работе с Trektik

Простая пошаговая инструкция по каждой функции платформы. Каждый раздел объясняет: что это (одним предложением), зачем нужно и как пользоваться.

Обзор платформы

Что такое Trektik и зачем он нужен

Представьте, что ваш продукт — это магазин. Вы хотите знать: сколько людей зашло, что они смотрели, где застряли, почему ушли и кто купил. Trektik — это камеры, счётчики и аналитик для вашего цифрового продукта. Он показывает всё, что делают пользователи, и помогает принимать решения на основе данных.

Что умеет Trektik:

  • 1. Собирать данные — SDK записывает каждое действие пользователя (клик, просмотр, покупку)
  • 2. Анализировать — воронки, удержание, пути, выручка, события
  • 3. Тестировать — A/B-тесты и feature flags
  • 4. Наблюдать — Session Replay, тепловые карты, фрустрация
  • 5. Уведомлять — алерты в Telegram, Slack, Email, Webhook

Первоначальная настройка

Регистрация, создание проекта, подключение SDK

1

Зарегистрируйтесь

Откройте Trektik и нажмите "Попробовать бесплатно". Введите email, имя и пароль.

Сразу включите двухфакторную аутентификацию в Настройки → Профиль. Trektik поддерживает TOTP (Google Authenticator, Authy, 1Password).
2

Создайте проект

Проект — это как отдельная папка для одного продукта. У каждого проекта свои данные, ключи и настройки. Нажмите на переключатель проектов в боковой панели → "Новый проект" → введите название.

После создания вы получите ключи:

  • pk_...Public Key для клиентских SDK (безопасно встраивать в код)
  • sk_...Secret Key для серверных интеграций (хранить только на сервере!)
3

Подключите SDK

Установка
npm install @trektik/browser
Инициализация
import { Trektik } from '@trektik/browser';

Trektik.init({
  apiKey: 'pk_ваш_ключ',
  serverUrl: 'https://api.trektik.ru',
});
4

Отправьте первое событие

Trektik.track('test_event', { source: 'setup_check' });

Откройте раздел "События" в боковой панели. Если test_event появился — всё работает.

Отправка событий

Как записывать действия пользователей

Событие — это как запись в дневнике: "Пользователь X сделал действие Y в момент Z". Например: "Вася просмотрел страницу /pricing в 14:35".

Примеры событий

Просмотр страницы
Trektik.track('page_view', {
  page_path: '/pricing',
  page_title: 'Тарифы',
});
Покупка (для Revenue-аналитики)
Trektik.trackRevenue({
  amount: 49.99,
  currency: 'USD',
  product_id: 'pro_plan',
  product_name: 'Pro Plan',
});
Идентификация (после логина)
Trektik.identify('user_123', {
  name: 'Alex',
  email: 'alex@example.com',
  plan: 'pro',
});
До вызова identify SDK использует автоматический device_id. После identify все события привязываются к user_id. Это позволяет видеть полный путь: от анонимного визита до покупки.

Правила именования

Хорошо

  • page_view — snake_case
  • signup_complete — понятно что произошло
  • purchase — конкретное действие

Плохо

  • PageView — CamelCase сложнее фильтровать
  • click — непонятно что кликнул
  • event1 — бессмысленное название

Сегментация событий

Графики и таблицы по вашим данным

Сегментация событий — это как рентген для вашего продукта. Вы задаёте вопрос ("сколько раз произошло событие X?") и получаете график с ответом.

Зачем

Чтобы понять тренды: растёт ли активность, какие страницы популярнее, откуда приходят пользователи.

Как пользоваться

1

Откройте «События» в боковой панели

Слева — конструктор запроса, справа — график результатов.

2

Добавьте событие

Введите название события (например, page_view). Можно добавить до 5 событий одновременно, чтобы сравнить их на одном графике.

3

Выберите метрику

Всего, Уникальные пользователи, Среднее, Сумма, Мин, Макс, Медиана, P90, P99. Например, "Уникальные пользователи" покажет сколько разных людей сделали это действие.

4

Добавьте фильтры (необязательно)

Фильтры сужают выборку. Например: "страница равно /pricing" покажет данные только для этой страницы. Фильтры бывают по свойствам событий и по свойствам пользователей. Операторы: равно, не равно, содержит, больше, меньше.

5

Добавьте группировку (необязательно)

Группировка разбивает данные на линии. Например, "Group By: browser" покажет отдельные линии для Chrome, Firefox, Safari. Можно добавить до 2 группировок.

6

Выберите период и интервал

Пресеты: 7, 14, 30, 90 дней. Или выберите свой диапазон дат. Интервал: час, день, неделя, месяц.

7

Нажмите «Запуск»

Результат отобразится как график (линия, столбцы, области) или таблица. Можно переключать вид. Можно скачать CSV и сохранить отчёт.

Можно применить сегмент к запросу — тогда данные будут только по пользователям из выбранного сегмента.

Воронки

Где пользователи отваливаются

Воронка — как труба: наверху входит много воды (пользователей), внизу выходит мало. Мы смотрим, где вода утекает. Если из 1000 зашедших на страницу регистрации только 100 нажали "Зарегистрироваться" — значит 90% утекло на этом шаге.

Зачем

Чтобы найти "дырки" в продукте. Если на каком-то шаге отваливается много людей — значит там надо что-то исправить.

Как пользоваться

1

Откройте «Воронки»

Слева — шаги воронки, справа — результат (полоски с процентами).

2

Добавьте шаги

Минимум 2 шага, максимум 15. Каждый шаг — это событие. Например:

  • Шаг 1: page_view (зашёл на сайт)
  • Шаг 2: signup_start (начал регистрацию)
  • Шаг 3: signup_complete (завершил)

Шаги можно перетаскивать мышкой, чтобы менять порядок.

3

Настройте окно конверсии

Окно конверсии — это сколько времени даётся пользователю, чтобы пройти все шаги. Например, 7 дней. Если пользователь сделал шаг 1 в понедельник, а шаг 2 только через месяц — он не попадёт в воронку.

4

Нажмите «Запуск»

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

Можно группировать по свойству (например, по платформе) — тогда вы увидите отдельные воронки для iOS, Android и Web. Можно применить сегмент для фильтрации.

Удержание (Retention)

Возвращаются ли пользователи

Удержание — это как школьная перекличка: вы набрали класс учеников (когорту) в понедельник, и каждый день проверяете — кто пришёл снова. Если через неделю из 100 учеников ходит только 20 — удержание 20%.

Зачем

Если пользователи не возвращаются — значит продукт не приносит им пользы. Retention — главная метрика здоровья продукта.

Как пользоваться

1

Откройте «Удержание»

Вы увидите форму с настройками и область для результата.

2

Укажите начальное событие

Это событие, по которому формируются когорты. Например, signup_complete — тогда каждый день все новые зарегистрировавшиеся — это отдельная когорта.

3

Укажите возвратное событие

Это событие, которым пользователь "проверяет перекличку". Например, page_view. Если оставить пустым — используется то же самое, что начальное.

4

Выберите настройки

Тип: N-дней, Безграничный, Диапазон. Период: день, неделя, месяц. Глубина: сколько периодов отслеживать (например, 14 дней).

5

Нажмите «Запуск»

Результат можно смотреть в трёх видах:

  • Матрица — цветная таблица (чем темнее — тем больше удержание). Кликните на ячейку, чтобы увидеть пользователей
  • Кривая — средняя кривая удержания по всем когортам
  • Тренд — как удержание на конкретных днях (1, 7, 30) менялось со временем
Включите "Сравнить сегменты", чтобы увидеть кривые удержания для разных групп пользователей на одном графике (до 4 сегментов одновременно).

Пути пользователей (Journeys)

Как пользователи перемещаются по продукту

Пути — это как карта метро: вы видите все маршруты, которыми пользователи добираются из точки А в точку Б. Толстые линии — популярные маршруты, тонкие — редкие. Красные узлы — там, где много людей уходят.

Зачем

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

Как пользоваться

1

Откройте «Пути»

Выберите режим:

  • Прямой путь — "что делают после события X?"
  • Обратный путь — "что делали перед событием X?"
  • Полный путь — от начального до конечного события
2

Укажите начальное/конечное событие

Например: начальное — page_view, чтобы увидеть, что пользователи делают после просмотра.

3

Настройте глубину и исключения

Глубина (3, 5, 7, 10, 15, 20) — сколько шагов отслеживать. Можно исключить шумные события, которые засоряют картину.

4

Нажмите «Запуск»

Результат можно смотреть в трёх видах:

  • Санкей-диаграмма — потоки пользователей между событиями. Кликните на переход, чтобы увидеть пользователей
  • Солнечная диаграмма (Sunburst) — вложенные кольца, каждый уровень — следующий шаг. Можно экспортировать в PNG
  • Таблица путей — топ-20 самых популярных маршрутов
Включите "Сравнить сегменты", чтобы увидеть пути двух сегментов бок о бок (Sankey-диаграммы рядом + таблица различий).

Сегменты

Группы пользователей по правилам

Сегмент — это ярлык на группе пользователей. Представьте корзины с яблоками: в одной — красные, в другой — зелёные. Вы один раз описываете правило ("все красные яблоки") и потом используете эту корзину в любом отчёте.

Зачем

Чтобы сравнивать группы пользователей: "платные vs бесплатные", "мобильные vs десктоп", "активные vs спящие". Сегменты можно использовать в воронках, удержании, путях, событиях.

Как пользоваться

1

Откройте «Сегменты»

Вы увидите список существующих сегментов с количеством пользователей в каждом.

2

Нажмите «Новый сегмент»

Откроется редактор. Введите название и описание.

3

Создайте правила

Правила состоят из групп условий. Два типа условий:

  • По событию: "Выполнил событие X не менее N раз за последние D дней"
  • По свойству: "Свойство plan равно pro"

Условия внутри группы соединяются через AND или OR (переключается кнопкой). Группы между собой тоже через AND или OR.

4

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

Нажмите "Предпросмотр" — система покажет, сколько пользователей попадают в сегмент.

5

Выберите тип

Динамический — пересчитывается автоматически. Статический — фиксированный список.

Дашборды

Ваш пульт управления продуктом

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

Зачем

Чтобы каждое утро открывать один экран и понимать: "Всё хорошо" или "Надо разбираться".

Как пользоваться

1

Откройте «Дашборды»

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

2

Создайте дашборд

Нажмите "Новый дашборд". Выберите:

  • Пустой — начните с чистого листа
  • Шаблон — готовые наборы виджетов (Продуктовая аналитика, Привлечение, Активность, Монетизация и другие)

Если выбрали шаблон — заполните плейсхолдеры (названия событий для вашего продукта) и нажмите "Создать".

3

Добавляйте виджеты

Внутри дашборда добавляйте виджеты: графики событий, воронки, таблицы, числа. Перетаскивайте, изменяйте размер.

Дашборд можно расшарить — настройка "sharing" определяет, кто видит дашборд.

A/B-тесты и Feature Flags

Эксперименты, флаги и постепенный раскат

A/B-тест — это как дегустация: вы даёте одним людям вариант А, другим — вариант Б, и смотрите, что работает лучше. Feature Flag — это выключатель: новая функция есть в коде, но видна только тем, кому вы разрешили.

Страница "Эксперименты" объединяет три вкладки: Feature Flags, A/B тесты и Mutex Groups.

Feature Flags

1

Создайте флаг

Укажите ключ (например, new_checkout), описание и правила таргетинга. Правила определяют, кому показывать: всем, определённому проценту, конкретным пользователям или сегментам.

2

Используйте в коде

const variant = Trektik.getFlag('new_checkout');
if (variant === 'on') {
  showNewCheckout();
}
3

Управляйте

Включайте/выключайте флаг одной кнопкой. Есть Kill Switch для экстренного отключения. Вся история изменений сохраняется.

Progressive Rollout

Постепенный раскат — это план с этапами: сначала 5% пользователей, потом 25%, потом 50%, потом 100%. На каждом этапе вы можете поставить на паузу или откатить назад.

A/B-тесты

1

Создайте эксперимент

Укажите название, ключ флага, варианты (контроль + тестовые), метрику успеха и распределение трафика.

2

Запустите

Нажмите "Старт". Система начнёт распределять пользователей по вариантам через sticky-хеширование (один пользователь всегда видит один вариант).

3

Смотрите результаты

Trektik автоматически считает статистическую значимость. Отображаются: конверсия каждого варианта, p-value, confidence interval. Есть Sequential Testing (можно смотреть результаты на ходу, без waiting period) и калькулятор размера выборки.

4

Завершите

Когда результат стабилен — нажмите "Завершить". Выберите победителя.

Mutex Groups

Если у вас несколько экспериментов одновременно — Mutex-группа гарантирует, что один пользователь не попадёт в два конфликтующих теста.

Алерты

Автоматические уведомления по метрикам

Алерт — это сторожевой пёс для метрик. Вы говорите: "Если ошибок стало больше 100 за минуту — лай!" И система пришлёт уведомление.

Зачем

Чтобы узнавать о проблемах раньше пользователей. Не нужно постоянно смотреть на графики — система сама скажет, когда что-то не так.

Как пользоваться

1

Откройте «Алерты» и нажмите «Новый алерт»

Откроется форма создания.

2

Настройте условие

  • Тип: Порог (метрика превысила значение), Изменение % (метрика изменилась на N%), Нет данных (события перестали приходить)
  • Событие: какое событие отслеживать
  • Метрика: Количество, Уникальные, Среднее, Сумма, Мин, Макс
  • Оператор: больше, меньше, равно
  • Порог: числовое значение
  • Частота проверки: 1 мин, 5 мин, 15 мин, 1 час
3

Добавьте каналы уведомлений

Куда отправлять:

  • Email — на указанный адрес
  • Telegram — личное сообщение или в группу
  • Slack — в канал
  • Webhook — POST-запрос на ваш URL
4

Тестируйте

Нажмите "Тестировать", чтобы проверить, что уведомление доходит. Алерт можно ставить на паузу и возобновлять.

Выручка и LTV

Сколько зарабатывает ваш продукт

Revenue Analytics — это бухгалтерия вашего продукта. Как кассовый аппарат, который не просто считает деньги, но и показывает: кто платит больше, какие продукты популярнее, растёт ли средний чек.

Зачем

Чтобы понимать здоровье бизнеса: растёт ли выручка, какой ARPPU, какой средний чек.

Как пользоваться

1

Отправляйте события о покупках

Trektik.trackRevenue({
  amount: 49.99,
  currency: 'USD',
  product_id: 'pro_plan',
});
2

Откройте «Выручка»

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

3

Выберите метрику и группировку

Метрики: Выручка, Транзакции, ARPPU, Средний чек. Группировка: по продукту, валюте, типу, стране, UTM Source, UTM Campaign.

4

Смотрите топ плательщиков

Внизу страницы — таблица с пользователями, которые заплатили больше всех. Кликните на user_id, чтобы перейти в профиль.

Session Replay

Видеозапись сессий пользователей

Session Replay — это как видеокамера в магазине. Вы видите, что именно делал пользователь: куда кликал, как скроллил, где задумался. Но это не видео — это точное воспроизведение DOM-дерева страницы.

Зачем

Когда цифры не объясняют проблему. Вы видите, что конверсия упала, но не понимаете почему. Replay покажет конкретно: пользователь 5 раз кликнул на кнопку, а она не работала.

Как пользоваться

1

Откройте «Session Replay»

Вы увидите список записанных сессий. Каждая карточка показывает: user_id, URL страницы, длительность, устройство, время начала, количество событий.

2

Фильтруйте

Выберите даты и при необходимости введите user_id, чтобы найти сессии конкретного пользователя.

3

Нажмите на сессию для воспроизведения

Откроется плеер, который воспроизведёт всё, что делал пользователь.

Запись сессий включается в SDK. Данные маскируются: пароли и чувствительные поля не записываются.

Тепловые карты

Где кликают, скроллят и на что смотрят

Тепловая карта — это как термокамера: показывает "горячие" зоны (там кликают много) и "холодные" (там не кликают). Чем краснее точка — тем больше кликов.

Зачем

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

Как пользоваться

1

Откройте «Тепловые карты»

Введите URL страницы и выберите период.

2

Выберите тип карты

  • Клики — цветные точки на координатах кликов (зелёный → жёлтый → красный по интенсивности)
  • Скролл — полоска сбоку показывает, до какой глубины страницы доскроллили пользователи
  • Внимание — на каких элементах пользователи задерживаются (по данным SDK об attention-трекинге)
3

Сравните сегменты

Включите режим сравнения, чтобы увидеть карты двух сегментов бок о бок: например, "мобильные" vs "десктоп".

Наведите курсор на точку — появится подсказка с CSS-селектором элемента и количеством кликов.

Фрустрация

Rage clicks, dead clicks и ошибки

Фрустрация — это детектор злости пользователей. Как датчик дыма: когда пользователь злится и начинает яростно кликать — система это замечает.

Три типа фрустрации

Как пользоваться

1

Откройте «Фрустрация»

Вверху — три карточки с количеством каждого типа за выбранный период.

2

Выберите период

7, 14 или 30 дней. Нажмите "Загрузить" для обновления данных.

3

Изучите детали

В таблице ниже — конкретные случаи: дата, тип, CSS-селектор элемента, URL страницы и user_id. Кликните на user_id, чтобы перейти к Session Replay этого пользователя.

Если Rage Clicks растут — это серьёзный сигнал. Возможно, что-то сломалось в интерфейсе.

In-App Guides

Подсказки, баннеры и модалки внутри продукта

In-App Guides — это как указатели в аэропорту: они помогают пользователю найти нужное, не спрашивая у персонала. Вы можете показать подсказку рядом с кнопкой, баннер вверху страницы или модальное окно с важным сообщением.

Типы гайдов

Как пользоваться

1

Создайте гайд

Выберите тип (tooltip, banner, modal), укажите содержимое (заголовок, текст, кнопки).

2

Настройте таргетинг

На каких страницах показывать (по URL), каким пользователям (по сегменту), сколько раз (один раз, каждый визит).

3

Опубликуйте

Гайд начнёт показываться пользователям. Статистика (показы, клики, закрытия) доступна в реальном времени.

Surveys

Опросы прямо внутри продукта

Surveys — это как анкета у выхода из магазина: "Вам всё понравилось?". Только вместо бумажки — красивая форма прямо в интерфейсе вашего продукта.

Типы опросов

Как пользоваться

1

Создайте опрос

Выберите тип, добавьте вопросы, настройте внешний вид.

2

Настройте условия показа

Когда показывать (после N визитов, на конкретной странице, определённому сегменту).

3

Собирайте ответы

Ответы появляются в реальном времени. Для NPS автоматически считаются Promoters, Passives и Detractors.

Tracking Plan

Порядок в названиях событий

Tracking Plan — это как словарь для вашей команды. Он описывает: какие события существуют, какие свойства у каждого, какие значения допустимы. Без него через полгода у вас будет page_view, PageView,pageView и page-view — и никто не знает, какое правильное.

Зачем

Чтобы данные были чистыми и все в команде говорили на одном языке. Без таксономии данные превращаются в мусор.

Как пользоваться

1

Откройте «Tracking Plan»

Вы увидите список всех зарегистрированных событий с их свойствами и описаниями.

2

Добавьте или отредактируйте событие

Укажите название, описание, список свойств (имя, тип, обязательность, допустимые значения).

3

Используйте для валидации

Когда приходит событие, не описанное в Tracking Plan, оно помечается как "незапланированное" в Data Quality.

Data Quality

Мониторинг чистоты данных

Data Quality — это санитарный инспектор для ваших данных. Он проверяет: нет ли дубликатов, приходят ли все обязательные свойства, не появились ли неизвестные события, нет ли аномалий в объёмах.

Зачем

Плохие данные = плохие решения. Если половина событий приходит без user_id — все отчёты по уникальным пользователям будут врать.

Как пользоваться

1

Откройте «Data Quality»

Вы увидите общий score качества данных и список проблем.

2

Изучите проблемы

Каждая проблема показывает: тип (missing property, unknown event, volume anomaly), серьёзность и количество затронутых событий.

3

Исправьте

Обновите код отправки событий или Tracking Plan. Score обновится автоматически.

Экспорт данных

Выгрузка данных из системы

Экспорт — это "заберу данные с собой". Как копирование файлов на флешку. Нужно для глубокого анализа в Python/R, для загрузки в Data Warehouse или для отчёта в Excel.

Как пользоваться

1

Откройте «Экспорт»

Две вкладки: "Задачи" (разовые выгрузки) и "Расписания" (автоматические).

2

Создайте экспорт

Выберите что экспортировать (события или пользователей), формат (NDJSON или CSV), период дат. Нажмите "Экспортировать".

3

Скачайте файл

Задача появится в списке. Когда статус станет "Готово" — нажмите "Скачать". Для больших выгрузок (миллионы событий) используется фоновая обработка с прогрессом.

4

Настройте расписание (необязательно)

Переключитесь на вкладку "Расписания" и создайте автоматический экспорт: каждый день/неделю/месяц система будет выгружать свежие данные.

Аудит лог

Кто что делал в системе

Аудит лог — это журнал охранника на входе: записывает кто, когда и что сделал. Создал проект, изменил флаг, удалил сегмент — всё записывается.

Зачем

Для безопасности и расследования: "кто выключил флаг на проде в 3 часа ночи?". Также необходим для комплаенса (SOC2, ISO 27001).

Как пользоваться

1

Откройте «Аудит лог»

Таблица с записями: дата, пользователь, действие, IP-адрес, детали (JSON).

2

Фильтруйте

По типу действия (project.create, flag.toggle, experiment.start, user.login и т.д.), по пользователю (email или ID), по дате. Поддерживается поиск по тексту.

3

Листайте

Записи загружаются постранично (50 на страницу). Используйте кнопки "Назад"/"Вперёд".

Настройки

Управление проектом, ключами и интеграциями

Настройки — это пульт управления вашим аккаунтом. Здесь всё, что связано с безопасностью, интеграциями и конфигурацией проекта.

Вкладки настроек

Проект

Название проекта, таймзона, основные параметры

SDK-ключ

Public Key для SDK. Можно скопировать или перегенерировать

API Tokens

Создание и отзыв токенов для серверных интеграций

Webhooks

Отправка данных на ваш сервер при определённых событиях. Можно тестировать и смотреть логи

Kafka

Стриминг событий в вашу Kafka. Настройка брокеров, топика, формата

Telegram

Подключение Telegram-бота для уведомлений. QR-код для быстрого подключения

Slack

Подключение Slack workspace для уведомлений в каналы

Лимиты

Текущее потребление: события, сессии replay, API-вызовы

Профиль

Имя, email, смена пароля, двухфакторная аутентификация (TOTP)

Опасная зона

Удаление проекта. Необратимое действие — все данные будут потеряны

Будьте осторожны с "Опасной зоной". Удаление проекта удаляет все данные, события, сегменты, эксперименты и настройки без возможности восстановления.

Готовы начать?

Установите SDK, отправьте первое событие и начните анализировать данные уже сегодня.