react-fathom

react-fathom 是基于 Fathom Analytics 的隐私优先分析包装库，专为包括网页和移动端在内的 React 应用设计。 它支持路由变化时的自动页面浏览追踪、自定义事件追踪、带货币金额的目标转化追踪，并提供编程式 hooks 和声明式组件以灵活集成。 核心特性： - 零配置搭建：用 FathomProvider 包裹应用并提供 siteId 即可 - 通过 NextFathomProviderApp、NextFathomTrackViewApp 和 NextFathomTrackViewPages 为 Next.js App Router 和 Pages Router 提供自动页面浏览追踪 - React Native 支持：通过专用 /native 导出，利用隐藏的 WebView 加载 Fathom 追踪脚本，支持离线队列和 React Navigation 集成 - 完整的 TypeScript 类型定义 - 支持 Tree-shaking：仅打包所使用的部分 - 默认选项合并：在 FathomProvider 中设置应用级默认值，自动合并到所有追踪调用中 - 嵌套 Provider 支持：子 Provider 可覆盖父级默认值 - 自定义客户端实现：可为 React Native、测试 Mock 或服务端渲染场景提供 FathomClient 接口 - 便捷 Hooks：useTrackOnMount、useTrackOnClick、useTrackOnVisible 覆盖常见追踪模式 - 声明式组件：TrackPageview、TrackClick、TrackVisible 支持基于 JSX 的追踪 - 支持自定义 Fathom 域名 - React Native 中的 App 状态追踪（前台/后台事件） 该包将 fathom-client 作为 peer dependency，兼容 React >= 16.8、Next.js >= 10.0.0 和 React Native >= 0.60.0。Fathom 本身不需要 Cookie，开箱即符合 GDPR、CCPA 和 PECR 合规要求，无需同意横幅。