以下是最常见问题的解答。如果你找不到所需答案，请参阅 社区页面 ↗ 或 Discord 频道 ↗ 探索更多资源。
若要了解 Zaraz 定价相关信息，请参阅 Zaraz 定价 页面。
如果你在使用 Zaraz 时遇到问题，可能有多种原因。首先，请确认 Zaraz 脚本是否在你的网站上正确加载。
要检查脚本是否正确加载，请按以下步骤操作：
- 在网页浏览器中打开你的网站。
- 打开浏览器的开发者工具。
- 在控制台中输入
zaraz。 - 如果你看到错误消息
zaraz is not defined，说明 Zaraz 未能加载。
如果 Zaraz 未加载，请验证以下内容：
- 运行 Zaraz 的域名 由 Cloudflare 代理。
- 已在 Zaraz 设置 中启用自动注入。
- 网站的 HTML 有效，并包含
<head>与</head>标签。 - 你在 Zaraz 中至少配置了 一个已启用的工具。
Zaraz 在服务端加载工具，因此在浏览器中运行的代码无法看到它。在服务端运行工具对网站性能与隐私更好，但也意味着你无法使用常规浏览器扩展调试 Zaraz 工具。
可以。你可以使用 Zaraz Monitoring 中的指标以及 调试模式 来帮助定位问题发生在工作流的哪一步。
我们建议在使用 Zaraz 时禁用 Rocket Loader。虽然 Zaraz 可以与 Rocket Loader 一起使用，但通常无需两者并用。Rocket Loader 有时会延迟数据到达 Zaraz，从而导致问题。
是。要了解 Zaraz 与 CSP 配置的兼容性如何工作，请参阅 Cloudflare Zaraz supports CSP ↗ 博客文章。
Cloudflare Zaraz 不会从页面中移除其他第三方脚本。根据配置，Zaraz 可以自动注入或不注入，但如果你有打算用 Zaraz 加载的现有脚本，应将其移除。
是。有关该产品的更多信息，请参阅 客户端安全（原名 Page Shield）。
要阻止 Zaraz 在特定页面加载，请参阅 有选择地加载 Zaraz。
重置 Zaraz 配置将清除你的所有配置设置，包括已设置的任何工具、触发器与变量。此操作会立即禁用 Zaraz。如果你想从空白状态重新开始，始终可以重置配置。
-
在 Cloudflare 仪表板中，前往 **Settings（设置）**页面。
Go to Settings ↗ -
前往 Advanced（高级）。
-
点击 **Reset（重置）**并按说明操作。
在开始使用电子商务 Web API 之前，需要在 Zaraz 设置页面 中启用电子商务跟踪。
Zaraz 内置 单页应用 (SPA) 支持，在 SPA 页面导航时会自动发送 pageview 事件。但若有高级用例，你可能希望构建自己的系统来触发 pageview。在这种情况下，你可以调用 zaraz.spaPageview() 使用内部 SPA pageview 事件。
你可能在 Google Analytics 4 的 设置选项 中启用了 Hide Originating IP Address。这会告诉 Zaraz 不要将 IP 地址发送给 Google。若要访问人口统计数据并匿名化访客 IP，应改用 Anonymize Originating IP Address。
没有唯一正确的选项，因为 Google Analytics (GA) 中的这两种选项作用不同。
工具设置 中的 “Hide Originating IP Address” 选项会阻止 Zaraz 将访客的 IP 地址发送给 Google。这意味着 GA 会将 Zaraz Worker 的 IP 地址视为访客的 IP 地址。地理位置上通常接近，但可能并不准确。
通过 Add field 选项提供的 Anonymize Originating IP Address，Cloudflare 会按原样将访客 IP 地址发送给 Google，并向 GA 传递 aip 参数。这会请求 GA 对数据进行匿名化。
如果我为 Google Analytics 设置了 Event Reporting（增强型衡量），为什么 Zaraz 只报告 Page View、Session Start 和 First Visit？
这不是缺陷。Zaraz 不会开箱提供普通 GA4 JavaScript 代码片段中的全部自动事件。你需要构建 触发器 与 操作 来捕获这些事件。有关 Zaraz 的工作方式，请参阅 快速入门。
可以。有关如何向工具发送额外数据，请参阅 额外字段。
在你的 Google Analytics 4 操作中，选择 Add field（添加字段） > Add custom field...（添加自定义字段...），并输入以 up. 开头的字段名——例如 up.name。这将使 Zaraz 将该字段作为用户属性而非事件属性发送。
Zaraz 内置对 Google Consent Mode v2 的支持。了解如何使用，请参阅 Google Consent Mode 页面。
由于 Facebook Pixel 的工作方式，数据可能需要 15 分钟到数小时才会出现在 Facebook 界面中。你也可以使用 调试模式 确认数据是否正从你的 Zaraz 账户正确发送。
Conversion ID 与 Conversion Label 通常由 Google Ads 以 “gtag script” 的形式提供。以下是 1 美元 USD 转化的示例：
gtag("event", "conversion", {
send_to: "AW-123456789/AbC-D_efG-h12_34-567",
value: 1.0,
currency: "USD",
});Conversion ID 是 send_to 参数的第一部分，不含 AW-。在上面的示例中为 123456789。Conversion Label 是 send_to 参数的第二部分，因此上例中为 AbC-D_efG-h12_34-567。通过 Zaraz 设置 Google Ads 转化时，请从你被要求实现的原始脚本中获取这些信息。
你可以使用 Zaraz 加载 Google Tag Manager，但不建议这样做。在 Google Tag Manager 中配置的工具无法由 Zaraz 优化，也无法受 Zaraz 隐私控制限制。此外，Google Tag Manager 可能因需要额外 JavaScript 且其规则在客户端评估而拖慢网站。如果你目前在使用 Google Tag Manager，我们建议通过将标签直接配置为 Zaraz 工具来用 Zaraz 替换它。
通过原生 Zaraz 集成将工具添加到网站，始终优于使用 HTML 代码片段。HTML 代码片段通常依赖额外的客户端请求，并需要执行客户端代码，这会拖慢网站。它们往往也存在安全风险，可能被攻破。此外，很难控制它们对访客隐私的影响。Zaraz 库中包含的工具不会有这些问题——它们速度快、在边缘执行，并且因为被沙箱化而可被控制与限制。
如果你在 Zaraz 设置中启用了 “Single Page Application support”，你的 Custom HTML 代码可能会在每次加载新的 SPA 页面时不必要地注入。这可能导致重复。为避免此情况，请进入你的 Custom HTML 操作并选择 “Add Field” 选项。然后添加 “Ignore SPA” 字段并启用切换开关。这样可防止代码在每次 SPA pageview 时触发，并确保只注入一次。
Zaraz 工程团队持续为新工具添加支持。你也可以参阅 社区空间 ↗ 请求新集成。
如果你通过 Cloudflare 代理域名，则无需向网站添加任何代码。默认情况下，Zaraz 包含自动化的 Pageview 触发器。某些工具（如 Google Analytics）会自动添加使用该触发器的 Pageview 操作。对于其他工具，你需要手动添加。更多信息请参阅 快速入门。
Zaraz 团队正在与第三方供应商合作，使用 Zaraz SDK 构建他们自己的 Zaraz 集成。要请求新工具集成，或就我们的 SDK 进行协作，请通过 [email protected] 联系我们。
在这种情况下，你可以在 Zaraz Consent 配置中更改 Consent cookie name 字段中的 cookie 名称。这将使同意模态框再次对所有用户显示。请确保使用尚未在你的站点上用于 Zaraz 的 cookie 名称。