Web Analytics 说明文档

# Cloudflare Web Analytics 隐私优先的 Web 分析工具，提供核心 Web 指标 (Core Web Vitals)、流量统计和用户洞察，且不影响访客隐私。 ## 概览 Cloudflare Web Analytics 提供： - **核心 Web 指标** - LCP, FID, CLS, INP, TTFB 监控 - **页面浏览量与访问量** - 无需 Cookie 的流量模式分析 - **引荐来源与路径** - 流量来源和热门页面 - **设备与浏览器数据** - 用户代理分析 - **地理数据** - 国家/地区级访客分布 - **隐私优先** - 无 Cookie、无指纹识别、无个人身份信息 (PII) 收集 - **免费** - 无成本，无限页面浏览量 **重要:** Web Analytics 仅通过**仪表板**访问。目前没有用于程序化数据访问的 API。 ## 快速入门决策树 您的网站是否通过 Cloudflare 代理? ├─ 是 → 使用自动注入 (configuration.md) │ ├─ 在仪表板中启用自动注入 │ └─ 无需修改代码 (除非有 Cache-Control: no-transform) │ └─ 否 → 使用手动信标 (beacon) 集成 (integration.md) ├─ 将 JS 代码片段添加到 HTML ├─ React/Vue/Next.js 使用 spa: true └─ 如有需要，配置 CSP ## 阅读顺序 1. **[configuration.md](configuration.md)** - 代理与非代理站点的设置 2. **[integration.md](integration.md)** - 框架特定的信标集成 (React, Next.js, Vue, Nuxt 等) 3. **[patterns.md](patterns.md)** - 常见用例 (性能监控, GDPR 同意, 多站点跟踪) 4. **[gotchas.md](gotchas.md)** - 故障排除 (SPA 跟踪, CSP 问题, 哈希路由限制) ## 何时使用各文件 - **首次设置?** → 从 configuration.md 开始 - **使用 React/Next.js/Vue/Nuxt?** → 前往 integration.md 查看框架代码 - **需要 GDPR 同意加载?** → 查看 patterns.md - **信标未加载或无数据?** → 检查 gotchas.md - **SPA 未跟踪导航?** → 查看 integration.md 获取 `spa: true` 配置 ## 关键概念 ### 代理与非代理站点 | 类型 | 描述 | 信标注入 | 限制 | |------|-------------|------------------|-------| | **代理** | DNS 通过 Cloudflare (橙色云) | 自动或手动 | 无限制 | | **非代理** | 外部托管，手动信标 | 仅手动 | 最多 10 个站点 | ### SPA 模式 **现代框架的关键:** {"token": "YOUR_TOKEN", "spa": true} 如果不设置 `spa: true`，客户端导航（React Router, Vue Router, Next.js 路由）将不会被跟踪。仅会记录初始页面加载。