Zaraz Context

Zaraz Contextは、ウェブサイト上のユーザー行動を追跡するためのウェブ分析ツールであるZarazのための一連の設定可能なプロパティを提供する多目的オブジェクトです。これらのプロパティは、Worker VariablesやJSONata expressionsなど、さまざまなコンポーネントでアクセスおよび利用できます。

Zarazによって自動的に収集されるシステムプロパティは、ユーザーの環境やデバイスに関する洞察を提供し、Zaraz Web APIの呼び出し（例えば、zaraz.track()）を通じて取得されるクライアントプロパティは、ユーザーの行動やアクションに関する追加情報を提供します。

システムプロパティ

ページ情報

Property	Type	Description
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からの現在のページ文字エンコーディング。

クッキー

Property	Type	Description
system.cookies	Object	現在のすべてのクッキーを含むキー-バリューオブジェクト。

system.cookies内のキーはクッキー名です。プロパティsystem.cookies.fooは、fooという名前のクッキーの値を返します。

デバイス情報

Property	Type	Description
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。

同意管理

Property	Type	Description
system.consent	Object	Zaraz同意管理者からの現在の同意状況を含むキー-バリューオブジェクト。

system.consentオブジェクト内のキーは目的IDであり、値は同意の場合はtrue、同意がない場合はfalseです。

管理されたコンポーネント

Property	Type	Description
system.clientKV	Object	管理されたコンポーネントからのすべてのKVデータを含むキー-バリューオブジェクト。

system.clientKVオブジェクト内のキーは、ツールID、アンダースコア、キー名の形式でフォーマットされています。IDがabcdのツールによって使用されるga4キーの値を読み取る場合、パスはsystem.clientKV.abcd_ga4になります。

その他

Property	Type	Description
system.misc.random	Number	各リクエストに固有のランダムな数。
system.misc.timestamp	Number	Unix時間（秒単位）。
system.misc.timestampMilliseconds	Number	Unix時間（ミリ秒単位）。

イベントプロパティ

Property	Type	Description
client.__zarazTrack	String	Web APIのTrackメソッドを使用して送信されたイベントの名前を返します。詳細については、Zaraz Trackを参照してください。
client.<KEY_NAME>	String	zaraz.track()のeventPropertiesキーの値を返します。キーはzaraz.track()で直接使用するか、zaraz.set()を使用して設定できます。<KEY_NAME>をキーの名前に置き換えてください。詳細については、Zaraz Trackを参照してください。