Глава 06 / 26

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

Событие фиксирует действие, параметры уточняют контекст. Условие отправки записывается точно.

Главное

  • Открытие экрана, загрузка и показ данных — три разных события. Ошибки загрузки измеряйте отдельно.
  • Паспорт события: определение, момент отправки, источник, владелец, параметры.
  • Для платежа добавьте валюту, сумму, товар, ID транзакции и признак тестовой среды.
  • Платёжные события: проверка транзакции и защита от повторной обработки по ID; время действия ≠ время получения.
  • Не пишите в аналитику пароли, платёжные реквизиты, email, свободный текст, точные координаты.

Пример: ядро событий

first_open → onboarding_completed → forecast_viewed
→ location_saved → paywall_viewed → purchase_started
→ trial_started → purchase_verified
→ subscription_renewed / subscription_expired
→ refund_confirmed

Частая ошибка

Называть событие по кнопке, а не по факту. Меню «Поделиться» — это share_sheet_opened, не отправка; нажатие «Оплатить» — не покупка; отключение автопродления — не потеря доступа.

Подробный разбор

Событие (event) фиксирует действие; параметры уточняют контекст. Например, forecast_viewed — прогноз успешно показан, entry_point — откуда пришёл человек. Свойства пользователя описывают язык или тип доступа.

Фиксируйте точное условие: открытие экрана, загрузка и показ данных — разные события. Ошибки загрузки измеряйте отдельно.

Начальный набор событий

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

СобытиеКогда отправлятьЧто помогает узнать
first_openПервый запуск в значении выбранного SDKСколько установок дошло до использования
onboarding_startedНачался вводный сценарийСколько людей увидело обучение
onboarding_completedВыполнен последний обязательный шагГде заканчивается вводный сценарий
forecast_viewedАктуальные данные успешно показаныПолучена ли первая часть пользы
location_savedМесто действительно сохраненоПодготовлен ли повторный сценарий
paywall_viewedЭкран предложения доступен пользователюСколько людей видит монетизацию
purchase_startedНачат процесс покупкиЕсть ли намерение приобрести доступ
trial_startedПодтверждён пробный доступСколько людей начали пробу
purchase_verifiedПодтверждена платная транзакцияСколько покупок состоялось
subscription_renewedПодтверждено очередное списаниеПродлеваются ли подписки
subscription_expiredДоступ закончилсяСколько подписчиков потеряно
refund_confirmedПодтверждён возвратНасколько доход устойчив
share_completedИзвестный приложению факт отправкиИспользуют ли функцию обмена

Открытие системного меню «Поделиться» ещё не означает отправку. Если платформа сообщает только открытие меню, назовите событие share_sheet_opened. Аналогично нажатие кнопки оплаты не считается покупкой, а отключение автопродления не означает немедленную потерю доступа.

Паспорт события

В паспорте события укажите определение, момент отправки, источник, владельца и параметры. Общие параметры: версия, платформа, язык, вариант эксперимента, время. Для платежа добавьте валюту, сумму, товар, ID транзакции и тестовую среду.

Не включайте в аналитику пароли, платёжные реквизиты, email, свободный текст и точные координаты без обоснованной необходимости. Если достаточно региона, передавайте регион. Серверная отправка не отменяет требований к данным.

Защитите смысл данных

Определите, как анонимный пользователь связывается с аккаунтом после входа, что происходит после выхода и как учитываются разные устройства. Не используйте email как открытый идентификатор аналитики. Не считайте переустановку гарантированно новым человеком.

Для событий платежей используйте проверку транзакции и защиту от повторной обработки по её идентификатору. Повторно доставленное уведомление не должно увеличивать выручку второй раз. Отдельно храните время действия и время получения: задержка доставки может менять дневные отчёты.