ルックアップテーブル拡張機能
この記事では、ルックアップテーブル拡張機能とその構成方法について説明します。ルックアップテーブル拡張機能は、一つのデータレイヤー変数の値をマッピングして、別の変数の値を構成するために使用されます。
前提条件
- ユニバーサルタグ (
utag.js) 4.38 以降。utag.jsテンプレートの更新についての詳細は、当社のナレッジベース記事 utag.jsの最新バージョンへの更新のベストプラクティス を参照してください。
仕組み
ルックアップテーブル拡張機能は、ルックアップ値のリストを使用して、一つのデータレイヤー変数の値に基づいて別の変数の値を構成する方法を提供します。例えば、カテゴリ名を構成する必要があるが、データレイヤーがカテゴリIDの値しか提供しない場合、ルックアップテーブル拡張機能はカテゴリIDからカテゴリ名へのマッピングを提供します。サンプルマッピングは、カテゴリID 35 がカテゴリ名 iQ Tag Management に、カテゴリID 38 がカテゴリ名 Mobile にマッピングされる場合です。
ルックアップテーブル拡張機能を構成する際には、Lookup Value In フィールドにルックアップ変数（データレイヤーからのソース変数）を構成します。次に、Destination フィールドにルックアップエントリに基づいて構成したい変数を構成します。
Variable Type フィールドは、ルックアップ変数のデータタイプ（String または Array）を指定します。ルックアップ変数は、Match Type に基づいてルックアップマッチ値と比較されます。マッチタイプは、正確な、大文字小文字を区別する比較を使用するために Exact に構成するか、部分文字列 [文字列内の連続した文字列] の比較を使用するために Contains に構成するか、正規表現 パターンに構成することができます（上級者向け）。
ルックアップテーブルは、Lookup Match フィールドと Output フィールドにルックアップ値と出力値のエントリを追加することで構成されます。上記の例から、ルックアップ値 35 は Lookup Match フィールドに表示され、出力値 iQ Tag Management は Output フィールドに表示されます。
ルックアップ変数の値がエントリと一致する場合、Destination 変数は Output 値に構成されます。
ルックアップ変数の値がエントリと一致しない場合、出力値は Default Output フィールドで指定されたデフォルト値によって構成されます。例えば、これが Unknown に構成されている場合、ルックアップ変数のマッチが見つからないときには、出力変数はデータレイヤーで Unknown に構成されます。
追加の条件は、Conditions 構成を変更することで拡張機能に適用することができます。
拡張機能の使用
始める前に、拡張機能の動作方法について理解しておいてください。
ルックアップテーブル拡張機能を使用するには、以下の構成を行います：
-
Lookup Value in: ルックアップしたい値を含むデータレイヤーからソースルックアップ変数を選択します。
-
Destination: 関連する出力値に構成する変数を選択します。新しい変数を作成するには、+ ボタンをクリックします。
-
Variable Type: ルックアップ変数の値のデータタイプ（文字列または配列）を選択します。配列を選択した場合、任意の出力は対応するルックアップマッチと同じ配列インデックスに入ります。
-
Match Type: すべてのルックアップは選択したマッチタイプを使用して行われます。
- Exact: ルックアップ変数の値と完全に一致します（大文字小文字を区別します）。
- Contains: ルックアップ変数の値の部分文字列（文字列内の連続した文字列）と一致します。
- RegExp: ルックアップ変数の値と正規表現を一致させます。エスケープ文字は二つのバックスラッシュ
\\でエスケープされます。無視するケースフラグ、i、は自動的に適用されます。
-
Lookup Match: ルックアップ変数の値を入力します。値に引用符を使用しないでください。
-
Output: ルックアップマッチが見つかったときに構成する変数の値を入力します。値に引用符を使用しないでください。
-
Note: （オプション）各ルックアップマッチと出力値に関連するメモを追加します。メモの内容は宛先には渡されません。
-
Default Output: ルックアップマッチが見つからない場合の宛先変数のデフォルト値を入力します。デフォルト値を無効にするには、Disable Default チェックボックスを選択します。
CSVからのインポート
ルックアップ変数の値と出力値の間のマッピングデータを手動で入力するのは、ルックアップ値が多い場合には時間がかかります。別のオプションは、Import from CVS 機能で、これにより、カンマで区切られた値（CSV）としてフォーマットされたデータをテキストエリアボックスに貼り付けたり入力したりすることができます。データは次の形式で入力されます。各値はカンマで区切られます：
Lookup Value, Output Value, Note
Note 値はオプションで、空白のままにすることができます。
次の例では、5つのルックアップ/出力値のペアをマッピングに追加します：
38, Mobile, forums
35, iQ Tag Management, forums
46, AudienceStream, forums
34, DataAccess, forums
48, Digital Strategy, forums
ルックアップテーブルのマッピングをすべて入力したら、Replace ボタンをクリックして、CVS テキストエリアからの新しいもので既存のマッピングをすべて置き換えるか、または Append をクリックして、これらの新しいマッピングを追加し、ルックアップテーブルのすべての元のマッピングを保持します。
CSVへのエクスポート
Export to CVS ボタンは、ルックアップテーブルマッピングデータを lookup.csv という名前のファイルにエクスポートします。ファイルは自動的にコンピュータにダウンロードされ、Excelまたは任意のテキストエディタソフトウェアで開くことができます。
ルックアップテーブルマッピングデータは、カンマで区切られた値（CSV）としてエクスポートされ、各行が1つのエントリで、次の形式で表示されます：
Lookup Value, Output Value, Note
成功したエクスポートを行うためには、少なくとも1つのマッピング行が存在していなければなりません。オプションの Note フィールドが空白の場合、その行には Lookup Value と Output Value のみが表示されます。すべてのフィールドが空白の場合、データはエクスポートされません。次の例は、上記のCSVへのインポートの例からマッピングをエクスポートしたときの lookup.csv ファイルの内容を示しています：
38, Mobile, forums
35, iQ Tag Management, forums
46, AudienceStream, forums
34, DataAccess, forums
48, Digital Strategy, forums
例：カテゴリIDを名前にマッピングする
ルックアップテーブル拡張機能を使用すると、category_id のようなデータレイヤー変数を category_name のような別の変数にマッチさせることができます。以下の例を参照してください：
- Lookup Value in ドロップダウンメニューからルックアップ変数
category_idを選択します。 - Destination ドロップダウンメニューから読みやすい値変数
category_nameを選択します。変数がドロップダウンメニューに見つからない場合は、+ をクリックして変数を追加します。 - Default Output フィールドに
noneを入力します。category_idの値がルックアップテーブルマッピングで見つからない場合、category_nameの値はnoneに構成されます。 - Variable Type に String を選択します。変数
category_idはカテゴリごとに1つのIDしか含まないからです。 - Match Type に Exact を選択します。これは、正確なカテゴリIDを知っている場合に適しています。
- 以下の手順を繰り返して、各ルックアップ変数に対してルックアップ/出力値のマッピングを作成します。各カテゴリIDを読みやすいカテゴリ名の値にマッピングします：
- Lookup Match フィールドにカテゴリIDを入力します。例えば
38など。 - Output フィールドにカテゴリ名を入力します。例えば
Mobileなど。 - （オプション）Note フィールドに関連するメモを追加します。
- 別のルックアップ/出力値を追加するには、+ ボタンをクリックします。
- Lookup Match フィールドにカテゴリIDを入力します。例えば
ルックアップテーブル拡張機能が実行されると、ルックアップが category_id 変数の出力値と一致すると、category_name 変数はOutputで構成された値になります。例えば、category_id が 46 の場合、category_name は AudienceStream に構成されます。
FAQ
ルックアップ変数がテーブル内の複数の値と一致する場合はどうなりますか？
A: ルックアップは拡張機能内で表示される順序で行われ、最初のマッチが勝ちます。
マッチタイプ “Exact” は大文字小文字を区別しますか？
A: はい。Exact マッチオプションは大文字小文字を区別します。
最終更新日 :: 2024年March月29日