このページでは、gtag.js を使用して拡張 e コマースデータを収集する方法について説明します。gtag.js に Google アナリティクスを設定し、Google アナリティクスで拡張 e コマースを有効にすると、gtag.js を使ってインプレッション データ、商品データ、プロモーション データ、アクション データを Google アナリティクスに送信できます。
拡張 e コマースデータの種類と操作
送信できる e コマースデータの種類は複数あります。
インプレッション データ
インプレッション データは表示された商品に関する情報のことで、impressionFieldObject
として参照され、次の値を含みます。
キー | 値の型 | 必須 | 説明 |
---|---|---|---|
id |
テキスト | 必須* |
商品 ID や SKU(例: P67890)。 * |
name |
テキスト | 必須* |
商品の名前(例: Android の T シャツ)。 * |
list |
テキスト | 省略可 | 商品が属するリストやコレクション(例: 検索結果)。 |
list_name |
テキスト | 省略可 | 商品が属するリストやコレクション(例: 検索結果)。 |
brand |
テキスト | 省略可 | 商品に関連するブランド(例: Google)。 |
category |
テキスト | 省略可 |
商品が属するカテゴリ(例: アパレル)。区切り文字として「/ 」を使って最大 5 レベルの階層を指定できます(例: アパレル/男性用/T シャツ)。 |
variant |
テキスト | 省略可 | 商品のバリエーション(例: 黒)。 |
position |
整数 | 省略可 | リストやコレクションにおける商品の掲載順位(例: 2)。 |
list_position |
整数 | 省略可 | リストやコレクションにおける商品の掲載順位(例: 2)。 |
price |
数値 | 省略可 | 商品の価格(例: 2,920)。 |
商品データ
商品データは、表示されたりショッピング カートに追加されたりした個々の商品を表し、productFieldObject
として参照され、次の値を含みます。
キー | 値の型 | 必須 | 説明 |
---|---|---|---|
id |
テキスト | 必須* |
商品 ID や SKU(例: P67890)。 * ID または |
name |
テキスト | 必須* |
商品の名前(例: Android の T シャツ)。 * ID または |
brand |
テキスト | 省略可 | 商品に関連するブランド(例: Google)。 |
category |
テキスト | 省略可 | 商品が属するカテゴリ(例: アパレル)。区切り文字として「/」を使って最大 5 レベルの階層を指定できます(例: アパレル/男性用/T シャツ)。 |
variant |
テキスト | 省略可 | 商品のバリエーション(例: 黒)。 |
price |
数値 | 省略可 | 商品の価格(例: 2,920)。 |
quantity |
整数 | 省略可 | 商品の数(例: 2)。 |
coupon |
テキスト | 省略可 | 商品に設定されているクーポンコード(例: SUMMER_SALE13)。 |
position |
整数 | 省略可 | リストやコレクションにおける商品の掲載順位(例: 2)。 |
list_position |
整数 | 省略可 | リストやコレクションにおける商品の掲載順位(例: 2)。 |
プロモーション データ
プロモーション データは表示されたプロモーションを表し、promoFieldObject
として参照され、次の値を含みます。
キー | 値の型 | 必須 | 説明 |
---|---|---|---|
id |
テキスト | 必須* |
プロモーション ID(例: PROMO_1234)。 * |
name |
テキスト | 必須* |
プロモーションの名前(例: サマーセール)。 * |
creative |
テキスト | 省略可 | そのプロモーションが使われてる広告(例: summer_banner2)。 |
creative_name |
テキスト | 省略可 | クリエイティブの名前(例: summer_banner2)。 |
position |
テキスト | 省略可 | そのクリエイティブの掲載位置(例: banner_slot_1)。 |
creative_slot |
テキスト | 省略可 | クリエイティブ スロットの名前(例: banner_slot_1)。 |
アクション データ
アクション データは e コマースで発生した操作に関する情報のことで、
actionFieldObject
として参照され、次の値を含みます。
キー | 値の型 | 必須 | 説明 |
---|---|---|---|
id |
テキスト | 必須* |
トランザクション ID(例: T1234)。 * アクション タイプが |
affiliation |
テキスト | 省略可 | このトランザクションが発生したショップやアフィリエイト(例: Google Store)。 |
revenue |
数値 | 省略可 |
トランザクションで発生した合計収益額または合計販売額(例: 1,199)。この値には、収益に合算する調整額(送料や税金など)を含めることができます。 |
value | 数値 | 省略可 | イベントに関連する値(収益) |
tax |
数値 | 省略可 | トランザクションで発生した合計税額。 |
shipping |
数値 | 省略可 | トランザクションで発生した送料。 |
coupon |
テキスト | 省略可 | そのトランザクションで使われたクーポン。 |
list |
テキスト | 省略可 | 対象商品が属するリスト省略可。 |
items |
配列 | 省略可 | 関連する商品を含む配列。 |
step |
整数 | 省略可 | 決済プロセスのステップを表す番号。checkout アクションのオプションです。 |
checkout_step |
整数 | 省略可 | 決済プロセスのステップを表す番号。 |
option |
テキスト | 省略可 |
checkout アクションと checkout_option アクションのオプション フィールド。決済ページのオプション情報(お支払い方法など)の説明に使用します。
|
checkout_option |
テキスト | 省略可 | 決済オプション(選択された支払い方法) |
キー | 値の型 | 必須 | 説明 |
---|---|---|---|
coupon |
文字列 | 省略可 | 購入可能な商品に利用できるクーポンコード。 |
商品アクションとプロモーション アクション
アクションでは、Google アナリティクスに送る商品データやプロモーション データをどのように解釈するかを指定します。
アクション | イベントの | 説明 |
---|---|---|
click |
商品や商品リンク(1 つまたは複数の商品を表示するリンク)のクリック。 | |
detail |
商品情報の表示。 | |
add |
ショッピング カートへの 1 個以上の商品の追加。 | |
remove |
ショッピング カートからの 1 個以上の商品の削除。 | |
checkout |
1 個以上の商品を対象とした決済プロセスの開始。 | |
checkout_option |
任意の決済ステップに対するオプション値の送付。 | |
purchase |
1 つまたは複数の商品の販売。 | |
refund |
1 つまたは複数の商品の払い戻し。 | |
promo_click |
内部プロモーションのクリック。 | |
add_to_cart |
ユーザーが 1 個以上の商品をショッピング カートに追加。 | |
begin_checkout |
ユーザーが 1 個以上の商品を対象として決済プロセスを開始。 | |
checkout_progress |
ユーザーが最初の決済手続きの後に決済手続きを完了。 | |
purchase |
ユーザーが購入を完了。 | |
refund |
ユーザーに対して 1 個以上の商品の払い戻しを完了。 | |
remove_from_cart |
ユーザーがショッピング カートから 1 個以上の商品を削除。 | |
select_content |
ユーザーが商品または商品のリンクをクリック。 | |
set_checkout_option |
ユーザーが完了しようとしている決済手続き。 | |
view_item |
ユーザーが商品の詳細を表示。 | |
view_item_list |
ユーザーが 1 個以上の商品のリストを表示。 | |
view_promotion |
ユーザーが内部プロモーションをクリック。 | |
view_refund |
ユーザーが 1 個以上の商品の払い戻しを表示。 |
例
商品インプレッションを測定する
商品のインプレッションを測定するには、商品情報を含む view_item_list
を送信します。
gtag('event', 'view_item_list', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": 2
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": 3
}
]
});
商品クリックを測定する
商品クリックを測定するには、商品情報を含む select_content
イベントを送信し、product
を content_type
に指定します。
gtag('event', 'select_content', {
"content_type": "product",
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": 2
}
]
});
商品の詳細の表示回数を測定する
ユーザーが商品リスティングをクリックした後、商品情報ページを閲覧する場合があります。このような商品情報の表示を測定するには、商品情報を含む view_item
イベントを送信します。
gtag('event', 'view_item', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
ショッピング カートへの追加およびショッピング カートからの削除の測定
ショッピング カートへの商品の追加を測定するには、商品情報を含む add_to_cart
イベントを送信します。
gtag('event', 'add_to_cart', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
ショッピング カートからの商品の削除を測定するには、商品情報を含む remove_from_cart
イベントを送信します。
gtag('event', 'remove_from_cart', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
決済プロセスを測定する
決済プロセスの各ステップを測定する手順は次のとおりです。
- 決済プロセスの各ステップを測定する測定コードを追加します。
- 必要に応じて、決済オプションを測定する測定コードを追加します。
1. 決済ステップを測定する
決済プロセスの最初のステップを測定するには、決済する商品を含む begin_checkout
イベントを送信します。
gtag('event', 'begin_checkout', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
],
"coupon": ""
});
その後の各決済ステップを測定するには、決済する商品を含む checkout_progress
イベントを送信します。
gtag('event', 'checkout_progress', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
],
"coupon": "SUMMER_DISCOUNT"
});
2. 決済オプションを測定する
決済オプションを測定するには、決済オプションを指定した set_checkout_option
イベントを送信します。
gtag('event', 'set_checkout_option', {
"checkout_step": 1,
"checkout_option": "shipping method",
"value": 3
});
プロモーションのインプレッションを測定する
プロモーションのインプレッションを測定するには、商品情報を含む view_promotion
イベントを送信します。
gtag('event', 'view_promotion', {
"promotions": [
{
"id": "abc123",
"name": "summer_promo"
},
{
"id": "xyz987",
"name": "spring savings"
}
]
});
プロモーションのクリックを測定する
プロモーションのクリックを測定するには、プロモーション情報を含む select_content
イベントを送信します。
gtag('event', 'select_content', {
"promotions": [
{
"id": "abc123",
"name": "summer_promo"
}
]
});
購入を測定する
トランザクションを測定するには、トランザクションの商品を含む purchase
イベントを送信します。
gtag('event', 'purchase', {
"transaction_id": "24.031608523954162",
"affiliation": "Google online store",
"value": 23.07,
"currency": "USD",
"tax": 1.24,
"shipping": 0,
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": '3.0'
}
]
});
払い戻しの測定
トランザクションの全額払い戻しを測定するには、refund
イベントをトランザクション ID とともに送信します。
gtag('event', 'refund', { "transaction_id": "T12345" })
一部払い戻しを測定するには、refund
イベントをトランザクション ID と払い戻し対象商品とともに送信します。
gtag('event', 'refund', {
"transaction_id": "79.18502354114992",
"affiliation": "Google online store",
"value": 23.07,
"currency": "USD",
"tax": 1.24,
"shipping": 0,
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": '3.0'
}
]
});