---
title: Eコマース拡張機能
description: Eコマース拡張機能は、オーダートータルや商品IDなどの標準的なEコマース変数を定義し、それらを自動的にサポートするベンダータグにマッピングします。
url: https://docs.tealium.com/ja/iq-tag-management/extensions/extensions-list/e-commerce-extension/
---
## 前提条件

* utag v4.38以降。`utag.js`テンプレートの更新についての詳細は、当社のナレッジベース記事[utag.jsの最新バージョンへの更新のベストプラクティス](https://support.tealiumiq.com/en/support/solutions/articles/36000363470)を参照してください。


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


## 仕組み

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

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

## 拡張機能の使用

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

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

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

![](https://docs.tealium.com/images/iq-tag-management/e-commerce-extension-configuration-variables-naming-best-practices.png)

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

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

### 注文データ

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


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


| **注文値**    | **説明**                                                                                                                                                     | **出力変数** |
|:-------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------|:--------------------|
| Order ID           | 顧客の注文を識別する一意のIDを含む変数を選択します。Eコマース拡張機能を動作させるためには、注文IDをマッピングしておく必要があります。 | `_corder`           |
| Order Total        | 注文の総収益値を含む変数を選択します。                                                                                             | `_ctotal`           |
| Sub Total          | 注文の小計値を含む変数を選択します。これは、送料と税金を除いた注文合計です。                                       | `_csubtotal`        |
| Shipping Amount    | 注文の送料を含む変数を選択します。                                                                                                | `_cship`            |
| Tax Amount         | 注文の税金額を含む変数を選択します。                                                                                                      | `_ctax`             |
| Store              | 注文が行われるチャネル、サイト、またはストアを識別する変数を選択します。                                                                          | `_cstore`           |
| Currency           | 収益がどの通貨であるかを識別する変数を選択します。                                                                                           | `_ccurrency`        |
| Promo Code         | バウチャー、プロモーション、またはクーポンコードを含む変数を選択します。                                                                                           | `_cpromo`           |
| Cart or Order Type | カート、注文、または顧客タイプを含む変数を選択します。                                                                                                | `_ctype`            |
| Customer ID        | 顧客IDを含む変数を選択します。                                                                                                                  | `_ccustid`          |
| Customer City      | 顧客の住所によって識別される顧客の都市を識別する変数を選択します。                                                                   | `_ccity`            |
| Customer State     | 顧客の住所によって識別される顧客の州または県を識別する変数を選択します。                                                      | `_cstate`           |
| Customer Zip       | 顧客の住所によって識別される顧客の郵便番号を識別する変数を選択します。                                                               | `_czip`             |
| Customer Country   | 顧客の住所によって識別される顧客の国を識別する変数を選択します。出力変数は`_ccountry`です。                            | `_ccountry`         |

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

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

| **商品値**    | **説明**                                                                  | **出力変数** |
|:---------------------|:---------------------------------------------------------------------------------|:--------------------|
| 商品IDのリスト  | 商品IDを含む変数を選択します。                                | `_cprod`            |
| 名前のリスト        | 商品の名前を含む変数を選択します。                       | `_cprodname`        |
| SKUのリスト         | 商品のSKUを含む変数を選択します。                               | `_csku`             |
| ブランドのリスト       | 商品のブランドを含む変数を選択します。                             | `_cbrand`           |
| カテゴリのリスト   | 商品の主要カテゴリを含む変数を選択します。                | `_ccat`             |
| カテゴリ2のリスト | 商品の副カテゴリを含む変数を選択します。              | `_ccat2`            |
| 数量のリスト   | 注文された各商品の数量を含む変数を選択します。 | `_cquan`            |
| 価格のリスト       | 商品の価格を含む変数を選択します。                             | `_cprice`           |
| 割引のリスト    | 商品の割引額を含む変数を選択します。                      | `_cpdisc`           |

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

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

文字列と配列について詳しくは、[文字列 vs. 配列](https://docs.tealium.com/universal-data-object/#syntax-guidelines)の記事をご覧ください。

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

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

### Eコマース変数の上書き

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

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

![](https://docs.tealium.com/images/iq-tag-management/mappingtoolboxexample.png)

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

Eコマース拡張を追加していない場合で、[変数バンドル](https://docs.tealium.com/data-bundles/)を追加している場合、以下のバンドルが自動的に追加され、Eコマース拡張を構成します：

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


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