Перейти к документации

Основные понятия

Чтобы использовать Kixo по максимуму, полезно понимать, как в нём устроены данные. Вот основные сущности.

Команды

Команда — верхнеуровневый контейнер в Kixo. Он соответствует вашей организации и хранит все проекты, участников и настройки биллинга. В одной команде может быть несколько участников с разными ролями: Owner, Admin, Member или Viewer, а также Guest Viewer и Guest Editor для внешних сотрудников с доступом только к отдельным проектам.

Проекты

Проект соответствует отдельному продукту или приложению. У каждого проекта свои Project ID, API-ключи, дашборды и настройки кампаний. В рамках одной команды можно создать несколько проектов — например, для веб-приложения и отдельно для мобильного.

Приложения

Приложения — это веб-домены, идентификаторы bundle в iOS и имена пакетов в Android, из которых SDK отправляет трафик в проект. Во время настройки Kixo может автоматически определить первое приложение на платформе. Все последующие идентификаторы приложений должна проверять ваша команда, прежде чем их трафик будет принят, — чтобы утёкшие фрагменты SDK или неожиданные домены не засоряли данные.

События

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

Каждое событие включает:

  • event_type — категория, например screen_view, tap или custom
  • event_name — понятная метка, например HomeScreen или Purchase
  • device_id — уникальный идентификатор устройства
  • session_id — объединяет события в сессии
  • метка времени — время события
  • свойства — произвольные пары «ключ-значение» для дополнительного контекста

Сессии

Сессия — это один период активности пользователя. Kixo начинает новую сессию, когда пользователь возвращается после периода бездействия. Тайм-аут зависит от платформы: Web SDK завершает сессию после 30 минут без активности, а SDK для iOS и Android начинают новую сессию, если приложение возвращается на передний план после 30 секунд в фоне. Это настраивается через sessionTimeout / sessionTimeoutMillis. Сессии используются для расчёта таких метрик, как длительность сессии, число страниц за сессию и показатель отказов.