ルックアップテーブル拡張機能

前提条件

ユニバーサルタグ (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 のみが表示されます。すべてのフィールドが空白の場合、データはエクスポートされません。次の例は、上記の Import to CVS の例からマッピングをエクスポートする際の 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のみを含むためです。
正確なカテゴリIDを知っている場合は、Match Type で Exact を選択します。
次の手順を繰り返して、各ルックアップ変数のルックアップ/出力値マッピングを作成し、各カテゴリIDを読み取り可能なカテゴリ名値にマッピングします：
1. Lookup Match フィールドにカテゴリIDを入力します。たとえば 38。
2. Output フィールドにカテゴリ名を入力します。たとえば Mobile。
3. (オプション) Note フィールドに関連するメモを追加します。
4. + ボタンをクリックして別のルックアップ/出力値を追加します。

ルックアップテーブル拡張機能が実行されると、ルックアップが出力値と一致する場合、category_id 変数の出力値が構成された値で category_name 変数が構成されます。たとえば、category_id が 46 の場合、category_name は AudienceStream に構成されます。

FAQ

ルックアップ変数がテーブル内の複数の値と一致した場合はどうなりますか？

A: ルックアップは拡張子に表示される順番で実行され、最初に一致したものが採用されます。

“Exact"マッチタイプは大文字と小文字を区別しますか？

A: はい。Exact マッチオプションは大文字と小文字を区別します。