Отслеживание пользовательских событий

Что такое пользовательские события?

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

Отслеживание событий с помощью JavaScript

Используйте функцию umami.track() где-нибудь в JavaScript вашего веб-сайта:

// Базовое событие — только имя
umami.track('signup-click');

// Событие с пользовательскими данными
umami.track('download', {
  fileName: 'whitepaper-2026.pdf',
  category: 'resources'
});

// Событие с несколькими свойствами
umami.track('video-play', {
  title: 'Product Demo',
  duration: 120,
  autoplay: false
});

Отслеживание событий с помощью атрибутов HTML

Для простого отслеживания нажатий кнопок вам не нужно писать никакой JavaScript. Просто добавьте атрибут data-umami-event к любому HTML-элементу:

Sign Up



  View Pricing




  Download Report

Любые атрибуты data-umami-event-* становятся пользовательскими свойствами события.

Просмотр данных событий

Перейдите в События на боковой панели в разделе Трафик.

Вы увидите:

• Временная шкала событий — диаграмма, показывающая возникновение событий с течением времени
• Список событий — все отслеживаемые события с их количеством
• Свойства события — щелкните на событие, чтобы увидеть его детализацию пользовательских данных

Идентификация пользователя

Вы также можете идентифицировать посетителей с помощью пользовательских свойств, используя umami.identify():

umami.identify({
  userId: 'user-123',
  plan: 'pro',
  company: 'Acme Corp'
});

Это прикрепляет пользовательские данные к сеансу посетителя, которые затем можно использовать для фильтрации и сегментации.

Распространённые паттерны отслеживания событий

Действие	Имя события	Полезные свойства
Отправка формы	form-submit	formName, formId
Нажатие кнопки	cta-click	location, variant
Загрузка файла	download	fileName, fileType, fileSize
Воспроизведение видео	video-play	title, duration
Поиск	search	query, resultsCount
Добавление в корзину	add-to-cart	productId, price, quantity
Глубина прокрутки	scroll	depth (25, 50, 75, 100)
Ошибка	error	message, page, code

Лучшие практики

• Используйте описательные и последовательные имена. add-to-cart лучше, чем click1.
• Сохраняйте значения свойств в чистоте. Избегайте динамических значений, которые создают слишком много уникальных записей (например, временные метки).
• Отслеживайте результат, а не нажатие. Отслеживайте form-submit, а не submit-button-click.
• Не переусложняйте отслеживание. Сосредоточьтесь на событиях, которые дают практические идеи.

Что дальше?

• → Отслеживание целей конверсии — используйте события как цели конверсии
• → Настройка воронок конверсии — создавайте воронки из событий
• → Отслеживание дохода — добавьте данные дохода к событиям

---

Нужна помощь? Свяжитесь с нами по адресу [email protected].