データ値構成拡張機能

前提条件

utag v4.38以降。utag.jsテンプレートの更新についての詳細は、当社のナレッジベース記事utag.jsの最新バージョンへの更新のベストプラクティスを参照してください。
拡張機能の仕組みについて理解しておくこと。

動作原理

この拡張機能を使用して、テキスト、別のデータレイヤー変数、またはJavaScriptコードを使用してデータレイヤー変数の値を構成します。データレイヤー変数はSet構成オプションで指定され、新しい値はToテキストボックスで指定されます。拡張機能の一回のインスタンスで複数の変数に値を割り当てることができます。オプションで条件を追加して、値が割り当てられるタイミングを制御できます。

拡張機能の使用方法

拡張機能を追加すると、以下の構成オプションが利用可能になります：

Set: 値を割り当てたいデータレイヤー変数。変数のドロップダウンリストから選択するか、+ Add Variableボタンをクリックして新しい変数を作成します。
To: 変数に割り当てる値。別の変数を構成するには**+ボタンをクリックし、拡張機能から変数を削除するには-**ボタンをクリックします。値は以下のオプションのいずれかになります：
- Text: タイプしたテキスト値に構成します。
- Variable: 別のデータレイヤー変数の値に構成します。
- JS Code: JavaScriptコードステートメントの値に構成します。
Condition: オプション。変数が割り当てられるタイミングを制御するための条件を追加します。条件が追加された場合、変数に新しい値が割り当てられるためには、条件がtrueと評価されなければなりません。

例

テキスト値を構成する

この例では、変数にテキスト値を構成する方法を示します。このシナリオでは、クエリ文字列パラメーターqが入力されているかどうかを検出する条件を使用し、データレイヤー変数page_typeをテキスト値searchに構成して、これが検索結果ページであることを示します。

Set Data Values拡張機能を追加します。
TitleにSet search as the page typeを構成します。
ドロップダウンメニューから変数page_typeを選択します。
値のタイプをTextに構成します。
テキストボックスにsearchと入力します。
Add Conditionをクリックして以下を構成します：
- 変数q (js)を選択します。
- 条件をis definedに構成します。

変数値を構成する

この例では、変数を別の変数の値に構成する方法を示します。このシナリオでは、変数page_nameに値がない場合、document.title変数の値に構成されます。

Set Data Values拡張機能を追加します。
TitleにSet page_nameを構成します。
ドロップダウンメニューから変数page_nameを選択します。
値のタイプをVariableに構成します。変数のドロップダウンリストが表示されます。
ドロップダウンメニューからDocument Titleを選択します。
Add Conditionをクリックして以下を構成します：
- 変数page_nameを選択します。
- 条件をis not definedに構成します。
- Conditionボックスの外にある**+をクリックしてOr**条件を追加します。
- 変数page_nameを選択します。
- 条件をis definedに構成します。
- is definedテキストボックスの隣にある**+をクリックしてAnd**条件を追加します。
- 変数page_nameを選択します。
- 条件をis not populatedに構成します。

JavaScriptコード値を構成する

この例では、JavaScriptステートメントによって返される値に変数を構成する方法を示します。このシナリオでは、検索ページ上の検索結果リンク要素の数をjQueryを使用して選択することによって、検索結果の数が決定されます。変数search_resultsはJavaScriptコードによって返される値に構成されます。

Set Data Values拡張機能を追加します。
TitleにDetermine number of search resultsを構成します。
ドロップダウンメニューから変数search_resultsを選択します。
値のタイプをJS Codeに構成します。
テキストボックスにページ内でのJavaScriptコードをそのまま入力します（またはブラウザコンソールで）。この例では、シンプルなjQueryセレクタと.lengthプロパティを使用します：$('.search-results a').length;。
Add Conditionをクリックして以下を構成します：
- 変数page_typeを選択します。
- 条件をequalsに構成し、テキストボックスにsearchを入力します。