Zaraz Context 是一个通用对象，为 Zaraz（用于跟踪网站用户行为的 Web 分析工具）提供一组可配置属性。可在多个组件中访问和使用这些属性，包括 Worker Variables 和 JSONata 表达式。
系统属性由 Zaraz 自动收集，可提供有关用户环境和设备的洞察；客户端属性通过 Zaraz Web API 调用（例如 zaraz.track()）获取，可提供有关用户行为和操作的额外信息。
| 属性 | 类型 | 描述 |
|---|---|---|
system.page.query |
Object | 包含当前 URL 中所有查询参数的键值对象。 |
system.page.title |
String | 当前页面标题。 |
system.page.url |
URL | 包含当前 URL 信息的 URL ↗ 对象 |
system.page.referrer |
String | 来自 document.referrer 的当前页面引用页。 |
system.page.encoding |
String | 来自 document.characterSet 的当前页面字符编码。 |
| 属性 | 类型 | 描述 |
|---|---|---|
system.cookies |
Object | 包含所有现有 cookie 的键值对象。 |
system.cookies 内的键是 cookie 名称。属性 system.cookies.foo 将返回名为 foo 的 cookie 的值。
| 属性 | 类型 | 描述 |
|---|---|---|
system.device.ip |
String | 访问者的入站 IP 地址。 |
system.device.resolution |
String | 设备屏幕分辨率。 |
system.device.viewport |
String | 用户设备上可见的网页区域。 |
system.device.language |
String | 用户设备使用的语言。 |
system.device.location |
Object | 来自 IncomingRequestCfProperties 的所有与位置相关的键 |
system.device.user-agent.ua |
String | 浏览器用户代理。 |
system.device.user-agent.browser.name |
String | 浏览器名称。 |
system.device.user-agent.browser.version |
String | 浏览器版本。 |
system.device.user-agent.engine.name |
String | 浏览器引擎类型（例如 WebKit）。 |
system.device.user-agent.engine.version |
String | 浏览器引擎版本。 |
system.device.user-agent.os.name |
String | 操作系统。 |
system.device.user-agent.os.version |
String | 操作系统版本。 |
system.device.user-agent.device |
String | 所用设备类型（例如 iPhone）。 |
system.device.user-agent.cpu |
String | 设备的 CPU。 |
| 属性 | 类型 | 描述 |
|---|---|---|
system.consent |
Object | 包含来自 Zaraz Consent Manager 的当前同意状态的键值对象。 |
system.consent 对象内的键是 purpose ID，值为 true 表示同意，false 表示未同意。
| 属性 | 类型 | 描述 |
|---|---|---|
system.clientKV |
Object | 包含来自 Managed Components 的所有 KV 数据的键值对象。 |
system.clientKV 对象内的键格式为：工具 ID、下划线、键名。假设你要读取 ID 为 abcd 的工具所使用的 ga4 键的值，路径将是 system.clientKV.abcd_ga4。
| 属性 | 类型 | 描述 |
|---|---|---|
system.misc.random |
Number | 每个请求唯一的随机数。 |
system.misc.timestamp |
Number | Unix 时间（秒）。 |
system.misc.timestampMilliseconds |
Number | Unix 时间（毫秒）。 |
| 属性 | 类型 | 描述 |
|---|---|---|
client.__zarazTrack |
String | 返回使用 Web API 的 Track 方法发送的事件名称。请参阅 Zaraz Track 了解更多信息。 |
client.<KEY_NAME> |
String | 返回 zaraz.track() 的 eventProperties 键的值。该键可以直接在 zaraz.track() 中使用，也可以使用 zaraz.set() 设置。将 <KEY_NAME> 替换为你的键名。请参阅 Zaraz Track 了解更多信息。 |