Zaraz コンテキストは、ウェブサイト上のユーザー行動を追跡するウェブ分析ツール Zaraz 向けに、設定可能なプロパティ一式を提供する汎用オブジェクトです。これらのプロパティは、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 を参照してください。 |