Что такое каталог событий
Каталог событий описывает доступные данные: имена событий, смысл параметров, ответственных и историю изменений. Он помогает аналитику выбрать данные для отчёта, а разработчику понять, что отправлять.
Чем каталог отличается от плана трекинга
Эти два слова часто употребляют как синонимы, но у них разные роли. План трекинга отвечает на вопрос, что мы собираемся собирать. Каталог отвечает на другой: что у нас есть сейчас и как этим пользоваться.
План нужен при разработке событий, каталог — при работе с уже собранными данными. История изменений и текущий статус помогают понять, как использовать событие в отчёте.
Что в нём есть
- Событие с описанием: когда отправляется и что означает.
- Параметры с типами, обязательностью и встречавшимися значениями.
- Владелец и статус: активное, черновик или устаревшее.
- История правок и версии плана, которые можно сравнить между собой.
- Документация для разработчиков с готовым фрагментом кода.
- Пометки о персональных данных.
Почему каталога вендора обычно не хватает
Каталоги Amplitude и Mixpanel описывают события соответствующего источника. Если команда использует несколько систем аналитики, ей также нужен общий план и способ проверять данные во всех источниках.
Единый каталог помогает согласовать имена и параметры между источниками.
Каталог, который знает о поломках
В Tarn расхождения отображаются рядом с событием в каталоге. Отсюда можно открыть разбор, уточнить описание или проверить историю изменений. Каталог можно импортировать из подключённого источника.
Как собирается каталог · Как он сверяется с реальными данными
Каталог событий в одном абзаце
Каталог помогает команде понять, что означает событие и как использовать его параметры. Регулярная сверка с поступающими данными показывает, насколько описание соответствует текущей работе продукта.