データレイヤーオブジェクト (b)

仕組み

b変数は、データレイヤーを表すutag.js内のJavaScriptオブジェクトです。ページの読み込みやトラッキング呼び出し中に処理されるデータレイヤーオブジェクトを保持しています。

Tealium iQでは、データレイヤー変数は通常、ドロップダウンリストを使用して参照されますが、b変数を使用してJavaScriptコード内で参照することもできます。

例えば、Set Data Values拡張の一般的な使用例は、変数がまだ構成されていない場合にデフォルト値を構成することです。拡張は次のようになるかもしれません：

utag.jsでは、この拡張は次のようにJavaScriptコードで表現されます：

function(a, b) {
  try {
    if (typeof b['page_type'] == 'undefined') {
      b['page_type'] = "generic"
    } catch (e) {
        utag.DB(e);
    }
  }
}

b変数はデータレイヤーオブジェクトへのローカル参照であり、b['page_type']はUDO変数page_typeへの参照です。同様に、拡張機能でカスタムJavaScriptを使用するときは、bを使用してデータレイヤーオブジェクト内の任意の変数を参照できます。

utag.jsバージョン4.39以前では、トラッキング呼び出し中のbオブジェクトの内容はutag.dataの完全なコピーです。この更新についてはリリース4.40で詳しく説明しています。

使用場所

bオブジェクトはutag.jsの特定のセクション内のローカルスコープ変数であり、次の拡張スコープで利用可能です：

• Before Load Rules
• After Load Rules
• Tag Scope
• After Tags

次のスコープではbオブジェクトを参照することはできません：

• Pre Loader
  Pre Loaderにスコープされた拡張は、bオブジェクトが作成される前に実行されるため、bオブジェクトを参照することはできません。
• DOM Ready
  DOM Readyにスコープされた拡張は、メインスコープの外部で実行されるため、bオブジェクトを参照することはできません。

シナリオ：ページの読み込み

標準的なページの読み込みでは、bオブジェクトはページ上のすべてのデータ、ユニバーサルデータオブジェクトを含むコレクションです。

例えば、次の例では、拡張機能でb['page_type']を参照できます：

<script>
var utag_data = {
    page_type: "home"
}
</script>
<script src="//tags.tiqcdn.com/utag/example/main/prod/utag.js"></script>

シナリオ：トラッキング呼び出し

トラッキング呼び出しでは、bオブジェクトはページ上のすべてのデータ（ユニバーサルデータオブジェクトを除く）と、トラッキング呼び出しに渡されたデータのコレクションです。

例えば、これらのトラッキング呼び出しでは、拡張機能でb['tealium_event']を参照できます：

var tmp = { tealium_event: "link_click" };
utag.link(tmp)

utag.view({ tealium_event: "cart_add" })

この例では、b['page_type']が定義されていないことに注意が必要です（utag_dataで定義されていても）これは、トラッキング呼び出しで渡されたデータオブジェクトの一部ではないからです。

ページから他のタイプのデータレイヤー変数を参照するには、使用法を参照してください。

トラッキング呼び出しでutag_dataの変数を含めるには、公開構成の基本変数構成を使用してください。

タグスコープの拡張

特定のタグにスコープされた拡張では、bオブジェクトはデータレイヤーオブジェクトのローカルコピーです。これは、bオブジェクトの値を他のタグに影響を与えずに変更できることを意味します。

これらの例では、データレイヤー変数order_idがJavaScript Code拡張を使用して各タグでカスタマイズされています。各拡張では、bはorder_idの同じ値から始まります：

使用法

タグテンプレートや拡張機能でbオブジェクト変数を参照するには、各変数タイプの正しい構文を使用する必要があります。

各変数タイプの構文は次のとおりです：

詳細については、データレイヤー変数タイプを参照してください。