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