这个项目能做什么

本仓库是一个基于 Tinybird Events API 和 Endpoints 构建 Web 分析平台的模板。它强调隐私和速度,README 指出用户无需预先了解 Tinybird,即可在几分钟内通过预置仪表盘获取实时指标。设置完成后,用户可以针对电子商务或营销等用例添加自定义事件,同时保持实时性能。 设置步骤:克隆仓库,进入 tinybird 目录,使用 pnpm 安装依赖,登录 Tinybird 并部署。通过在网站 head 部分放置带有 tracker token 的脚本片段即可启用追踪。README 预期在访问者浏览和与网站交互时产生 page_hit 事件。自定义事件可通过 Tinybird.trackEvent 发送。自定义属性使用 data-tb_ 前缀,并存储在 analytics_events 数据源的 payload 列中,随每个事件一同发送。多租户和多域名支持通过 data-domain 和 data-tenant-id 参数实现。所有项目端点均可通过 tenant_id 和 domain 进行过滤,或者通过 JWT token 携带 fixed_params。 该追踪器还通过 web-vitals 库支持 Web Vitals。带有 web_vital 操作的事件包含 LCP、TTFB、FCP、INP 和 CLS 等指标。用户可以在 analytics.tinybird.live 访问预置仪表盘,只需粘贴工作区管理员 token 即可。仪表盘 token 同样从 Tinybird 获取。高级部分指向独立的 tinybird 和 dashboard README 以进行本地开发;pnpm dev 将更改同步到 Tinybird 分支,pnpm deploy 用于生产环境。用户需创建包含 TINYBIRD_TOKEN 和 TINYBIRD_HOST 值的 .env.local 文件。用户还可以自定义并在 Vercel 上托管自己的仪表盘。README 提到 Tinybird 作为一个平台符合 GDPR 标准,但用户仍需负责遵守关于数据收集和同意的 GDPR 规则。