コンテンツにスキップ

セット

zaraz.set()をページの<body>タグ内のどこでも使用できます:

zaraz.set(key, value, [options])

セットは、zaraz.track()を使用するたびに手動で設定することなく、すべてのイベントで変数を利用可能にしたい場合に便利です。この例の目的のために、システム内のユーザーがツールに送信したい一意の識別子を持っていると仮定します。多くのzaraz.track()呼び出しがこの1つのパラメータを共有しているかもしれません:

zaraz.track("フォームが完了しました", {userId: "ABC-123"})
zaraz.track("ボタンがクリックされました", {userId: "ABC-123", value: 200})
zaraz.track("カートが表示されました", {items: 3, userId: "ABC-123"})

ここでは、すべてのイベントがuserIdキーを収集しており、そのキーを設定するコードが繰り返されています。zaraz.set()を使用すると、ページが読み込まれたときにキーを1回設定することで繰り返しを避けることができます。Zarazはその後、このキーをすべての将来のzaraz.track()呼び出しに添付します。

上記のデータを例として、zaraz.set("userId", "ABC-123")zaraz.track()呼び出しの前に1回使用すると、すべてのzaraz.track()呼び出しからuserIdキーを削除できます。

別の例:

zaraz.set('product_name', 't-shirt', {scope: 'page'})

zaraz.set()を使用して送信されたキーは、zaraz.track()eventProperties内のキーと同様にツールアクション内で使用できます。したがって、上記のproductキーは、Cloudflareダッシュボードで*Track Property name:*という変数を介してアクセス可能であり、その名前をproduct_nameとして設定します。Zarazはそれをt-shirtに置き換えます。

セットメソッドを使用してtシャツを追跡する変数を作成する方法の例

[options]引数はオプションのオブジェクトであり、文字列値を持つscopeプロパティを含めることができます。このプロパティは、このキーのライフタイムを決定し、Zarazがzaraz.track()呼び出しにどのくらいの期間このキーを添付し続けるかを意味します。許可される値は次のとおりです:

  • page: 現在のページのコンテキストのためにキーを設定します。
  • session: キーをセッション全体に持続させます。
  • persist: セッションをまたいでキーを保存します。これはデフォルトモードで、値を保存するためにlocalStorageを使用します。

前の例では、{scope: 'page'}product_nameプロパティを現在のページのすべてのzaraz.track()呼び出しで利用可能にしますが、訪問者が他のページに移動した後の呼び出しには影響しません。

変数を解除するには、undefinedに設定します。これにより、その変数は含まれていたすべてのスコープから削除され、将来のzaraz.track呼び出しで自動的に送信されることはありません。例えば:

zaraz.set('product_name', undefined)