Пользовательские события

Помимо автоматического трекинга просмотров страниц, вы можете отслеживать любые действия пользователей: клики на кнопки, отправки форм, регистрации, просмотры видео и всё остальное.

Базовый синтаксис

gauss.track('название_события');

gauss.track('название_события', { свойство: 'значение' });

Вызывайте gauss.track() в любом месте вашего JavaScript-кода.

Примеры

Клик на кнопку

document.getElementById('signup-btn').addEventListener('click', () => {
  gauss.track('signup_click');
});

Отправка формы

document.getElementById('contact-form').addEventListener('submit', (e) => {
  gauss.track('form_submit', {
    form: 'contact',
    page: window.location.pathname,
  });
});

Регистрация

// После успешной регистрации пользователя
gauss.track('registration_complete', {
  plan: 'pro',
  source: 'landing',
});

Просмотр видео

video.addEventListener('play', () => {
  gauss.track('video_play', { title: 'Product Demo' });
});

React

function SignupButton() {
  return (
    <button
      onClick={() => gauss.track('signup_click', { location: 'hero' })}
    >
      Начать бесплатно
    </button>
  );
}

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

• Используйте snake_case: button_click, form_submit
• Называйте событие по действию, не по элементу: signup_complete, а не button_clicked
• Максимальная длина названия — 64 символа

Свойства событий

К любому событию можно прикрепить произвольные свойства:

gauss.track('button_click', {
  label: 'Get Started',
  page: '/pricing',
  experiment: 'hero-v2',
});

Свойства отображаются в дашборде в разделе События.

Ограничения:

• Максимум 10 свойств на событие
• Ключ — строка до 64 символов
• Значение — строка или число до 256 символов

Проверка

После вызова gauss.track() событие должно появиться в дашборде → События в течение нескольких секунд. В real-time оно также будет видно в потоке.