Web Analytics 配置说明

# 配置 ## 设置方法 ### 代理站点 (自动) 仪表板 → Web Analytics → 添加站点 → 选择主机名 → 完成 | 注入选项 | 描述 | |------------------|-------------| | 启用 | 为所有访客自动注入 (默认) | | 启用，排除欧盟 | 不对欧盟访客注入 (GDPR) | | 启用并手动添加代码片段 | 您手动添加信标 | | 禁用 | 暂停跟踪 | **如果响应包含以下内容则会失败:** `Cache-Control: public, no-transform` **需要 CSP:** script-src https://static.cloudflareinsights.com https://cloudflareinsights.com; ### 非代理站点 (手动) 仪表板 → Web Analytics → 添加站点 → 输入主机名 → 复制代码片段 html **限制:** 每个账户最多 10 个非代理站点 ## SPA 模式 **为以下框架启用 `spa: true`:** React Router, Next.js, Vue Router, Nuxt, SvelteKit, Angular **为以下应用保持 `spa: false`:** 传统多页应用、静态站点、WordPress **不支持哈希路由 (`#/path`)** - 请使用 History API 路由。 ## Token 管理 - 查找位置: 仪表板 → Web Analytics → 管理站点 - **非敏感信息** - 域名锁定，在 HTML 中暴露是安全的 - 每个站点拥有唯一的 Token ## 环境配置 typescript // 仅在生产环境加载 if (process.env.NODE_ENV === 'production') { // 加载信标 } 或通过环境变量使用特定环境的 Token。 ## 验证安装 1. DevTools 网络选项卡 → 过滤 `cloudflareinsights` → 查看 `beacon.min.js` + 数据请求 2. 控制台无 CSP/CORS 错误 3. 仪表板在 5-10 分钟延迟后显示页面浏览量 ## 规则 (取决于套餐) 在仪表板中配置： - **采样率** - 减少高流量站点的收集百分比 - **基于路径** - 不同路由有不同行为 - **基于主机** - 每个域名的独立跟踪 ## 数据保留 - 6 个月滚动窗口 - 1 小时桶粒度 - 无原始数据导出，仅限仪表板查看