← Cloudflare Zaraz / zaraz / reference
Zaraz Context
Zaraz Context представляет собой универсальный объект, который предоставляет набор настраиваемых свойств для Zaraz (веб-аналитического инструмента для отслеживания поведения пользователей на сайтах). Эти свойства доступны и могут использоваться в различных компонентах, включая Worker Variables и Выражения JSONata.
Системные свойства собираются Zaraz автоматически и дают представление об окружении и устройстве пользователя, тогда как клиентские свойства получают через Zaraz Web API вызовы, такие как zaraz.track(), предоставляют дополнительную информацию о поведении и действиях пользователя.
Системные свойства
Информация о странице
| Свойство | Тип | Описание |
|---|---|---|
system.page.query |
Объект | Объект Key-Value, содержащий все параметры запроса в текущем URL. |
system.page.title |
String | Заголовок текущей страницы. |
system.page.url |
URL | URL ↗ объект, содержащий информацию о текущем URL |
system.page.referrer |
String | Referrer текущей страницы из document.referrer. |
system.page.encoding |
String | Кодировка текущей страницы из document.characterSet. |
Cookies
| Свойство | Тип | Описание |
|---|---|---|
system.cookies |
Объект | Объект Key-Value, содержащий все имеющиеся файлы cookie. |
Ключи внутри system.cookies это название cookie-файлов. Свойство system.cookies.foo вернет значение cookie с именем foo.
Информация об устройстве
| Свойство | Тип | Описание |
|---|---|---|
system.device.ip |
String | Входящий IP-адрес посетителя. |
system.device.resolution |
String | Разрешение экрана устройства. |
system.device.viewport |
String | Видимая область веб-страницы на устройстве пользователя. |
system.device.language |
String | Язык, используемый на устройстве пользователя. |
system.device.location |
Объект | Все ключи, связанные с местоположением, из IncomingRequestCfProperties |
system.device.user-agent.ua |
String | User-Agent браузера. |
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 | Процессор устройства. |
Управление согласием
| Свойство | Тип | Описание |
|---|---|---|
system.consent |
Объект | Объект Key-Value, содержащий текущий статус согласия из Zaraz Consent Manager. |
Ключи внутри system.consent объекта являются ID целей, а значения представляют собой true для согласия, false при отсутствии согласия.
Managed Components
| Свойство | Тип | Описание |
|---|---|---|
system.clientKV |
Объект | Объект Key-Value, содержащий все данные KV из ваших Managed Components. |
Ключи внутри system.clientKV объекта имеют формат ID инструмента, знак подчёркивания, имя ключа. Предположим, вы хотите прочитать значение ga4 ключ, используемый инструментом с ID abcd, путь будет таким: system.clientKV.abcd_ga4.
Разное
| Свойство | Тип | Описание |
|---|---|---|
system.misc.random |
Число | Случайное число, уникальное для каждого запроса. |
system.misc.timestamp |
Число | Unix-время в секундах. |
system.misc.timestampMilliseconds |
Число | Unix-время в миллисекундах. |
Свойства событий
| Свойство | Тип | Описание |
|---|---|---|
client.__zarazTrack |
String | Возвращает название события, отправленного методом Track веб-API. См. Zaraz Track, где это описано подробнее. |
client.<KEY_NAME> |
String | Возвращает значение zaraz.track() eventProperties ключ. Этот ключ можно использовать напрямую в zaraz.track() или задать с помощью zaraz.set(). Замените <KEY_NAME> на имя вашего ключа. См. Zaraz Track, где это описано подробнее. |