Eコマース拡張機能

前提条件

• utag v4.38以降。utag.jsテンプレートの更新についての詳細は、当社のナレッジベース記事utag.jsの最新バージョンへの更新のベストプラクティスを参照してください。

古いバージョン（4.37以下）では、拡張機能が2回実行される可能性があります。

仕組み

Eコマース拡張機能は、Eコマースデータレイヤー変数のグローバルマッピングです。Eコマースデータを期待するタグ統合は、これらのマッピングを自動的に参照するため、各タグで手動でマッピングする必要はありません。

Eコマース拡張機能は、他の変数と区別するために_cで始まる名前の特別な変数をデータレイヤーに追加します。例えば、変数をOrder IDにマッピングすると、その値はデータレイヤーに_corderとして保存されます。これらの特別なEコマース変数は、このデータを期待するベンダータグのタグテンプレートコードで参照されます。

拡張機能の使用

始める前に、拡張機能の動作方法について理解しておいてください。

拡張機能が追加されたら、ドロップダウンリストから選択して、データレイヤー変数を対応するEコマース変数にマッピングします。使用しない変数のマッピングは空白のままにしておいても構いません。

以下の例は、データレイヤー変数とEコマース変数のマッピングを示しています。

各変数エントリーにマウスを置くと、正しい変数を選択するのに役立つツールチップが表示されます。

拡張機能は、Eコマース変数を注文値と商品値の2つのカテゴリーに分けます。注文値には注文と顧客に関する情報が含まれています。商品値には注文内の商品に関する情報が含まれており、リストとして整理されています。

注文データ

この表は、注文レベルのデータに関連するEコマース変数を一覧表示しています。

Order ID変数は必須のマッピングです。

注文合計を計算する（_ctotal）ラジオボタンを使用すると、Eコマース拡張機能が注文合計を計算するかどうかを指定できます。ほとんどの場合、注文合計はEコマース拡張機能にデータが到達する前に計算されるため、デフォルトはいいえに構成されています。Eコマース拡張機能に注文合計を計算させたい場合は、はいを選択します。

商品データ

この表は、商品レベルのeコマース変数を一覧にしています。商品変数は配列であるため、複数の値を保持することができます。

リスト変数タイプドロップリストは、商品値のリストが送信される形式を識別します。オプションは以下の通りです：

• 配列: (デフォルト) 例：["商品1","商品2", "商品3"]
• 文字列: 例："商品1, 商品2, 商品3"

文字列と配列について詳しくは、文字列 vs. 配列の記事をご覧ください。

価格はラジオボタンは、商品価格がEコマース拡張に表示される形式を識別します。オプションは以下の通りです：

• 単価: (デフォルト) 数量に関係なく、商品の価格。
• ライン価格: 商品の価格にその数量を掛けたもの。このオプションが選択された場合、Eコマース拡張は自動的にそれを単価に変換します。

Eコマース変数の上書き

Eコマース拡張を構成すると、拡張で選択した値は自動的にEコマースデータを使用するすべてのタグに送信されます。Eコマース拡張の変数の代わりに別の変数の値を送信したい場合は、タグの構成のマップされた変数セクションで送信したい値をマッピングします。マッピングツールボックスは、どの宛先がEコマースマッピングを上書きするかを示します。

以下は、Google Universal Analyticsタグのマッピングツールボックスの例です：

Eコマース変数バンドルの追加

Eコマース拡張を追加していない場合で、変数バンドルを追加している場合、以下のバンドルが自動的に追加され、Eコマース拡張を構成します：

• Eコマース変数バンドル
• Demandwareバンドル（バージョン18.1以前）
• Hybrisバンドル
• Magentoバンドル

これらのバンドルを追加する前にEコマース拡張を追加し構成していた場合、バンドルを追加しても既存のEコマース拡張やその構成は上書きや置き換えられません。