ユニバーサル アナリティクス(UA)は 2023 年 7 月 1 日にサポート終了となります。この日以降、UA でデータを処理することはできません。また、アナリティクス 360 プロパティも 2023 年 10 月 1 日にサービス提供が終了します。Google アナリティクス 4 に移行する

拡張 e コマース

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

このページでは、gtag.js を使用して拡張 e コマースデータを収集する方法について説明します。gtag.js に Google アナリティクスを設定し、Google アナリティクスで拡張 e コマースを有効にすると、gtag.js を使ってインプレッション データ、商品データ、プロモーション データ、アクション データを Google アナリティクスに送信できます。

拡張 e コマースデータの種類と操作

送信できる e コマースデータの種類は複数あります。

インプレッション データ

インプレッション データは表示された商品に関する情報のことで、impressionFieldObject として参照され、次の値を含みます。

キー 値の型 必須 説明
id テキスト 必須*

商品 ID や SKU(例: P67890)。

* id または name のいずれかを設定する必要があります。

name テキスト 必須*

商品の名前(例: Android の T シャツ)。

* id または name のいずれかを設定する必要があります。

list テキスト × 商品が属するリストやコレクション(例: 検索結果)。
list_name テキスト × 商品が属するリストやコレクション(例: 検索結果)。
brand テキスト × 商品に関連するブランド(例: Google)。
category テキスト × 商品が属するカテゴリ(例: アパレル)。区切り文字として「/」を使って最大 5 レベルの階層を指定できます(例: アパレル/男性用/T シャツ)。
variant テキスト × 商品のバリエーション(例: 黒)。
position 整数 × リストやコレクションにおける商品の掲載順位(例: 2)。
list_position 整数 × リストやコレクションにおける商品の掲載順位(例: 2)。
price 数値 × 商品の価格(例: 2,920)。

商品データ

商品データは、表示されたりショッピング カートに追加されたりした個々の商品を表し、productFieldObject として参照され、次の値を含みます。

キー 値の型 必須 説明
id テキスト 必須*

商品 ID や SKU(例: P67890)。

* ID または name のいずれかを設定する必要があります。

name テキスト 必須*

商品の名前(例: Android の T シャツ)。

* ID または name のいずれかを設定する必要があります。

brand テキスト × 商品に関連するブランド(例: Google)。
category テキスト × 商品が属するカテゴリ(例: アパレル)。区切り文字として「/」を使って最大 5 レベルの階層を指定できます(例: アパレル/男性用/T シャツ)。
variant テキスト × 商品のバリエーション(例: 黒)。
price 数値 × 商品の価格(例: 2,920)。
quantity 整数 × 商品の数(例: 2)。
coupon テキスト × 商品に設定されているクーポンコード(例: SUMMER_SALE13)。
position 整数 × リストやコレクションにおける商品の掲載順位(例: 2)。
list_position 整数 × リストやコレクションにおける商品の掲載順位(例: 2)。

プロモーション データ

プロモーション データは表示されたプロモーションを表し、promoFieldObject として参照され、次の値を含みます。

キー 値の型 必須 説明
id テキスト 必須*

プロモーション ID(例: PROMO_1234)。

* id または name のいずれかを設定する必要があります。

name テキスト 必須*

プロモーションの名前(例: サマーセール)。

* id または name のいずれかを設定する必要があります。

creative テキスト × そのプロモーションが使われてる広告(例: summer_banner2)。
creative_name テキスト × クリエイティブの名前(例: summer_banner2)。
position テキスト × そのクリエイティブの掲載位置(例: banner_slot_1)。
creative_slot テキスト × クリエイティブ スロットの名前(例: banner_slot_1)。

アクション データ

アクション データは e コマースで発生した操作に関する情報のことで、 actionFieldObject として参照され、次の値を含みます。

キー 値の型 必須 説明
id テキスト 必須*

トランザクション ID(例: T1234)。

* アクション タイプが purchase または refund の場合は必須

affiliation テキスト × この取引が発生した店舗やアフィリエイト(Google ストアなど)。
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 イベントを送信し、productcontent_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. 決済プロセスの各ステップを測定する測定コードを追加します。
  2. 必要に応じて、決済オプションを測定する測定コードを追加します。

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'
    }
  ]
});