gtag.js を使用した拡張 e コマース

このページでは、gtag.js を使用して拡張 e コマースデータを収集する方法について説明します。

gtag.js に Google アナリティクスを設定し、Google アナリティクスで拡張 e コマースを有効にすると、gtag.js を使ってインプレッション データ、商品データ、プロモーション データ、アクション データを Google アナリティクスに送信できます。

e コマースに関連するイベントのリストは、gtag.js イベント リファレンスで確認できます。

インプレッション データ

次の商品パラメータは、閲覧された商品に関する情報を表します。

商品パラメータ データ型 必須 説明
id string ○* 商品の一意の ID(SKU)
name string ○* 商品名
list_name string × ユーザーに商品が提示されたときにその商品が含まれていたリスト
brand string × 商品のブランド
category string × 商品のカテゴリ
variant string × 商品のバリエーション
list_position integer × リスト内の商品の位置
price currency × 商品の購入価格

*id または name を設定する必要があります。

商品データ

次の商品パラメータは、閲覧されたり、カートに追加されたりするなどした商品に関する情報を表します。

商品パラメータ データ型 必須 説明
id string ○* 商品の一意の ID(SKU)
name string ○* 商品名
brand string × 商品のブランド
category string × 商品のカテゴリ
variant string × 商品のバリエーション
price currency × 商品の購入価格
quantity integer × 商品の数量
coupon string × 購入可能な商品に利用できるクーポンコード
list_position integer × リスト内の商品の位置

*id または name を設定する必要があります。

プロモーション データ

次のプロモーション パラメータは、閲覧されたプロモーションに関する情報を表します。

プロモーション パラメータ データ型 必須 説明
id string ○* プロモーション ID
name string ○* プロモーションの名前
creative_name string × 使用されているクリエイティブの名前
creative_slot string × クリエイティブ スロットの名前

*id または name を設定する必要があります。

アクション データ

次のイベント パラメータと商品パラメータは、e コマースで発生したアクションに関する情報を表します。

イベント パラメータ データ型 必須 説明
transaction_id string ○* トランザクションの一意の ID
affiliation string × トランザクションが発生したショップやアフィリエーション
value number × イベントに関連する値(つまり収益)
tax currency × 税額
shipping currency × 配送料
items array × 関連する商品を含む配列
checkout_step number × 決済プロセスに含まれるステップの数
checkout_option string × 決済オプション(選択された支払い方法)

* purchase または refund に必要です。

商品パラメータ データ型 必須 説明
coupon string × 購入可能な商品に利用できるクーポンコード

商品アクションとプロモーション アクション

次のアクション(イベント)では、Google アナリティクスに送信する商品データやプロモーション データをどのように解釈するかを指定します。

イベント 説明
select_content 商品や商品リンク(1 つまたは複数の商品を表示するリンク)のクリック。
view_item 商品情報の表示。
add_to_cart ショッピング カートへの 1 つまたは複数の商品の追加。
remove_from_cart ショッピング カートから 1 つまたは複数の商品を削除する。
begin_checkout 1 つまたは複数の商品に関する決済プロセスの開始。
set_checkout_option 任意の決済ステップに対するオプション値の送付。
purchase 1 つまたは複数の商品の販売。
refund 1 つまたは複数の商品の払い戻し。
view_promotion 内部プロモーションのクリック。

商品のインプレッションを測定する

商品のインプレッションを測定するには、商品情報を含む view_item_list を送信します。

gtag('event', 'view_item_list', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list": "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": "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'
    }
  ]
});

プロモーションのインプレッションを測定する

プロモーションのインプレッションを測定するには、商品情報を含む 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"
    }
  ]
});

決済を測定する

決済プロセスの各ステップを測定するには:

  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": "USPS"
});

購入を測定する

トランザクションを測定するには、トランザクション内の商品を含む 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'
    }
  ]
});

払い戻しを測定する

トランザクションの全額払い戻しを測定するには、トランザクション ID を含む refund イベントを送信します。

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