这个项目能做什么

convex-analytics 是一个 Convex 组件,无需第三方服务即可提供第一方产品和网站分析功能。事件通过高速 HTTP 摄入端点发送,并存储在您自己的 Convex 部署中。 功能特性: - 页面浏览追踪和自定义事件日志记录 - 通过 identify(userId, traits) 进行用户身份识别 - 匿名访客和会话追踪 - 引荐来源、UTM 活动、设备、浏览器、操作系统和国家报告 - 时间序列图表和 KPI 概览仪表板 - 事件属性分解查询 - 原始事件、页面浏览、会话和访客细分列表 - 浏览器 SDK,支持自动批处理、localStorage/sessionStorage 持久化和可选的自动页面浏览 - React Native SDK,使用 AsyncStorage 或自定义存储提供商 - 通过 write-key 作用域站点记录支持多站点 - 原始事件和每小时汇总保留 90 天,每日汇总永久保留 - 可通过定时任务调用显式清理操作 架构由五个 Convex 表组成——sites(站点)、visitors(访客)、sessions(会话)、events(事件,追加模式)和 rollups(小时/日汇总),以及一个将原始事件聚合到汇总的背景工作程序。仪表板查询同时读取原始事件和汇总数据。 安装步骤:添加 npm 包,在 Convex 应用上注册组件,暴露 HTTP 摄入路由,通过引导变更函数配置至少一个站点,然后渲染由认证读取查询支持的 AnalyticsDashboard React 组件。