Eコマース拡張機能

前提条件

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

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

仕組み

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

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

拡張機能の使用

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

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

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

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

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

オーダーデータ

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

オーダー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バンドル
• Hybrisバンドル
• Magentoバンドル

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