標準のユニバーサルアナリティクス（UA）プロパティでは、2023 年 7 月 1 日をもってデータの処理が停止されました。UA 360 プロパティでは、2024 年 7 月 1 日をもってデータの処理が停止されます。また、Google アナリティクス 4 への移行に伴い、一部の UA 360 の機能はその前にサポート終了となります。

拡張 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 Store）。
`revenue`	数値	省略可	トランザクションで発生した合計収益額または合計販売額（例: 1,199）。この値には、収益に合算する調整額（送料や税金など）を含めることができます。注: revenue に値を設定しなかった場合は、同じヒットの全商品の数量フィールドと価格フィールドを使って値が自動的に計算されます。
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'
    }
  ]
});