프로젝트 소개

react-fathom은 웹 및 모바일 플랫폼을 포함한 React 기반 애플리케이션을 위해 설계된 프라이버시 우선 Fathom Analytics 래퍼입니다. 라우트 변경 시 자동 페이지뷰 추적, 커스텀 이벤트 추적, 화폐 가치 포함 목표 전환 추적, 유연한 통합을 위한 프로그래매틱 훅과 선언적 컴포넌트를 모두 지원합니다. 주요 기능: - 제로 설정 구성: FathomProvider로 앱을 감싸 siteId 제공만 하면 됨 - Next.js App Router 및 Pages Router용 NextFathomProviderApp, NextFathomTrackViewApp, NextFathomTrackViewPages를 통한 자동 페이지뷰 추적 - 숨겨진 WebView를 사용해 Fathom 추적 스크립트를 로드하고 오프라인 큐잉 및 React Navigation 통합을 지원하는 전용 /native 내보내기를 통한 React Native 지원 - 완전한 타입 정의와 함께 풀 TypeScript 지원 - 트리 셰이킹 가능: 사용하는 것만 번들에 포함 - 앱 전체 기본값 설정: FathomProvider에서 앱 단위 기본값을 설정하면 모든 추적 호출에 자동으로 병합 - 중첩 provider 지원: 자식 provider가 부모 기본값을 재정의 가능 - 커스텀 클라이언트 구현: React Native, 테스트 모킹 또는 서버사이드 렌더링 환경용 FathomClient 인터페이스 제공 - 편의 훅: useTrackOnMount, useTrackOnClick, useTrackOnVisible 제공 - 선언적 컴포넌트: TrackPageview, TrackClick, TrackVisible - 커스텀 Fathom 도메인 지원 - React Native에서의 앱 상태 추적(포그라운드/백그라운드 이벤트) 이 패키지는 fathom-client를 peer dependency로 필요로 하며, React >= 16.8, Next.js >= 10.0.0, React Native >= 0.60.0에서 동작합니다. Fathom 자체는 쿠키가 필요 없어 컨센트 배너 없이도 GDPR, CCPA, PECR 규정을 기본적으로 준수합니다.