Руководство по работе с Trektik
Простая пошаговая инструкция по каждой функции платформы. Каждый раздел объясняет: что это (одним предложением), зачем нужно и как пользоваться.
Обзор платформы
Что такое Trektik и зачем он нужен
Представьте, что ваш продукт — это магазин. Вы хотите знать: сколько людей зашло, что они смотрели, где застряли, почему ушли и кто купил. Trektik — это камеры, счётчики и аналитик для вашего цифрового продукта. Он показывает всё, что делают пользователи, и помогает принимать решения на основе данных.
Что умеет Trektik:
- 1. Собирать данные — SDK записывает каждое действие пользователя (клик, просмотр, покупку)
- 2. Анализировать — воронки, удержание, пути, выручка, события
- 3. Тестировать — A/B-тесты и feature flags
- 4. Наблюдать — Session Replay, тепловые карты, фрустрация
- 5. Уведомлять — алерты в Telegram, Slack, Email, Webhook
Первоначальная настройка
Регистрация, создание проекта, подключение SDK
Зарегистрируйтесь
Откройте Trektik и нажмите "Попробовать бесплатно". Введите email, имя и пароль.
Создайте проект
Проект — это как отдельная папка для одного продукта. У каждого проекта свои данные, ключи и настройки. Нажмите на переключатель проектов в боковой панели → "Новый проект" → введите название.
После создания вы получите ключи:
pk_...— Public Key для клиентских SDK (безопасно встраивать в код)sk_...— Secret Key для серверных интеграций (хранить только на сервере!)
Подключите SDK
npm install @trektik/browserimport { Trektik } from '@trektik/browser';
Trektik.init({
apiKey: 'pk_ваш_ключ',
serverUrl: 'https://api.trektik.ru',
});Отправьте первое событие
Trektik.track('test_event', { source: 'setup_check' });Откройте раздел "События" в боковой панели. Если test_event появился — всё работает.
Отправка событий
Как записывать действия пользователей
Событие — это как запись в дневнике: "Пользователь X сделал действие Y в момент Z". Например: "Вася просмотрел страницу /pricing в 14:35".
Примеры событий
Trektik.track('page_view', {
page_path: '/pricing',
page_title: 'Тарифы',
});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_casesignup_complete— понятно что произошлоpurchase— конкретное действие
Плохо
PageView— CamelCase сложнее фильтроватьclick— непонятно что кликнулevent1— бессмысленное название
Сегментация событий
Графики и таблицы по вашим данным
Сегментация событий — это как рентген для вашего продукта. Вы задаёте вопрос ("сколько раз произошло событие X?") и получаете график с ответом.
Зачем
Чтобы понять тренды: растёт ли активность, какие страницы популярнее, откуда приходят пользователи.
Как пользоваться
Откройте «События» в боковой панели
Слева — конструктор запроса, справа — график результатов.
Добавьте событие
Введите название события (например, page_view). Можно добавить до 5 событий одновременно, чтобы сравнить их на одном графике.
Выберите метрику
Всего, Уникальные пользователи, Среднее, Сумма, Мин, Макс, Медиана, P90, P99. Например, "Уникальные пользователи" покажет сколько разных людей сделали это действие.
Добавьте фильтры (необязательно)
Фильтры сужают выборку. Например: "страница равно /pricing" покажет данные только для этой страницы. Фильтры бывают по свойствам событий и по свойствам пользователей. Операторы: равно, не равно, содержит, больше, меньше.
Добавьте группировку (необязательно)
Группировка разбивает данные на линии. Например, "Group By: browser" покажет отдельные линии для Chrome, Firefox, Safari. Можно добавить до 2 группировок.
Выберите период и интервал
Пресеты: 7, 14, 30, 90 дней. Или выберите свой диапазон дат. Интервал: час, день, неделя, месяц.
Нажмите «Запуск»
Результат отобразится как график (линия, столбцы, области) или таблица. Можно переключать вид. Можно скачать CSV и сохранить отчёт.
Воронки
Где пользователи отваливаются
Воронка — как труба: наверху входит много воды (пользователей), внизу выходит мало. Мы смотрим, где вода утекает. Если из 1000 зашедших на страницу регистрации только 100 нажали "Зарегистрироваться" — значит 90% утекло на этом шаге.
Зачем
Чтобы найти "дырки" в продукте. Если на каком-то шаге отваливается много людей — значит там надо что-то исправить.
Как пользоваться
Откройте «Воронки»
Слева — шаги воронки, справа — результат (полоски с процентами).
Добавьте шаги
Минимум 2 шага, максимум 15. Каждый шаг — это событие. Например:
- Шаг 1:
page_view(зашёл на сайт) - Шаг 2:
signup_start(начал регистрацию) - Шаг 3:
signup_complete(завершил)
Шаги можно перетаскивать мышкой, чтобы менять порядок.
Настройте окно конверсии
Окно конверсии — это сколько времени даётся пользователю, чтобы пройти все шаги. Например, 7 дней. Если пользователь сделал шаг 1 в понедельник, а шаг 2 только через месяц — он не попадёт в воронку.
Нажмите «Запуск»
Результат: цветные полоски, каждая показывает сколько людей дошло до этого шага. Красным показано сколько отвалилось. Кликните на полоску, чтобы увидеть конкретных пользователей.
Удержание (Retention)
Возвращаются ли пользователи
Удержание — это как школьная перекличка: вы набрали класс учеников (когорту) в понедельник, и каждый день проверяете — кто пришёл снова. Если через неделю из 100 учеников ходит только 20 — удержание 20%.
Зачем
Если пользователи не возвращаются — значит продукт не приносит им пользы. Retention — главная метрика здоровья продукта.
Как пользоваться
Откройте «Удержание»
Вы увидите форму с настройками и область для результата.
Укажите начальное событие
Это событие, по которому формируются когорты. Например, signup_complete — тогда каждый день все новые зарегистрировавшиеся — это отдельная когорта.
Укажите возвратное событие
Это событие, которым пользователь "проверяет перекличку". Например, page_view. Если оставить пустым — используется то же самое, что начальное.
Выберите настройки
Тип: N-дней, Безграничный, Диапазон. Период: день, неделя, месяц. Глубина: сколько периодов отслеживать (например, 14 дней).
Нажмите «Запуск»
Результат можно смотреть в трёх видах:
- Матрица — цветная таблица (чем темнее — тем больше удержание). Кликните на ячейку, чтобы увидеть пользователей
- Кривая — средняя кривая удержания по всем когортам
- Тренд — как удержание на конкретных днях (1, 7, 30) менялось со временем
Пути пользователей (Journeys)
Как пользователи перемещаются по продукту
Пути — это как карта метро: вы видите все маршруты, которыми пользователи добираются из точки А в точку Б. Толстые линии — популярные маршруты, тонкие — редкие. Красные узлы — там, где много людей уходят.
Зачем
Чтобы увидеть реальные маршруты пользователей — не те, что вы задумали, а те, что они на самом деле проходят. Часто пользователи идут совсем не так, как ожидалось.
Как пользоваться
Откройте «Пути»
Выберите режим:
- Прямой путь — "что делают после события X?"
- Обратный путь — "что делали перед событием X?"
- Полный путь — от начального до конечного события
Укажите начальное/конечное событие
Например: начальное — page_view, чтобы увидеть, что пользователи делают после просмотра.
Настройте глубину и исключения
Глубина (3, 5, 7, 10, 15, 20) — сколько шагов отслеживать. Можно исключить шумные события, которые засоряют картину.
Нажмите «Запуск»
Результат можно смотреть в трёх видах:
- Санкей-диаграмма — потоки пользователей между событиями. Кликните на переход, чтобы увидеть пользователей
- Солнечная диаграмма (Sunburst) — вложенные кольца, каждый уровень — следующий шаг. Можно экспортировать в PNG
- Таблица путей — топ-20 самых популярных маршрутов
Сегменты
Группы пользователей по правилам
Сегмент — это ярлык на группе пользователей. Представьте корзины с яблоками: в одной — красные, в другой — зелёные. Вы один раз описываете правило ("все красные яблоки") и потом используете эту корзину в любом отчёте.
Зачем
Чтобы сравнивать группы пользователей: "платные vs бесплатные", "мобильные vs десктоп", "активные vs спящие". Сегменты можно использовать в воронках, удержании, путях, событиях.
Как пользоваться
Откройте «Сегменты»
Вы увидите список существующих сегментов с количеством пользователей в каждом.
Нажмите «Новый сегмент»
Откроется редактор. Введите название и описание.
Создайте правила
Правила состоят из групп условий. Два типа условий:
- По событию: "Выполнил событие X не менее N раз за последние D дней"
- По свойству: "Свойство plan равно pro"
Условия внутри группы соединяются через AND или OR (переключается кнопкой). Группы между собой тоже через AND или OR.
Проверьте предпросмотром
Нажмите "Предпросмотр" — система покажет, сколько пользователей попадают в сегмент.
Выберите тип
Динамический — пересчитывается автоматически. Статический — фиксированный список.
Дашборды
Ваш пульт управления продуктом
Дашборд — это как приборная панель в самолёте: все важные показатели на одном экране. Вместо того чтобы каждый раз заново строить отчёты, вы собираете их в одном месте и видите всё одним взглядом.
Зачем
Чтобы каждое утро открывать один экран и понимать: "Всё хорошо" или "Надо разбираться".
Как пользоваться
Откройте «Дашборды»
Вы увидите сетку карточек с существующими дашбордами. У каждого — название, дата обновления, тип доступа.
Создайте дашборд
Нажмите "Новый дашборд". Выберите:
- Пустой — начните с чистого листа
- Шаблон — готовые наборы виджетов (Продуктовая аналитика, Привлечение, Активность, Монетизация и другие)
Если выбрали шаблон — заполните плейсхолдеры (названия событий для вашего продукта) и нажмите "Создать".
Добавляйте виджеты
Внутри дашборда добавляйте виджеты: графики событий, воронки, таблицы, числа. Перетаскивайте, изменяйте размер.
A/B-тесты и Feature Flags
Эксперименты, флаги и постепенный раскат
A/B-тест — это как дегустация: вы даёте одним людям вариант А, другим — вариант Б, и смотрите, что работает лучше. Feature Flag — это выключатель: новая функция есть в коде, но видна только тем, кому вы разрешили.
Страница "Эксперименты" объединяет три вкладки: Feature Flags, A/B тесты и Mutex Groups.
Feature Flags
Создайте флаг
Укажите ключ (например, new_checkout), описание и правила таргетинга. Правила определяют, кому показывать: всем, определённому проценту, конкретным пользователям или сегментам.
Используйте в коде
const variant = Trektik.getFlag('new_checkout');
if (variant === 'on') {
showNewCheckout();
}Управляйте
Включайте/выключайте флаг одной кнопкой. Есть Kill Switch для экстренного отключения. Вся история изменений сохраняется.
Progressive Rollout
Постепенный раскат — это план с этапами: сначала 5% пользователей, потом 25%, потом 50%, потом 100%. На каждом этапе вы можете поставить на паузу или откатить назад.
A/B-тесты
Создайте эксперимент
Укажите название, ключ флага, варианты (контроль + тестовые), метрику успеха и распределение трафика.
Запустите
Нажмите "Старт". Система начнёт распределять пользователей по вариантам через sticky-хеширование (один пользователь всегда видит один вариант).
Смотрите результаты
Trektik автоматически считает статистическую значимость. Отображаются: конверсия каждого варианта, p-value, confidence interval. Есть Sequential Testing (можно смотреть результаты на ходу, без waiting period) и калькулятор размера выборки.
Завершите
Когда результат стабилен — нажмите "Завершить". Выберите победителя.
Mutex Groups
Если у вас несколько экспериментов одновременно — Mutex-группа гарантирует, что один пользователь не попадёт в два конфликтующих теста.
Алерты
Автоматические уведомления по метрикам
Алерт — это сторожевой пёс для метрик. Вы говорите: "Если ошибок стало больше 100 за минуту — лай!" И система пришлёт уведомление.
Зачем
Чтобы узнавать о проблемах раньше пользователей. Не нужно постоянно смотреть на графики — система сама скажет, когда что-то не так.
Как пользоваться
Откройте «Алерты» и нажмите «Новый алерт»
Откроется форма создания.
Настройте условие
- Тип: Порог (метрика превысила значение), Изменение % (метрика изменилась на N%), Нет данных (события перестали приходить)
- Событие: какое событие отслеживать
- Метрика: Количество, Уникальные, Среднее, Сумма, Мин, Макс
- Оператор: больше, меньше, равно
- Порог: числовое значение
- Частота проверки: 1 мин, 5 мин, 15 мин, 1 час
Добавьте каналы уведомлений
Куда отправлять:
- Email — на указанный адрес
- Telegram — личное сообщение или в группу
- Slack — в канал
- Webhook — POST-запрос на ваш URL
Тестируйте
Нажмите "Тестировать", чтобы проверить, что уведомление доходит. Алерт можно ставить на паузу и возобновлять.
Выручка и LTV
Сколько зарабатывает ваш продукт
Revenue Analytics — это бухгалтерия вашего продукта. Как кассовый аппарат, который не просто считает деньги, но и показывает: кто платит больше, какие продукты популярнее, растёт ли средний чек.
Зачем
Чтобы понимать здоровье бизнеса: растёт ли выручка, какой ARPPU, какой средний чек.
Как пользоваться
Отправляйте события о покупках
Trektik.trackRevenue({
amount: 49.99,
currency: 'USD',
product_id: 'pro_plan',
});Откройте «Выручка»
Вверху — карточки с ключевыми метриками: общая выручка, количество транзакций, ARPPU, средний чек. Каждая показывает изменение по сравнению с предыдущим периодом.
Выберите метрику и группировку
Метрики: Выручка, Транзакции, ARPPU, Средний чек. Группировка: по продукту, валюте, типу, стране, UTM Source, UTM Campaign.
Смотрите топ плательщиков
Внизу страницы — таблица с пользователями, которые заплатили больше всех. Кликните на user_id, чтобы перейти в профиль.
Session Replay
Видеозапись сессий пользователей
Session Replay — это как видеокамера в магазине. Вы видите, что именно делал пользователь: куда кликал, как скроллил, где задумался. Но это не видео — это точное воспроизведение DOM-дерева страницы.
Зачем
Когда цифры не объясняют проблему. Вы видите, что конверсия упала, но не понимаете почему. Replay покажет конкретно: пользователь 5 раз кликнул на кнопку, а она не работала.
Как пользоваться
Откройте «Session Replay»
Вы увидите список записанных сессий. Каждая карточка показывает: user_id, URL страницы, длительность, устройство, время начала, количество событий.
Фильтруйте
Выберите даты и при необходимости введите user_id, чтобы найти сессии конкретного пользователя.
Нажмите на сессию для воспроизведения
Откроется плеер, который воспроизведёт всё, что делал пользователь.
Тепловые карты
Где кликают, скроллят и на что смотрят
Тепловая карта — это как термокамера: показывает "горячие" зоны (там кликают много) и "холодные" (там не кликают). Чем краснее точка — тем больше кликов.
Зачем
Чтобы понять, куда пользователи реально кликают, как далеко скроллят и на что обращают внимание. Часто оказывается, что важная кнопка — в холодной зоне, а декоративный элемент — в горячей.
Как пользоваться
Откройте «Тепловые карты»
Введите URL страницы и выберите период.
Выберите тип карты
- Клики — цветные точки на координатах кликов (зелёный → жёлтый → красный по интенсивности)
- Скролл — полоска сбоку показывает, до какой глубины страницы доскроллили пользователи
- Внимание — на каких элементах пользователи задерживаются (по данным SDK об attention-трекинге)
Сравните сегменты
Включите режим сравнения, чтобы увидеть карты двух сегментов бок о бок: например, "мобильные" vs "десктоп".
Фрустрация
Rage clicks, dead clicks и ошибки
Фрустрация — это детектор злости пользователей. Как датчик дыма: когда пользователь злится и начинает яростно кликать — система это замечает.
Три типа фрустрации
- Rage Click (яростные клики) — пользователь быстро кликает много раз подряд. Обычно означает: "Почему не работает?!"
- Dead Click (мёртвые клики) — клик на элемент, который ничего не делает. Пользователь думает, что это кнопка, а это просто текст
- Error Click (клики с ошибкой) — клик приводит к JavaScript-ошибке
Как пользоваться
Откройте «Фрустрация»
Вверху — три карточки с количеством каждого типа за выбранный период.
Выберите период
7, 14 или 30 дней. Нажмите "Загрузить" для обновления данных.
Изучите детали
В таблице ниже — конкретные случаи: дата, тип, CSS-селектор элемента, URL страницы и user_id. Кликните на user_id, чтобы перейти к Session Replay этого пользователя.
In-App Guides
Подсказки, баннеры и модалки внутри продукта
In-App Guides — это как указатели в аэропорту: они помогают пользователю найти нужное, не спрашивая у персонала. Вы можете показать подсказку рядом с кнопкой, баннер вверху страницы или модальное окно с важным сообщением.
Типы гайдов
- Tooltip — маленькая подсказка, привязанная к элементу. Для объяснения новых функций
- Banner — полоска вверху или внизу страницы. Для объявлений и промо
- Modal — модальное окно поверх страницы. Для важных сообщений
Как пользоваться
Создайте гайд
Выберите тип (tooltip, banner, modal), укажите содержимое (заголовок, текст, кнопки).
Настройте таргетинг
На каких страницах показывать (по URL), каким пользователям (по сегменту), сколько раз (один раз, каждый визит).
Опубликуйте
Гайд начнёт показываться пользователям. Статистика (показы, клики, закрытия) доступна в реальном времени.
Surveys
Опросы прямо внутри продукта
Surveys — это как анкета у выхода из магазина: "Вам всё понравилось?". Только вместо бумажки — красивая форма прямо в интерфейсе вашего продукта.
Типы опросов
- NPS (Net Promoter Score) — "Насколько вероятно, что вы порекомендуете нас?" (шкала 0-10)
- CSAT (Customer Satisfaction) — "Насколько вы довольны?" (звёзды, эмодзи)
- Свободная форма — любые вопросы с текстовым полем, выбором из списка, чекбоксами
Как пользоваться
Создайте опрос
Выберите тип, добавьте вопросы, настройте внешний вид.
Настройте условия показа
Когда показывать (после N визитов, на конкретной странице, определённому сегменту).
Собирайте ответы
Ответы появляются в реальном времени. Для NPS автоматически считаются Promoters, Passives и Detractors.
Tracking Plan
Порядок в названиях событий
Tracking Plan — это как словарь для вашей команды. Он описывает: какие события существуют, какие свойства у каждого, какие значения допустимы. Без него через полгода у вас будет page_view, PageView,pageView и page-view — и никто не знает, какое правильное.
Зачем
Чтобы данные были чистыми и все в команде говорили на одном языке. Без таксономии данные превращаются в мусор.
Как пользоваться
Откройте «Tracking Plan»
Вы увидите список всех зарегистрированных событий с их свойствами и описаниями.
Добавьте или отредактируйте событие
Укажите название, описание, список свойств (имя, тип, обязательность, допустимые значения).
Используйте для валидации
Когда приходит событие, не описанное в Tracking Plan, оно помечается как "незапланированное" в Data Quality.
Data Quality
Мониторинг чистоты данных
Data Quality — это санитарный инспектор для ваших данных. Он проверяет: нет ли дубликатов, приходят ли все обязательные свойства, не появились ли неизвестные события, нет ли аномалий в объёмах.
Зачем
Плохие данные = плохие решения. Если половина событий приходит без user_id — все отчёты по уникальным пользователям будут врать.
Как пользоваться
Откройте «Data Quality»
Вы увидите общий score качества данных и список проблем.
Изучите проблемы
Каждая проблема показывает: тип (missing property, unknown event, volume anomaly), серьёзность и количество затронутых событий.
Исправьте
Обновите код отправки событий или Tracking Plan. Score обновится автоматически.
Экспорт данных
Выгрузка данных из системы
Экспорт — это "заберу данные с собой". Как копирование файлов на флешку. Нужно для глубокого анализа в Python/R, для загрузки в Data Warehouse или для отчёта в Excel.
Как пользоваться
Откройте «Экспорт»
Две вкладки: "Задачи" (разовые выгрузки) и "Расписания" (автоматические).
Создайте экспорт
Выберите что экспортировать (события или пользователей), формат (NDJSON или CSV), период дат. Нажмите "Экспортировать".
Скачайте файл
Задача появится в списке. Когда статус станет "Готово" — нажмите "Скачать". Для больших выгрузок (миллионы событий) используется фоновая обработка с прогрессом.
Настройте расписание (необязательно)
Переключитесь на вкладку "Расписания" и создайте автоматический экспорт: каждый день/неделю/месяц система будет выгружать свежие данные.
Аудит лог
Кто что делал в системе
Аудит лог — это журнал охранника на входе: записывает кто, когда и что сделал. Создал проект, изменил флаг, удалил сегмент — всё записывается.
Зачем
Для безопасности и расследования: "кто выключил флаг на проде в 3 часа ночи?". Также необходим для комплаенса (SOC2, ISO 27001).
Как пользоваться
Откройте «Аудит лог»
Таблица с записями: дата, пользователь, действие, IP-адрес, детали (JSON).
Фильтруйте
По типу действия (project.create, flag.toggle, experiment.start, user.login и т.д.), по пользователю (email или ID), по дате. Поддерживается поиск по тексту.
Листайте
Записи загружаются постранично (50 на страницу). Используйте кнопки "Назад"/"Вперёд".
Настройки
Управление проектом, ключами и интеграциями
Настройки — это пульт управления вашим аккаунтом. Здесь всё, что связано с безопасностью, интеграциями и конфигурацией проекта.
Вкладки настроек
Проект
Название проекта, таймзона, основные параметры
SDK-ключ
Public Key для SDK. Можно скопировать или перегенерировать
API Tokens
Создание и отзыв токенов для серверных интеграций
Webhooks
Отправка данных на ваш сервер при определённых событиях. Можно тестировать и смотреть логи
Kafka
Стриминг событий в вашу Kafka. Настройка брокеров, топика, формата
Telegram
Подключение Telegram-бота для уведомлений. QR-код для быстрого подключения
Slack
Подключение Slack workspace для уведомлений в каналы
Лимиты
Текущее потребление: события, сессии replay, API-вызовы
Профиль
Имя, email, смена пароля, двухфакторная аутентификация (TOTP)
Опасная зона
Удаление проекта. Необратимое действие — все данные будут потеряны
Готовы начать?
Установите SDK, отправьте первое событие и начните анализировать данные уже сегодня.