Об этом проекте
react-fathom — это wrapper для Fathom Analytics, ориентированный на конфиденциальность, разработанный для React-приложений, включая веб и мобильные платформы.
Поддерживает автоматическое отслеживание просмотров страниц при изменении маршрутов, отслеживание кастомных событий, отслеживание конверсий целей с указанием денежных значений, а также предоставляет программные хуки и декларативные компоненты для гибкой интеграции.
Ключевые особенности:
- Настройка без конфигурации: оберните приложение в FathomProvider и укажите siteId
- Автоматическое отслеживание просмотров для Next.js App Router и Pages Router через NextFathomProviderApp, NextFathomTrackViewApp и NextFathomTrackViewPages
- Поддержка React Native через отдельный экспорт /native с использованием скрытого WebView для загрузки скрипта Fathom, с офлайн-очередью и интеграцией с React Navigation
- Полная поддержка TypeScript с полными определениями типов
- Tree-shakeable:.bundle только то, что вы используете
- Слияние параметров по умолчанию: задайте параметры приложения в FathomProvider, которые автоматически сливаются со всеми вызовами отслеживания
- Поддержка вложенных провайдеров: дочерние провайдеры могут переопределять родительские параметры по умолчанию
- Кастомная реализация клиента: предоставьте интерфейс FathomClient для React Native, тестовых моков или серверного рендеринга
- Удобные хуки: useTrackOnMount, useTrackOnClick и useTrackOnVisible для распространённых паттернов отслеживания
- Декларативные компоненты: TrackPageview, TrackClick и TrackVisible для отслеживания на основе JSX
- Поддержка пользовательских доменов Fathom
- Отслеживание состояния приложения в React Native (события foreground/background)
Пакет требует fathom-client как peer-зависимость и работает с React >= 16.8, Next.js >= 10.0.0 и React Native >= 0.60.0. Fathom сам по себе не использует cookies, что обеспечивает соответствие GDPR, CCPA и PECR из коробки, без баннеров согласия.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.