Analytics

Описание

Плагин `analyticsPlugin()` встраивает дашборд по адресу `/admin/analytics` и набор REST эндпоинтов под `/api/analytics/*`. Эндпоинты читают отчеты из GA4 Data API через сервисный аккаунт Google. Данные аналитики не записываются в базу, поэтому GA4 остается единственным источником правды. Клиентская часть представляет собой React провайдер. `AnalyticsProvider` вместе с `ga4Provider()` оборачивает фронтенд, подключает `gtag.js` и отправляет события `page_view` при первой загрузке и при каждой смене маршрута. Компоненты `Track`, `TrackPage`, `TrackLeadAction` и хук `useAnalytics` позволяют отправлять события вовлеченности и конверсии `lead_action`. Типы лид-действий настраиваются (например, `phone_click`, `email_click`, `form_submit`). Дашборд показывает KPI, динамику трафика, топ страниц, источников, события, устройства, географию, сессии и пути пользователей. Есть вкладка лид-действий. Опциональная вкладка A/B аналитики интегрируется с пакетом `@focus-reactive/payload-plugin-ab`. Раскладка дашборда расширяется через кастомные блоки, а доступ к эндпоинтам настраивается через функцию доступа. Режим мока позволяет разрабатывать локально без обращений к GA4. Для работы нужны ID свойства GA4, Measurement ID и учетные данные сервисного аккаунта. Пользовательские измерения на уровне события (`fr_session_id`, `fr_lead_type` и другие) и кастомная метрика `fr_elapsed_ms` должны быть зарегистрированы в GA4, чтобы дашборд заполнялся данными. Отчеты наследуют выборку и задержку актуальности данных GA4, поэтому новые события появляются с задержкой в несколько минут.

О пакете

Имя пакета

@focus-reactive/payload-plugin-analytics

Последняя версия

1.2.2

Размер

1,5 МБ

Лицензия

MIT

Загрузок в неделю

568

Последняя публикация

8 июл. 2026 г.