Zaraz 说明文档

# Cloudflare Zaraz Cloudflare Zaraz 专家指南 - 用于在边缘端加载第三方工具的服务器端标签管理器。 ## 什么是 Zaraz？ Zaraz 将第三方脚本（分析、广告、聊天、营销）卸载到 Cloudflare 的边缘，从而提高网站速度、隐私和安全性。对客户端性能零影响。 **核心概念：** - **服务器端执行** - 脚本在 Cloudflare 上运行，而不是在用户的浏览器中 - **单一 HTTP 请求** - 所有工具通过一个端点加载 - **隐私优先** - 控制发送给第三方的数据 - **无客户端 JS 开销** - 最小化浏览器影响 ## 快速入门 1. 导航至 Cloudflare 仪表板中的 域名 > Zaraz 2. 点击“开始设置” 3. 添加工具（Google Analytics、Facebook Pixel 等） 4. 配置触发器（工具何时触发） 5. 将跟踪代码添加到您的网站： javascript // 跟踪页面浏览 zaraz.track('page_view'); // 跟踪自定义事件 zaraz.track('button_click', { button_id: 'cta' }); // 设置用户属性 zaraz.set('userId', 'user_123'); ## 何时使用 Zaraz **在以下情况使用 Zaraz：** - 添加多个第三方工具（分析、广告、营销） - 网站性能至关重要（无客户端 JS 开销） - 需要隐私合规性（GDPR、CCPA） - 非技术团队需要管理工具 **在以下情况直接使用 Workers：** - 构建自定义服务器端跟踪逻辑 - 需要完全控制数据处理 - 与复杂的后端系统集成 - Zaraz 的工具库无法满足需求 ## 本参考内容 | 文件 | 用途 | 何时阅读 | |------|---------|--------------| | [api.md](./api.md) | Web API, zaraz 对象, 许可方法 | 实现跟踪调用时 | | [configuration.md](./configuration.md) | 仪表板设置, 触发器, 工具 | 初始设置, 添加工具时 | | [patterns.md](./patterns.md) | SPA, 电子商务, Worker 集成 | 最佳实践, 常见场景时 | | [gotchas.md](./gotchas.md) | 故障排除, 限制, 陷阱 | 调试问题时 | ## 按任务阅读顺序 | 任务 | 阅读文件 | |------|---------------| | 向网站添加分析 | README → configuration.md | | 跟踪自定义事件 | README → api.md | | 调试跟踪问题 | gotchas.md | | SPA 跟踪 | api.md → patterns.md (SPA 部分) | | 电子商务跟踪 | api.md#ecommerce → patterns.md#ecommerce | | Worker 集成 | patterns.md#worker-integration | | GDPR 合规 | api.md#consent → configuration.md#consent | ## 决策树 你需要什么？ ├─ 在浏览器中跟踪事件 → api.md │ ├─ 页面浏览,