AIを使用して英語から翻訳されました
この記事はAI技術を使用して翻訳されたことにご注意ください。正確性を維持するよう努めていますが、一部の詳細は元のテキストを完全に反映していない場合があります。情報に不明な点がある場合は、英語版を参照してください。
この記事は、CSTC機能の使用についてであり、ProおよびEnterpriseプランで利用可能です。
ダイナミック変数（DVAR）は、セッションに関する追加情報を収集し、さらなるフィルタリングやセグメンテーションを行うことを可能にします。ほぼすべての種類のユーザー行動やページレイアウトにフラグを立てるために使用できます。
これらの手順は、前提条件やスニペット作成の詳細を含むContentsquareタグコンフィギュレーターの記事と併せて使用する必要があります。
一般的に使用される目的
- 分析におけるユーザーセッションのセグメント化と比較。
- A/Bテスト: ABテストや多変量テストのように、何かの二値または複数の値がある場合に使用します。実験名は同じままで、テストとコントロールの名前が変更されます。
テンプレートの使用方法
スニペットを作成したら、以下の手順を使用してこの選択したテンプレートと選択したトリガーを構成します。
ステップ1: 次のテンプレートフィールドを入力します
- イテラブルコンテキスト: 収集したいイテラブルコンテキストを入力します（オプション）
- キー
- 値
- タイプ: 値のタイプを選択します（文字列または整数）
DVarの定義
DVarsは、値が文字列または数値（整数）であるキーと値のペアで構成されています。これらのオプションは、Contentsquareプラットフォーム内で異なるフィルタリング機能を提供します：
- number型の値の場合、演算子（より大きい、より小さいなど）を使用できます
- string型の値の場合、オートコンプリートと正規表現が利用可能です
収集したいDVarの値がグローバルオブジェクト（データレイヤー配列など）に格納されている場合、2つのオプションがあります：
1) 値がグローバルオブジェクト内の固定の位置にある場合、そのまま値フィールドに渡し、補間を使用します。
- 例えば、window.utag.data.customer_emailからメールアドレスを取得するには、そのまま‘Value’フィールドに渡し、補間を使用します：${window.utag.data.customer_email}
2) ただし、オブジェクト内の値の位置が固定されていない場合（GTMデータレイヤーの場合など）、イテラブルコンテキストフィールドも入力する必要があります。
- 例えば、データレイヤーにこの値が存在することを前提に、訪問者の国をデータレイヤーから取得したい場合、以下のフィールドを次のように設定します：
- イテラブルコンテキスト：values(window.dataLayer)[?country]
- 値：${$.country}
ステップ2：トリガーを選択
トリガーを選択し、スニペットを発火させる条件を定義します。
利用可能なトリガー
テンプレートとトリガーのガイドライン
- ページビューごとに最大20のDVARを渡すことができます。ただし、同じ「キー」値を持つDVarを1ページビューで1つ以上渡すと、最後のもの以外はすべて上書きされ、最後のものだけがシステムに残ります。
- 次のトリガーのいずれかを使用している場合 - 要素のクリックまたはタップ、要素が存在する、要素の挿入、要素が表示される、またはマウスオーバー - 実際にターゲット要素のテキストをDV値に渡すことができます。以下の式を「値」フィールドに入力します：
- 値：${element.textContent}
- たとえば、要素が表示されるトリガーを使用していて、ターゲットがフォームフィールドの下に表示されるエラーメッセージ（訪問者がそれを送信できなかった場合）で、エラーテキストが「名前と姓を入力してください」の場合、結果として得られるDVARは次のようになります：
- キー：検証エラー
- 値：名前と姓を入力してください
- 補間の動作例外： 実行時に補間された値が未定義の場合、テンプレートは100msごとに20回再試行し（合計2秒）、その後終了します。