События и каталог событий

Событие — действие покупателя или системы: просмотр страницы, добавление в корзину, заказ, открытие письма. Из событий строятся профили, сегменты, триггеры цепочек и отчёты. В разделе Данные → События видно, что приходит в проект прямо сейчас, а в Данные → Каталог — какие события и трейты вообще есть и как они подписаны.

Оба раздела открыты всем участникам проекта. Менять подписи, типы и пометки PII в каталоге могут «Владелец», «Администратор» и «Менеджер».

Откуда приходят события

Источник	Что передаёт
Трекер на сайте	просмотры страниц, действия с товарами, вход — см. Подключение сайта
API с вашего сервера или приложения	заказы, регистрации, смена статусов — см. Интеграция с сервера
Импорт и источники данных	профили из CSV, файлов, S3 и Google Таблиц — см. Импорт файлов и источники данных
Переезд с другой платформы	история профилей и событий — см. Переезд с других платформ
Сам OneTrace.pro	входы в сегменты, шаги цепочек, отправки и открытия сообщений, подписки и отписки

События обрабатываются за несколько секунд после отправки. Повтор события с тем же messageId в течение 24 часов отбрасывается. Время события более чем на час в будущем заменяется временем приёма. Количество событий в месяц ограничено тарифом проекта — см. Настройки проекта, тариф и аудит.

Поток событий

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

Поток событий с раскрытым событием

Что можно делать:

Фильтр по имени. В списке слева выберите событие, например order_completed, — поток покажет только его. «Все события» снимает фильтр.
Пауза. Кнопка Пауза останавливает поток, чтобы спокойно рассмотреть события; Продолжить снова включает его.
Свойства события. Нажмите на строку — раскроются свойства в формате JSON.
Переход в профиль. Номер #… рядом с именем ведёт в карточку профиля.

Справа — состояние соединения: «Подключено», «Подключение…» или «Нет соединения». При очень большом потоке часть событий не показывается на экране, и появляется строка «Пропущено из-за высокой нагрузки: N». Сами события при этом сохраняются — пропуск касается только экрана.

Если у вас нет права видеть персональные данные, email, телефоны и PII-свойства в событиях маскируются. Подробнее — в статье Профили.

Поток удобен, чтобы проверить установку: откройте сайт в соседней вкладке, добавьте товар в корзину и убедитесь, что событие пришло с нужными свойствами.

Каталог данных

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

Вкладка «События»

Таблица событий: Событие (имя), Подпись, Всего (сколько раз приходило) и Последнее (дата последнего). Стрелка слева раскрывает список свойств события с их типами, например amount: number.

Каталог данных, вкладка «События»

Вкладка «Трейты профиля»

Трейты — свойства покупателя: email, имя, город, тариф, дата рождения. Колонки: Ключ, Подпись, Тип и PII.

Каталог данных, вкладка «Трейты профиля»

Как настроить каталог

Введите понятную Подпись, например «Оформил заказ» для order_completed или «Город» для city. Изменение сохраняется сразу.
Для трейта проверьте Тип: string (строка), number (число), boolean (да/нет), datetime (дата и время), list (список), object (объект).
Отметьте PII, если трейт содержит персональные данные: паспорт, адрес, дату рождения.

Как это используется:

Подписи видны в конструкторе сегментов рядом с ключом: «Город (city)». Маркетологу не нужно помнить технические имена.
От типа зависят условия сегментов: для чисел — «больше» и «меньше», для дат — «раньше», «позже» и «за последние». Если тип определился неверно, например дата пришла строкой, исправьте его.
Трейты с пометкой PII маскируются для тех, у кого нет права видеть персональные данные. Email, телефон, имена и адрес отмечаются автоматически.

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

Имена, начинающиеся со знака $, зарезервированы за OneTrace.pro. Отправить своё событие с таким именем нельзя — запрос вернёт ошибку.

Событие	Когда появляется
`$page`, `$identify`, `$alias`	вызовы `cdp.page()`, `cdp.identify()` и склейка идентификаторов
`$segment_entered`, `$segment_exited`	профиль вошёл в сегмент или вышел из него
`$journey_entered`, `$journey_completed`, `$journey_exited`, `$journey_failed`	шаги участия в цепочке
`$message_sent`, `$message_delivered`, `$message_failed`, `$message_skipped`, `$message_bounced`, `$message_complained`, `$message_opened`, `$message_clicked`	судьба отправленных сообщений
`$subscribed`, `$unsubscribed`	изменение согласия на рассылки

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

Советы по именам событий

Называйте события латиницей в snake_case и в прошедшем времени: order_completed, product_viewed, trial_started.
Не помещайте изменяющиеся данные в имя: не order_1001, а order_completed со свойством order_id.
Сумму передавайте числом, а не строкой с валютой: amount: 9980.