SDK Reference

npm install @trektik/browser

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

// Одна строка -- и всё работает.
// Автоматически включает: autocapture, heatmap, frustration, guides, surveys.
const trektik = init({
  apiKey: 'pk_ваш_ключ',
});

// Записать событие (как в дневнике: "Вася нажал кнопку Купить")
trektik.track('button_click', { button: 'Купить' });

// Сказать кто этот пользователь
trektik.identify('user-123', { name: 'Вася', plan: 'pro' });

import { Trektik, TrektikReplay } from '@trektik/browser';

const sdk = new Trektik();
sdk.init({ apiKey: 'pk_...' });

const replay = new TrektikReplay(sdk, {
  samplingRate: 50,      // записывать 50% сессий
  maskTextInput: true,   // скрывать что вводят в поля
  maxDuration: 1800000,  // максимум 30 минут
});

await replay.start();    // начать запись

replay.isRecording();    // true/false -- идёт ли запись?
replay.stop();           // остановить запись

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

const heatmap = new TrektikHeatmap(
  { apiKey: 'pk_...' },
  { clicks: true, scroll: true, attention: true }
);

heatmap.start();  // начать сбор
heatmap.stop();   // остановить и отправить данные
heatmap.flush();  // отправить накопленное прямо сейчас

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

const frustration = new TrektikFrustration(
  trektik.track.bind(trektik),  // передаём функцию track
  {
    rageClicks: true,       // 3+ клика за 1 секунду
    deadClicks: true,       // клик без реакции (нет изменений DOM за 500мс)
    errorClicks: true,      // клик, после которого ошибка JS за 2с
    thrashedCursor: true,   // хаотичные движения мышью
  }
);

frustration.start();
frustration.stop();

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

const guides = new TrektikGuides(
  { apiKey: 'pk_...' },
  { pollInterval: 60000 }  // проверять новые гайды каждую минуту
);

guides.start();  // начать показ
guides.stop();   // убрать все гайды и прекратить

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

const surveys = new TrektikSurveys(
  { apiKey: 'pk_...' },
  { pollInterval: 60000 }
);

surveys.start();  // начать показ опросов
surveys.stop();   // убрать текущий опрос и прекратить

npm install @trektik/react

import { TrektikProvider, TrackPageView } from '@trektik/react';

export default function RootLayout({ children }) {
  return (
    <TrektikProvider apiKey="pk_ваш_ключ">
      <TrackPageView />
      {children}
    </TrektikProvider>
  );
}

import { useTraektik } from '@trektik/react';

function BuyButton() {
  const { track, identify } = useTraektik();

  return (
    <button onClick={() => track('buy_click', { item: 'Кроссовки' })}>
      Купить
    </button>
  );
}

npm install @trektik/node

import { Trektik } from '@trektik/node';

// На сервере userId передаётся вручную (SDK не знает кто зашёл).
const trektik = new Trektik({ apiKey: 'sk_ваш_ключ' });

trektik.track('user-123', 'purchase', { product: 'Кроссовки', price: 4990 });

// При завершении процесса -- отправить всё
await trektik.shutdown();

pip install trektik

from trektik import Trektik

trektik = Trektik(api_key="sk_ваш_ключ")

trektik.track("user-123", "purchase", {"product": "Кроссовки", "price": 4990})
trektik.identify("user-123", {"email": "vasya@mail.ru"})

# При завершении
trektik.shutdown()

npm install @trektik/react-native

import { TrektikRN } from '@trektik/react-native';

const client = new TrektikRN();

// init -- async, нужно вызвать один раз
await client.init({ apiKey: 'pk_ваш_ключ' });

client.track('button_pressed', { label: 'Sign Up' });
client.identify('user-123', { email: 'vasya@mail.ru' });