トラッキング
zaraz.track()は、ページの<body>タグ内のどこでも使用できます。
zaraz.track()を使用すると、リアルタイムで発生する可能性のあるカスタムイベントをウェブサイトでトラッキングできます。これはasync関数であるため、他のコードを実行する前に完了したことを確認したい場合はawaitを使用することができます。
トラッキングに興味があるユーザーイベントの例としては、成功したサインアップ、コール・トゥ・アクションのクリック、または購入があります。他のタイプのイベントの一般的な例としては、ページ上の特定の要素のインプレッションをトラッキングしたり、特定のウィジェットを読み込んだりすることがあります。
イベントのトラッキングを開始するには、次のようにzaraz.track()関数を使用します：
zaraz.track(eventName, [eventProperties])eventNameパラメータは文字列で、eventPropertiesパラメータは、イベントに追加のコンテキストを添付するためのオプションのフラットオブジェクトです。たとえば、200 USDの価値を持つ購入をトラッキングする場合は、次のようになります：
zaraz.track("purchase", {value: 200, currency: "USD"})イベントの名前（上記の例ではpurchase）、キーの名前（valueとcurrency）、およびキーの数は、あなたがカスタマイズできます。どの変数をトラッキングし、これらの変数をどのようにトラッキングするかを選択します。ただし、意味のある名前を選ぶことで、トリガーを設定する際に役立ちます。なぜなら、トリガーの設定は、あなたのウェブサイトが送信しているイベントと一致する必要があるからです。
ウェブサイトでzaraz.track()を使用した後は、通常、それに基づいてトリガーを作成し、その後アクションでトリガーを使用したいと思うでしょう。まず、イベント名をトリガーの変数名として、トラッキングしているeventNameを一致文字列として使用して、新しいトリガーを作成します。上記の例に従うと、トリガーは次のようになります：
トリガーの例: zaraz.track("purchase")に一致
| ルールタイプ | 変数名 | 一致操作 | 一致文字列 |
|---|---|---|---|
| 一致ルール | イベント名 | 等しい | purchase |
このトリガーを使用したいすべてのツールで、このトリガーを発火トリガーとして設定したアクションを追加します。このトリガーを使用する各アクションは、送信したeventPropertiesにアクセスできます。アクションフィールドでは、{{ client.<KEY_NAME> }}を使用して<KEY_NAME>の値を取得できます。上記の例では、Zarazは{{ client.value }}を200に置き換えます。キーに特殊文字や数字が含まれている場合は、バックティックで囲んで{{ client.`<KEY_NAME>` }}のようにします。
zaraz.track()で使用できるプロパティに関する詳細については、プロパティリファレンスを参照してください。