События и параметры

Событие — действие пользователя в приложении, которое SDK передаёт в Tracehub: покупка, регистрация, прохождение уровня. На этой странице — как события появляются в кабинете, как ими управлять и как устроены параметры событий.

Появление событий в кабинете

События не нужно (и нельзя) заводить вручную. SDK отправляет событие по токену, и после первого прихода оно автоматически появляется в каталоге кабинета:

let event = TracehubEvent(eventToken: "level_up")
Tracehub.trackEvent(event)

Карточка появляется в каталоге сама — обычно через несколько секунд после первой отправки. Если карточки нет, обновите страницу; иногда она появляется только после следующей отправки того же события.

Варианты для Kotlin, TypeScript и серверной отправки — см. страницы Android SDK: события и доход, «Web SDK: события и сессии» и документацию S2S API.

Токен события (eventToken) — идентификатор, который вы задаёте в коде приложения. Кабинет его не генерирует и изменить не может.

Токен события неизменен

Если переименовать токен в коде приложения, Tracehub посчитает его новым событием — история старого токена не переедет. Меняйте только отображаемое название в кабинете, а токены в коде держите стабильными.

Каталог событий

Каталог живёт в разделе События кабинета Tracehub. События привязаны к приложению — если каталог пуст, проверьте, что в переключателе приложений в шапке выбрано нужное.

Что показывает таблица:

Колонка	Содержимое
Название	Отображаемое имя события; пока имя не задано — прочерк
Токен	eventToken из кода приложения
Тип	Системное / Стандартное / Пользовательское
Доход	Признак события дохода (см. страницу Доход)
В атрибуции	Тумблер участия события в атрибуции
За 24 ч / За 7 дней	Число приходов события за период
Последнее событие	Время последнего прихода
Статус	Активно / В архиве
Параметры	Число наблюдаемых параметров; отдельным бейджем — сколько из них доступны в отчётах

Вкладки Все / Активные / Доход / В архиве и фильтры по типу события и признаку дохода сужают список; поиск ищет по токену и названию.

События из отладочных сборок попадают в каталог

Они считаются в колонках «За 24 ч» и «За 7 дней» наравне с остальными. Чтобы тестовые данные не смешивались с боевыми, ведите разработку на отдельном тестовом приложении — см. страницу Доход.

Установка

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

Типы событий

Тип определяется автоматически по токену:

Тип	Что попадает
Системное	Служебные события Tracehub (например, установка)
Стандартное	Общепринятые токены: install, session_start, session_end, purchase, signup, login, ad_view
Пользовательское	Все остальные токены

Деление ни на что не влияет, кроме фильтра в каталоге — стандартные и пользовательские события обрабатываются одинаково.

Название события

Токен вроде lvl_10_cmplt в отчётах читается плохо. Дайте событию человекочитаемое имя: ⋯ → Редактировать → Название. Имя показывается в колонке «Название» каталога и в отчётах; чтобы удалить его, очистите поле.

Участие в атрибуции

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

Архив

Событие, которое больше не нужно (опечатка в токене, функция удалена из приложения), отправьте в архив: ⋯ → В архив. Архив мягкий:

• событие пропадает из выпадающих списков (постбэки, алерты и т.д.);
• в каталоге сортируется в конец и живёт на вкладке «В архиве»;
• данные не удаляются, уже настроенные алерты по событию продолжают работать;
• восстановить можно в любой момент — ⋯ → Восстановить.

Удаления событий нет: каталог отражает то, что реально присылало приложение.

Параметры события

Вместе с событием SDK может передать параметры — например, у покупки item_id и payment_method. Кабинет наблюдает параметры автоматически: после первого прихода события с параметром он появляется в списке (кнопка в колонке «Параметры») с типом, который определился по значениям:

Тип	Пример значения
Строка	"card"
Число	10
Да/нет	true
Объект	вложенная структура
Неизвестен	тип пока не определился

У параметра может быть отображаемое имя (колонка «Отображаемое имя» в диалоге параметров); задаётся оно через API.

Где параметры работают, а где нет:

Куда	Попадают ли параметры
Отчёты: фильтр и разбивка	Да, но только после включения «Индексировать»
Постбэки рекламным сетям	Нет
Выгрузка из кабинета	Нет
События, отправленные через S2S API	Не передаются

S2S API не передаёт дополнительные параметры события

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

Индексирование параметров

Наблюдаемый параметр виден в диалоге параметров; в отчётах он доступен только после индексирования. Чтобы фильтровать и разбивать отчёты по параметру, включите ему тумблер Индексировать в редакторе события (⋯ → Редактировать → Параметры события).

Правила индексирования:

• Индексируются только скалярные типы: строка, число, да/нет. Параметр-объект проиндексировать нельзя.
• Тип фиксируется при включении и дальше не «плывёт», даже если приложение начнёт присылать другие значения.
• Индексирование работает с момента включения: история до этого в отчёты по параметру не попадает.
• Имя индексируемого параметра — латинская буква в начале, дальше латиница, цифры и _, не длиннее 64 символов.

У каждого события — фиксированный запас слотов под индексируемые параметры, по типам:

Тип параметра	Слотов на событие
Строка	20
Число	8
Да/нет	4

Запас у каждого события свой: 20 строковых слотов у purchase не мешают 20 строковым у level_up.

Выключение индексирования слот не освобождает

Занятые слоты не возвращаются в запас: повторное включение того же ключа с тем же типом вернёт прежний слот, но смена типа или новый ключ займут новый. Редактор показывает, сколько слотов занято; когда слоты типа закончились, тумблер блокируется — включайте индексирование только там, где параметр правда нужен в отчётах.

Проиндексированные параметры отмечены в диалоге параметров колонкой «В отчётах»; кнопка Отчёт сразу открывает конструктор отчётов с этим событием и параметром.

---