推奨イベント

これらのイベントを使用すると、測定できる機能とアクティビティが増えるため、Google アナリティクス 4 のレポートの利便性が向上します。これらのイベントを e コマースデータの収集に役立たせるには、イベントになんらかのコンテキストが必要です。このため、追加したイベントが自動的に送信されることはありません。このドキュメントでは、各イベントの必須パラメータと省略可能なパラメータについて説明します。

add_payment_info

このイベントは、ユーザーが e コマースの決済手続きで支払い情報を送信したことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
currency string ○* USD イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。

*value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
value number ○* 3,003 万台 イベントの金銭的価値。

* valueitems 内のすべてのアイテムの (price * quantity) の合計に設定します。shipping または tax は含めないでください。
* 有意義なレポートを作成するには、通常 value が必要です。 イベントにコンバージョンとしてマークを付ける場合は、value を設定することをおすすめします。
* value を設定する場合は currency が必要です。
coupon string × SUMMER_FUN イベントに関連付けられたクーポンの名前またはコード。

イベント単位と商品アイテム単位の coupon パラメータは独立しています。
payment_type string × Credit Card 選択した支払い方法。
items Array<Item> はい イベントの商品アイテム。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテムの ID。

*item_id または item_name が必要です。

item_name string ○* Stan and Friends Tee

商品アイテムの名前。

*item_id または item_name が必要です。

affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
注: 「affiliation」はアイテム スコープでのみ使用できます。
coupon string × SUMMER_FUN 商品アイテムに関連付けられたクーポンの名前またはコード。

イベント単位と商品アイテム単位の coupon パラメータは独立しています。
creative_name string × summer_banner2 プロモーション用のクリエイティブの名前。

設定すると、イベント単位の creative_name は無視されます。
設定しない場合、イベント単位の creative_name(存在する場合)が使用されます。
creative_slot string × featured_app_1 商品アイテムに関連付けられたプロモーション用のクリエイティブ スロットの名前。

設定すると、イベント単位の creative_slot は無視されます。
設定しない場合、イベント単位の creative_slot(存在する場合)が使用されます。
discount number × 2.22 商品アイテムに関連付けられた割引額の単位。
index number × 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × アパレル 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
item_category2 string × Adult 商品アイテムのカテゴリの第 2 階層またはその他の分類。
item_category3 string × Shirts 商品アイテムのカテゴリの第 3 階層またはその他の分類。
item_category4 string × Crew 商品アイテムのカテゴリの第 4 階層またはその他の分類。
item_category5 string × Short sleeve 商品アイテムのカテゴリの第 5 階層またはその他の分類。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。

設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id(存在する場合)が使用されます。
item_list_name string × 関連プロダクト ユーザーに商品アイテムが表示されたリストの名前。

設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name(存在する場合)が使用されます。
item_variant string × green 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。
location_id string × ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) 商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。
注: 「location_id」はアイテム スコープでのみ使用できます。
price number × 1,001 万台 指定された通貨パラメータの単位で表した商品アイテムの価格の単位。
商品アイテムに割引を適用する場合は、price に割引単価を設定し、discount パラメータで単価割引を指定します。
promotion_id string × P_12345 商品アイテムに関連付けられたプロモーションの ID。

設定すると、イベント単位の promotion_id は無視されます。
設定しない場合、イベント単位の promotion_id(存在する場合)が使用されます。
promotion_name string × Summer Sale 商品アイテムに関連付けられたプロモーションの名前。

設定すると、イベント単位の promotion_name は無視されます。
設定しない場合、イベント単位の promotion_name(存在する場合)が使用されます。
quantity number × 3

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。

items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: add_payment_info
  • データレイヤー変数(名前 - データレイヤー変数名):
    • e コマース アイテム - ecommerce.items
    • e コマースの値 - ecommerce.value
    • e コマースの通貨 - ecommerce.currency
    • e コマースのクーポン - ecommerce.coupon
    • e コマースのお支払いタイプ - ecommerce.payment_type
  • イベント パラメータ(パラメータ名 - 値):
    • items - &lbrace;&lbrace;e コマース アイテム&rbrace;&rbrace;
    • value - &lbrace;&lbrace;e コマースの値&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;e コマースの通貨&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;e コマースのクーポン&rbrace;&rbrace;
    • payment_type - &lbrace;&lbrace;e コマースのお支払いタイプ&rbrace;&rbrace;
  • トリガー: event が add_payment_info と等しい

トリガーの設定:

  • トリガーのタイプ: カスタム イベント
  • イベント名: add_payment_info
  • このトリガーの発生場所: すべてのカスタム イベント
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_payment_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    payment_type: "Credit Card",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

add_shipping_info

このイベントは、ユーザーが e コマースの決済手続きで支払い情報を送信したことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
currency string ○* USD イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。

*value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
value number ○* 3,003 万台 イベントの金銭的価値。

* valueitems 内のすべてのアイテムの (price * quantity) の合計に設定します。shipping または tax は含めないでください。
* 有意義なレポートを作成するには、通常 value が必要です。 イベントにコンバージョンとしてマークを付ける場合は、value を設定することをおすすめします。
* value を設定する場合は currency が必要です。
coupon string × SUMMER_FUN イベントに関連付けられたクーポンの名前またはコード。

イベント単位と商品アイテム単位の coupon パラメータは独立しています。
shipping_tier string × Ground 購入された商品アイテムの配送方法で選択されている送料区分(GroundAirNext-day など)。
items Array<Item> イベントの商品アイテム。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテムの ID。

*item_id または item_name が必要です。

item_name string ○* Stan and Friends Tee

商品アイテムの名前。

*item_id または item_name が必要です。

affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
注: 「affiliation」はアイテム スコープでのみ使用できます。
coupon string × SUMMER_FUN 商品アイテムに関連付けられたクーポンの名前またはコード。

イベント単位と商品アイテム単位の coupon パラメータは独立しています。
creative_name string × summer_banner2 プロモーション用のクリエイティブの名前。

設定すると、イベント単位の creative_name は無視されます。
設定しない場合、イベント単位の creative_name(存在する場合)が使用されます。
creative_slot string × featured_app_1 商品アイテムに関連付けられたプロモーション用のクリエイティブ スロットの名前。

設定すると、イベント単位の creative_slot は無視されます。
設定しない場合、イベント単位の creative_slot(存在する場合)が使用されます。
discount number × 2.22 商品アイテムに関連付けられた割引額の単位。
index number × 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × アパレル 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
item_category2 string × Adult 商品アイテムのカテゴリの第 2 階層またはその他の分類。
item_category3 string × Shirts 商品アイテムのカテゴリの第 3 階層またはその他の分類。
item_category4 string × Crew 商品アイテムのカテゴリの第 4 階層またはその他の分類。
item_category5 string × Short sleeve 商品アイテムのカテゴリの第 5 階層またはその他の分類。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。

設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id(存在する場合)が使用されます。
item_list_name string × 関連プロダクト ユーザーに商品アイテムが表示されたリストの名前。

設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name(存在する場合)が使用されます。
item_variant string × green 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。
location_id string × ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) 商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。
注: 「location_id」はアイテム スコープでのみ使用できます。
price number × 1,001 万台 指定された通貨パラメータの単位で表した商品アイテムの価格の単位。
商品アイテムに割引を適用する場合は、price に割引単価を設定し、discount パラメータで単価割引を指定します。
promotion_id string × P_12345 商品アイテムに関連付けられたプロモーションの ID。

設定すると、イベント単位の promotion_id は無視されます。
設定しない場合、イベント単位の promotion_id(存在する場合)が使用されます。
promotion_name string × Summer Sale 商品アイテムに関連付けられたプロモーションの名前。

設定すると、イベント単位の promotion_name は無視されます。
設定しない場合、イベント単位の promotion_name(存在する場合)が使用されます。
quantity number × 3

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。

items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: add_shipping_info
  • データレイヤー変数(名前 - データレイヤー変数名):
    • e コマース アイテム - ecommerce.items
    • e コマースの値 - ecommerce.value
    • e コマースの通貨 - ecommerce.currency
    • e コマースのクーポン - ecommerce.coupon
    • e コマースの送料区分 - ecommerce.shipping_tier
  • イベント パラメータ(パラメータ名 - 値):
    • items - &lbrace;&lbrace;e コマース アイテム&rbrace;&rbrace;
    • value - &lbrace;&lbrace;e コマースの値&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;e コマースの通貨&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;e コマースのクーポン&rbrace;&rbrace;
    • shipping_tier - &lbrace;&lbrace;e コマースの送料区分&rbrace;&rbrace;
  • トリガー: event が add_shipping_info と等しい

トリガーの設定:

  • トリガーのタイプ: カスタム イベント
  • イベント名: add_shipping_info
  • このトリガーの発生場所: すべてのカスタム イベント
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_shipping_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping_tier: "Ground",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

add_to_cart

このイベントは、購入のために商品アイテムがカートに追加されたことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
currency string ○* USD イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。

*value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
value number ○* 3,003 万台 イベントの金銭的価値。

* valueitems 内のすべてのアイテムの (price * quantity) の合計に設定します。shipping または tax は含めないでください。
* 有意義なレポートを作成するには、通常 value が必要です。 イベントにコンバージョンとしてマークを付ける場合は、value を設定することをおすすめします。
* value を設定する場合は currency が必要です。
items Array<Item> イベントの商品アイテム。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテムの ID。

*item_id または item_name が必要です。

item_name string ○* Stan and Friends Tee

商品アイテムの名前。

*item_id または item_name が必要です。

affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
注: 「affiliation」はアイテム スコープでのみ使用できます。
coupon string × SUMMER_FUN 商品アイテムに関連付けられたクーポンの名前またはコード。

イベント単位と商品アイテム単位の coupon パラメータは独立しています。
creative_name string × summer_banner2 プロモーション用のクリエイティブの名前。

設定すると、イベント単位の creative_name は無視されます。
設定しない場合、イベント単位の creative_name(存在する場合)が使用されます。
creative_slot string × featured_app_1 商品アイテムに関連付けられたプロモーション用のクリエイティブ スロットの名前。

設定すると、イベント単位の creative_slot は無視されます。
設定しない場合、イベント単位の creative_slot(存在する場合)が使用されます。
discount number × 2.22 商品アイテムに関連付けられた割引額の単位。
index number × 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × アパレル 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
item_category2 string × Adult 商品アイテムのカテゴリの第 2 階層またはその他の分類。
item_category3 string × Shirts 商品アイテムのカテゴリの第 3 階層またはその他の分類。
item_category4 string × Crew 商品アイテムのカテゴリの第 4 階層またはその他の分類。
item_category5 string × Short sleeve 商品アイテムのカテゴリの第 5 階層またはその他の分類。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。

設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id(存在する場合)が使用されます。
item_list_name string × 関連プロダクト ユーザーに商品アイテムが表示されたリストの名前。

設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name(存在する場合)が使用されます。
item_variant string × green 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。
location_id string × ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) 商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。
注: 「location_id」はアイテム スコープでのみ使用できます。
price number × 1,001 万台 指定された通貨パラメータの単位で表した商品アイテムの価格の単位。
商品アイテムに割引を適用する場合は、price に割引単価を設定し、discount パラメータで単価割引を指定します。
promotion_id string × P_12345 商品アイテムに関連付けられたプロモーションの ID。

設定すると、イベント単位の promotion_id は無視されます。
設定しない場合、イベント単位の promotion_id(存在する場合)が使用されます。
promotion_name string × Summer Sale 商品アイテムに関連付けられたプロモーションの名前。

設定すると、イベント単位の promotion_name は無視されます。
設定しない場合、イベント単位の promotion_name(存在する場合)が使用されます。
quantity number × 3

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。

items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: add_to_cart
  • データレイヤー変数(名前 - データレイヤー変数名):
    • e コマース アイテム - ecommerce.items
    • e コマースの値 - ecommerce.value
    • e コマースの通貨 - ecommerce.currency
  • イベント パラメータ(パラメータ名 - 値):
    • items - &lbrace;&lbrace;e コマース アイテム&rbrace;&rbrace;
    • value - &lbrace;&lbrace;e コマースの値&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;e コマースの通貨&rbrace;&rbrace;
  • トリガー: event が add_to_cart と等しい

トリガーの設定:

  • トリガーのタイプ: カスタム イベント
  • イベント名: add_to_cart
  • このトリガーの発生場所: すべてのカスタム イベント
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

add_to_wishlist

このイベントは、商品アイテムがウィッシュリストに追加されたことを示します。アプリで人気のあるギフトアイテムを特定するには、このイベントを使用します。

パラメータ

名前 タイプ 必須 値の例 説明
currency string ○* USD イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。

*value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
value number ○* 3,003 万台 イベントの金銭的価値。

* valueitems 内のすべてのアイテムの (price * quantity) の合計に設定します。shipping または tax は含めないでください。
* 有意義なレポートを作成するには、通常 value が必要です。 イベントにコンバージョンとしてマークを付ける場合は、value を設定することをおすすめします。
* value を設定する場合は currency が必要です。
items Array<Item> イベントの商品アイテム。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテムの ID。

*item_id または item_name が必要です。

item_name string ○* Stan and Friends Tee

商品アイテムの名前。

*item_id または item_name が必要です。

affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
注: 「affiliation」はアイテム スコープでのみ使用できます。
coupon string × SUMMER_FUN 商品アイテムに関連付けられたクーポンの名前またはコード。

イベント単位と商品アイテム単位の coupon パラメータは独立しています。
creative_name string × summer_banner2 プロモーション用のクリエイティブの名前。

設定すると、イベント単位の creative_name は無視されます。
設定しない場合、イベント単位の creative_name(存在する場合)が使用されます。
creative_slot string × featured_app_1 商品アイテムに関連付けられたプロモーション用のクリエイティブ スロットの名前。

設定すると、イベント単位の creative_slot は無視されます。
設定しない場合、イベント単位の creative_slot(存在する場合)が使用されます。
discount number × 2.22 商品アイテムに関連付けられた割引額の単位。
index number × 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × アパレル 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
item_category2 string × Adult 商品アイテムのカテゴリの第 2 階層またはその他の分類。
item_category3 string × Shirts 商品アイテムのカテゴリの第 3 階層またはその他の分類。
item_category4 string × Crew 商品アイテムのカテゴリの第 4 階層またはその他の分類。
item_category5 string × Short sleeve 商品アイテムのカテゴリの第 5 階層またはその他の分類。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。

設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id(存在する場合)が使用されます。
item_list_name string × 関連プロダクト ユーザーに商品アイテムが表示されたリストの名前。

設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name(存在する場合)が使用されます。
item_variant string × green 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。
location_id string × ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) 商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。
注: 「location_id」はアイテム スコープでのみ使用できます。
price number × 1,001 万台 指定された通貨パラメータの単位で表した商品アイテムの価格の単位。
商品アイテムに割引を適用する場合は、price に割引単価を設定し、discount パラメータで単価割引を指定します。
promotion_id string × P_12345 商品アイテムに関連付けられたプロモーションの ID。

設定すると、イベント単位の promotion_id は無視されます。
設定しない場合、イベント単位の promotion_id(存在する場合)が使用されます。
promotion_name string × Summer Sale 商品アイテムに関連付けられたプロモーションの名前。

設定すると、イベント単位の promotion_name は無視されます。
設定しない場合、イベント単位の promotion_name(存在する場合)が使用されます。
quantity number × 3

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。

items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: add_to_wishlist
  • データレイヤー変数(名前 - データレイヤー変数名):
    • e コマース アイテム - ecommerce.items
    • e コマースの値 - ecommerce.value
    • e コマースの通貨 - ecommerce.currency
  • イベント パラメータ(パラメータ名 - 値):
    • items - &lbrace;&lbrace;e コマース アイテム&rbrace;&rbrace;
    • value - &lbrace;&lbrace;e コマースの値&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;e コマースの通貨&rbrace;&rbrace;
  • トリガー: event が add_to_wishlist と等しい

トリガーの設定:

  • トリガーのタイプ: カスタム イベント
  • イベント名: add_to_wishlist
  • このトリガーの発生場所: すべてのカスタム イベント
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_wishlist",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

begin_checkout

このイベントは、ユーザーが購入手続きを開始したことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
currency string ○* USD イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。

*value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
value number ○* 3,003 万台 イベントの金銭的価値。

* valueitems 内のすべてのアイテムの (price * quantity) の合計に設定します。shipping または tax は含めないでください。
* 有意義なレポートを作成するには、通常 value が必要です。 イベントにコンバージョンとしてマークを付ける場合は、value を設定することをおすすめします。
* value を設定する場合は currency が必要です。
coupon string × SUMMER_FUN イベントに関連付けられたクーポンの名前またはコード。

イベント単位と商品アイテム単位の coupon パラメータは独立しています。
items Array<Item> はい イベントの商品アイテム。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテムの ID。

*item_id または item_name が必要です。

item_name string ○* Stan and Friends Tee

商品アイテムの名前。

*item_id または item_name が必要です。

affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
注: 「affiliation」はアイテム スコープでのみ使用できます。
coupon string × SUMMER_FUN 商品アイテムに関連付けられたクーポンの名前またはコード。

イベント単位と商品アイテム単位の coupon パラメータは独立しています。
creative_name string × summer_banner2 プロモーション用のクリエイティブの名前。

設定すると、イベント単位の creative_name は無視されます。
設定しない場合、イベント単位の creative_name(存在する場合)が使用されます。
creative_slot string × featured_app_1 商品アイテムに関連付けられたプロモーション用のクリエイティブ スロットの名前。

設定すると、イベント単位の creative_slot は無視されます。
設定しない場合、イベント単位の creative_slot(存在する場合)が使用されます。
discount number × 2.22 商品アイテムに関連付けられた割引額の単位。
index number × 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × アパレル 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
item_category2 string × Adult 商品アイテムのカテゴリの第 2 階層またはその他の分類。
item_category3 string × Shirts 商品アイテムのカテゴリの第 3 階層またはその他の分類。
item_category4 string × Crew 商品アイテムのカテゴリの第 4 階層またはその他の分類。
item_category5 string × Short sleeve 商品アイテムのカテゴリの第 5 階層またはその他の分類。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。

設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id(存在する場合)が使用されます。
item_list_name string × 関連プロダクト ユーザーに商品アイテムが表示されたリストの名前。

設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name(存在する場合)が使用されます。
item_variant string × green 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。
location_id string × ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) 商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。
注: 「location_id」はアイテム スコープでのみ使用できます。
price number × 1,001 万台 指定された通貨パラメータの単位で表した商品アイテムの価格の単位。
商品アイテムに割引を適用する場合は、price に割引単価を設定し、discount パラメータで単価割引を指定します。
promotion_id string × P_12345 商品アイテムに関連付けられたプロモーションの ID。

設定すると、イベント単位の promotion_id は無視されます。
設定しない場合、イベント単位の promotion_id(存在する場合)が使用されます。
promotion_name string × Summer Sale 商品アイテムに関連付けられたプロモーションの名前。

設定すると、イベント単位の promotion_name は無視されます。
設定しない場合、イベント単位の promotion_name(存在する場合)が使用されます。
quantity number × 3

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。

items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: begin_checkout
  • データレイヤー変数(名前 - データレイヤー変数名):
    • e コマース アイテム - ecommerce.items
    • e コマースの値 - ecommerce.value
    • e コマースの通貨 - ecommerce.currency
    • e コマースのクーポン - ecommerce.coupon
  • イベント パラメータ(パラメータ名 - 値):
    • items - &lbrace;&lbrace;e コマース アイテム&rbrace;&rbrace;
    • value - &lbrace;&lbrace;e コマースの値&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;e コマースの通貨&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;e コマースのクーポン&rbrace;&rbrace;
  • トリガー: event が begin_checkout と等しい

トリガーの設定:

  • トリガーのタイプ: カスタム イベント
  • イベント名: begin_checkout
  • このトリガーの発生場所: すべてのカスタム イベント
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "begin_checkout",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

earn_virtual_currency

このイベントは、ユーザーがゲーム内で仮想通貨を獲得したタイミングを測定します。仮想経済について詳しく把握するには、このイベントを spend_virtual_currency とともにログに記録します。

パラメータ

名前 タイプ 必須 値の例 説明
virtual_currency_name string × Gems 仮想通貨の名前。
value number × 5 仮想通貨の価値。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: earn_virtual_currency
  • イベント パラメータ(パラメータ名 - 値):
    • virtual_currency_name - ジェム
    • value~ 5
  • トリガー: ユーザーに仮想通貨が授与されたとき

generate_lead

このイベントは、見込み顧客が発掘されたタイミングを測定します(フォームの使用など)。ログに記録することで、マーケティング キャンペーンの効果と、リマーケティング後にビジネスを再び利用した顧客の数を把握できます。

パラメータ

名前 タイプ 必須 値の例 説明
currency string ○* USD イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。

*value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
value number ○* 3,003 万台 イベントの金銭的価値。

* valueitems 内のすべてのアイテムの (price * quantity) の合計に設定します。shipping または tax は含めないでください。
* 有意義なレポートを作成するには、通常 value が必要です。 イベントにコンバージョンとしてマークを付ける場合は、value を設定することをおすすめします。
* value を設定する場合は currency が必要です。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: generate_lead
  • イベント パラメータ(パラメータ名 - 値):
    • currency~米ドル
    • value~ 99.99
  • トリガー: 見込み顧客が発掘されたとき

join_group

ユーザーが団体、チーム、ファミリーなどのグループに参加したときに、このイベントをログに記録します。特定のグループまたはソーシャル機能の人気度を分析するには、このイベントを使用します。

パラメータ

名前 タイプ 必須 値の例 説明
group_id string × G_12345 グループの ID。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: join_group
  • イベント パラメータ(パラメータ名 - 値):
    • group_id~ G_12345
  • トリガー: ユーザーがグループに参加したとき

level_end

このイベントは、ユーザーがゲーム内でレベルをクリアしたことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
level_name string × 旅の始まり... レベルの名前。
success boolean × true レベルを完了した場合は、true に設定します。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: level_end
  • イベント パラメータ(パラメータ名 - 値):
    • level_name - 旅の始まり...
    • success - true
  • トリガー: プレーヤーがレベルの終わり(レベル確認ページなど)に達したとき

level_start

このイベントは、ユーザーがゲーム内でレベルをスタートしたことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
level_name string × 旅の始まり... レベルの名前。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: level_start
  • イベント パラメータ(パラメータ名 - 値):
    • level_name - 旅の始まり...
  • トリガー: ユーザーが新しいレベル(レベルのスタートページなど)を開始したとき

level_up

このイベントは、ユーザーがゲーム内でレベルアップしたことを示します。ユーザーベースのレベル分布を測定して完了しにくいレベルを特定するには、このイベントを使用します。

パラメータ

名前 タイプ 必須 値の例 説明
level number × 5 キャラクターのレベル。
character string × Player 1 レベルアップしたキャラクター。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: level_up
  • イベント パラメータ(パラメータ名 - 値):
    • level~ 5
    • character - プレーヤー 1
  • トリガー: プレーヤーがレベルアップしたとき

login

ユーザーがウェブサイトまたはアプリにログインしたことを示すには、このイベントを送信します。

パラメータ

名前 タイプ 必須 値の例 説明
method string × Google ログインに使用するメソッド。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: login
  • イベント パラメータ(パラメータ名 - 値):
    • method - Google
  • トリガー: ユーザーがログインしたとき

post_score

このイベントは、ユーザーがスコアを投稿したときに送信します。ゲーム内でのユーザーのパフォーマンスを把握して、ハイスコアをオーディエンスおよび行動と関連付けるには、このイベントを使用します。

パラメータ

名前 タイプ 必須 値の例 説明
score number はい 10000 投稿するスコア。
level number × 5 スコアのレベル。
character string × Player 1 スコアを達成したキャラクター。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: post_score
  • イベント パラメータ(パラメータ名 - 値):
    • score~ 10,000
    • level~ 5
    • character - プレーヤー 1
  • トリガー: ユーザーがスコアを投稿したとき

purchase

このイベントは、ユーザーが 1 つ以上の商品アイテムを購入したことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
currency string ○* USD イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。

*value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
value number ○* 3,003 万台 イベントの金銭的価値。

* valueitems 内のすべてのアイテムの (price * quantity) の合計に設定します。shipping または tax は含めないでください。
* 有意義なレポートを作成するには、通常 value が必要です。 イベントにコンバージョンとしてマークを付ける場合は、value を設定することをおすすめします。
* value を設定する場合は currency が必要です。
transaction_id string はい T_12345 取引を一意に識別する ID。

transaction_id パラメータを使用すると、購入イベントの重複を回避できます。
coupon string × SUMMER_FUN イベントに関連付けられたクーポンの名前またはコード。

イベント単位と商品アイテム単位の coupon パラメータは独立しています。
shipping number × 3.33 取引に関連付けられた送料。
tax number × 1.11 取引に関連付けられた税金。
items Array<Item> はい イベントの商品アイテム。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテムの ID。

*item_id または item_name が必要です。

item_name string ○* Stan and Friends Tee

商品アイテムの名前。

*item_id または item_name が必要です。

affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
注: 「affiliation」はアイテム スコープでのみ使用できます。
coupon string × SUMMER_FUN 商品アイテムに関連付けられたクーポンの名前またはコード。

イベント単位と商品アイテム単位の coupon パラメータは独立しています。
creative_name string × summer_banner2 プロモーション用のクリエイティブの名前。

設定すると、イベント単位の creative_name は無視されます。
設定しない場合、イベント単位の creative_name(存在する場合)が使用されます。
creative_slot string × featured_app_1 商品アイテムに関連付けられたプロモーション用のクリエイティブ スロットの名前。

設定すると、イベント単位の creative_slot は無視されます。
設定しない場合、イベント単位の creative_slot(存在する場合)が使用されます。
discount number × 2.22 商品アイテムに関連付けられた割引額の単位。
index number × 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × アパレル 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
item_category2 string × Adult 商品アイテムのカテゴリの第 2 階層またはその他の分類。
item_category3 string × Shirts 商品アイテムのカテゴリの第 3 階層またはその他の分類。
item_category4 string × Crew 商品アイテムのカテゴリの第 4 階層またはその他の分類。
item_category5 string × Short sleeve 商品アイテムのカテゴリの第 5 階層またはその他の分類。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。

設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id(存在する場合)が使用されます。
item_list_name string × 関連プロダクト ユーザーに商品アイテムが表示されたリストの名前。

設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name(存在する場合)が使用されます。
item_variant string × green 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。
location_id string × ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) 商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。
注: 「location_id」はアイテム スコープでのみ使用できます。
price number × 1,001 万台 指定された通貨パラメータの単位で表した商品アイテムの価格の単位。
商品アイテムに割引を適用する場合は、price に割引単価を設定し、discount パラメータで単価割引を指定します。
promotion_id string × P_12345 商品アイテムに関連付けられたプロモーションの ID。

設定すると、イベント単位の promotion_id は無視されます。
設定しない場合、イベント単位の promotion_id(存在する場合)が使用されます。
promotion_name string × Summer Sale 商品アイテムに関連付けられたプロモーションの名前。

設定すると、イベント単位の promotion_name は無視されます。
設定しない場合、イベント単位の promotion_name(存在する場合)が使用されます。
quantity number × 3

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。

items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: purchase
    • e コマース アイテム - ecommerce.items
    • e コマース トランザクション ID - ecommerce.transaction_id
    • e コマースの値 - ecommerce.value
    • e コマースの税 - ecommerce.tax
    • e コマースの配送 - ecommerce.shipping
    • e コマースの通貨 - ecommerce.currency
    • e コマースのクーポン - ecommerce.coupon
  • イベント パラメータ(パラメータ名 - 値):
    • items - &lbrace;&lbrace;e コマース アイテム&rbrace;&rbrace;
    • transaction_id - &lbrace;&lbrace;e コマース トランザクション ID&rbrace;&rbrace;
    • value - &lbrace;&lbrace;e コマースの値&rbrace;&rbrace;
    • tax - &lbrace;&lbrace;e コマースの税&rbrace;&rbrace;
    • shipping - &lbrace;&lbrace;e コマースの配送&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;e コマースの通貨&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;e コマースのクーポン&rbrace;&rbrace;
  • トリガー: event が purchase と等しい

トリガーの設定:

  • トリガーのタイプ: カスタム イベント
  • イベント名: purchase
  • このトリガーの発生場所: すべてのカスタム イベント
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "purchase",
  ecommerce: {
    transaction_id: "T_12345",
    // Sum of (price * quantity) for all items.
    value: 72.05,
    tax: 3.60,
    shipping: 5.99,
    currency: "USD",
    coupon: "SUMMER_SALE",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

refund

このイベントは、1 つ以上の商品アイテムについてユーザーに払い戻しが行われたことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
currency string ○* USD イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。

*value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
transaction_id string はい T_12345 取引を一意に識別する ID。
value number ○* 3,003 万台 イベントの金銭的価値。

* valueitems 内のすべてのアイテムの (price * quantity) の合計に設定します。shipping または tax は含めないでください。
* 有意義なレポートを作成するには、通常 value が必要です。 イベントにコンバージョンとしてマークを付ける場合は、value を設定することをおすすめします。
* value を設定する場合は currency が必要です。
coupon string × SUMMER_FUN イベントに関連付けられたクーポンの名前またはコード。

イベント単位と商品アイテム単位の coupon パラメータは独立しています。
shipping number × 3.33 取引に関連付けられた送料。
tax number × 1.11 取引に関連付けられた税金。
items Array<Item> ×* イベントの商品アイテム。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテムの ID。

*item_id または item_name が必要です。

item_name string ○* Stan and Friends Tee

商品アイテムの名前。

*item_id または item_name が必要です。

affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
注: 「affiliation」はアイテム スコープでのみ使用できます。
coupon string × SUMMER_FUN 商品アイテムに関連付けられたクーポンの名前またはコード。

イベント単位と商品アイテム単位の coupon パラメータは独立しています。
creative_name string × summer_banner2 プロモーション用のクリエイティブの名前。

設定すると、イベント単位の creative_name は無視されます。
設定しない場合、イベント単位の creative_name(存在する場合)が使用されます。
creative_slot string × featured_app_1 商品アイテムに関連付けられたプロモーション用のクリエイティブ スロットの名前。

設定すると、イベント単位の creative_slot は無視されます。
設定しない場合、イベント単位の creative_slot(存在する場合)が使用されます。
discount number × 2.22 商品アイテムに関連付けられた割引額の単位。
index number × 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × アパレル 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
item_category2 string × Adult 商品アイテムのカテゴリの第 2 階層またはその他の分類。
item_category3 string × Shirts 商品アイテムのカテゴリの第 3 階層またはその他の分類。
item_category4 string × Crew 商品アイテムのカテゴリの第 4 階層またはその他の分類。
item_category5 string × Short sleeve 商品アイテムのカテゴリの第 5 階層またはその他の分類。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。

設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id(存在する場合)が使用されます。
item_list_name string × 関連プロダクト ユーザーに商品アイテムが表示されたリストの名前。

設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name(存在する場合)が使用されます。
item_variant string × green 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。
location_id string × ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) 商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。
注: 「location_id」はアイテム スコープでのみ使用できます。
price number × 1,001 万台 指定された通貨パラメータの単位で表した商品アイテムの価格の単位。
商品アイテムに割引を適用する場合は、price に割引単価を設定し、discount パラメータで単価割引を指定します。
promotion_id string × P_12345 商品アイテムに関連付けられたプロモーションの ID。

設定すると、イベント単位の promotion_id は無視されます。
設定しない場合、イベント単位の promotion_id(存在する場合)が使用されます。
promotion_name string × Summer Sale 商品アイテムに関連付けられたプロモーションの名前。

設定すると、イベント単位の promotion_name は無視されます。
設定しない場合、イベント単位の promotion_name(存在する場合)が使用されます。
quantity number × 3

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。

items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: refund
  • データレイヤー変数(名前 - データレイヤー変数名):
    • e コマース アイテム - ecommerce.items
    • e コマース トランザクション ID - ecommerce.transaction_id
    • e コマースの値 - ecommerce.value
    • e コマースの税 - ecommerce.tax
    • e コマースの配送 - ecommerce.shipping
    • e コマースの通貨 - ecommerce.currency
    • e コマースのクーポン - ecommerce.coupon
  • イベント パラメータ(パラメータ名 - 値):
    • items - &lbrace;&lbrace;e コマース アイテム&rbrace;&rbrace;
    • transaction_id - &lbrace;&lbrace;e コマース トランザクション ID&rbrace;&rbrace;
    • value - &lbrace;&lbrace;e コマースの値&rbrace;&rbrace;
    • tax - &lbrace;&lbrace;e コマースの税&rbrace;&rbrace;
    • shipping - &lbrace;&lbrace;e コマースの配送&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;e コマースの通貨&rbrace;&rbrace;
    • coupon - &lbrace;&lbrace;e コマースのクーポン&rbrace;&rbrace;
  • トリガー: event が refund と等しい

トリガーの設定:

  • トリガーのタイプ: カスタム イベント
  • イベント名: refund
  • このトリガーの発生場所: すべてのカスタム イベント
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "refund",
  ecommerce: {
    currency: "USD",
    transaction_id: "T_12345", // Transaction ID. Required for purchases and refunds.
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping: 3.33,
    tax: 1.11,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

remove_from_cart

このイベントは、商品アイテムがカートから削除されたことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
currency string ○* USD イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。

*value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
value number ○* 3,003 万台 イベントの金銭的価値。

* valueitems 内のすべてのアイテムの (price * quantity) の合計に設定します。shipping または tax は含めないでください。
* 有意義なレポートを作成するには、通常 value が必要です。 イベントにコンバージョンとしてマークを付ける場合は、value を設定することをおすすめします。
* value を設定する場合は currency が必要です。
items Array<Item> イベントの商品アイテム。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテムの ID。

*item_id または item_name が必要です。

item_name string ○* Stan and Friends Tee

商品アイテムの名前。

*item_id または item_name が必要です。

affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
注: 「affiliation」はアイテム スコープでのみ使用できます。
coupon string × SUMMER_FUN 商品アイテムに関連付けられたクーポンの名前またはコード。

イベント単位と商品アイテム単位の coupon パラメータは独立しています。
creative_name string × summer_banner2 プロモーション用のクリエイティブの名前。

設定すると、イベント単位の creative_name は無視されます。
設定しない場合、イベント単位の creative_name(存在する場合)が使用されます。
creative_slot string × featured_app_1 商品アイテムに関連付けられたプロモーション用のクリエイティブ スロットの名前。

設定すると、イベント単位の creative_slot は無視されます。
設定しない場合、イベント単位の creative_slot(存在する場合)が使用されます。
discount number × 2.22 商品アイテムに関連付けられた割引額の単位。
index number × 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × アパレル 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
item_category2 string × Adult 商品アイテムのカテゴリの第 2 階層またはその他の分類。
item_category3 string × Shirts 商品アイテムのカテゴリの第 3 階層またはその他の分類。
item_category4 string × Crew 商品アイテムのカテゴリの第 4 階層またはその他の分類。
item_category5 string × Short sleeve 商品アイテムのカテゴリの第 5 階層またはその他の分類。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。

設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id(存在する場合)が使用されます。
item_list_name string × 関連プロダクト ユーザーに商品アイテムが表示されたリストの名前。

設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name(存在する場合)が使用されます。
item_variant string × green 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。
location_id string × ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) 商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。
注: 「location_id」はアイテム スコープでのみ使用できます。
price number × 1,001 万台 指定された通貨パラメータの単位で表した商品アイテムの価格の単位。
商品アイテムに割引を適用する場合は、price に割引単価を設定し、discount パラメータで単価割引を指定します。
promotion_id string × P_12345 商品アイテムに関連付けられたプロモーションの ID。

設定すると、イベント単位の promotion_id は無視されます。
設定しない場合、イベント単位の promotion_id(存在する場合)が使用されます。
promotion_name string × Summer Sale 商品アイテムに関連付けられたプロモーションの名前。

設定すると、イベント単位の promotion_name は無視されます。
設定しない場合、イベント単位の promotion_name(存在する場合)が使用されます。
quantity number × 3

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。

items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: remove_from_cart
  • データレイヤー変数(名前 - データレイヤー変数名):
    • e コマース アイテム - ecommerce.items
    • e コマースの値 - ecommerce.value
    • e コマースの通貨 - ecommerce.currency
  • イベント パラメータ(パラメータ名 - 値):
    • items - &lbrace;&lbrace;e コマース アイテム&rbrace;&rbrace;
    • value - &lbrace;&lbrace;e コマースの値&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;e コマースの通貨&rbrace;&rbrace;
  • トリガー: event が remove_from_cart と等しい

トリガーの設定:

  • トリガーのタイプ: カスタム イベント
  • イベント名: remove_from_cart
  • このトリガーの発生場所: すべてのカスタム イベント
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "remove_from_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

ユーザーが検索を行ったときに、このイベントをログに記録します。このイベントを使用すると、ウェブサイトやアプリで検索を行っているユーザーを識別できます。たとえば、ユーザーが検索後に検索結果ページを閲覧したときにこのイベントを送信できます。

パラメータ

名前 タイプ 必須 値の例 説明
search_term string はい t-shirts 検索されたキーワード。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: search
  • イベント パラメータ(パラメータ名 - 値):
    • search_term - T シャツ
  • トリガー: ユーザーがウェブサイトで検索したとき

select_content

このイベントは、ユーザーが特定のタイプのコンテンツを選択したことを示します。 このイベントを使用すると、ウェブサイトやアプリで人気のあるコンテンツとコンテンツのカテゴリを特定できます。

パラメータ

名前 タイプ 必須 値の例 説明
content_type string × product 選択されたコンテンツの種類。
content_id string × C_12345 選択されたコンテンツの識別子。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: select_content
  • イベント パラメータ(パラメータ名 - 値):
    • content_type - 商品
    • content_id~ C_12345
  • トリガー: event が select_content と等しい

select_item

このイベントは、リストから商品アイテムが選択されたことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。

商品アイテム単位で設定されている場合は無視されます。
item_list_name string × 関連プロダクト ユーザーに商品アイテムが表示されたリストの名前。

商品アイテム単位で設定されている場合は無視されます。
items Array<Item> ○* イベントの商品アイテム。

*items 配列では、選択された商品アイテムを表す要素を 1 つだけ含むことが想定されています。複数の要素が指定されている場合、items の最初の要素のみが使用されます。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテムの ID。

*item_id または item_name が必要です。

item_name string ○* Stan and Friends Tee

商品アイテムの名前。

*item_id または item_name が必要です。

affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
注: 「affiliation」はアイテム スコープでのみ使用できます。
coupon string × SUMMER_FUN 商品アイテムに関連付けられたクーポンの名前またはコード。

イベント単位と商品アイテム単位の coupon パラメータは独立しています。
creative_name string × summer_banner2 プロモーション用のクリエイティブの名前。

設定すると、イベント単位の creative_name は無視されます。
設定しない場合、イベント単位の creative_name(存在する場合)が使用されます。
creative_slot string × featured_app_1 商品アイテムに関連付けられたプロモーション用のクリエイティブ スロットの名前。

設定すると、イベント単位の creative_slot は無視されます。
設定しない場合、イベント単位の creative_slot(存在する場合)が使用されます。
discount number × 2.22 商品アイテムに関連付けられた割引額の単位。
index number × 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × アパレル 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
item_category2 string × Adult 商品アイテムのカテゴリの第 2 階層またはその他の分類。
item_category3 string × Shirts 商品アイテムのカテゴリの第 3 階層またはその他の分類。
item_category4 string × Crew 商品アイテムのカテゴリの第 4 階層またはその他の分類。
item_category5 string × Short sleeve 商品アイテムのカテゴリの第 5 階層またはその他の分類。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。

設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id(存在する場合)が使用されます。
item_list_name string × 関連プロダクト ユーザーに商品アイテムが表示されたリストの名前。

設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name(存在する場合)が使用されます。
item_variant string × green 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。
location_id string × ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) 商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。
注: 「location_id」はアイテム スコープでのみ使用できます。
price number × 1,001 万台 指定された通貨パラメータの単位で表した商品アイテムの価格の単位。
商品アイテムに割引を適用する場合は、price に割引単価を設定し、discount パラメータで単価割引を指定します。
promotion_id string × P_12345 商品アイテムに関連付けられたプロモーションの ID。

設定すると、イベント単位の promotion_id は無視されます。
設定しない場合、イベント単位の promotion_id(存在する場合)が使用されます。
promotion_name string × Summer Sale 商品アイテムに関連付けられたプロモーションの名前。

設定すると、イベント単位の promotion_name は無視されます。
設定しない場合、イベント単位の promotion_name(存在する場合)が使用されます。
quantity number × 3

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。

items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: select_item
  • データレイヤー変数(名前 - データレイヤー変数名):
    • e コマース アイテム - ecommerce.items
    • e コマースのアイテムリスト ID - ecommerce.item_list_id
    • e コマースのアイテムリスト名 - ecommerce.item_list_name
  • イベント パラメータ(パラメータ名 - 値):
    • items - &lbrace;&lbrace;e コマース アイテム&rbrace;&rbrace;
    • item_list_id - &lbrace;&lbrace;e コマースのアイテムリスト ID&rbrace;&rbrace;
    • item_list_name - &lbrace;&lbrace;e コマースのアイテムリスト名&rbrace;&rbrace;
  • トリガー: event が select_item と等しい

トリガーの設定:

  • トリガーのタイプ: カスタム イベント
  • イベント名: select_item
  • このトリガーの発生場所: すべてのカスタム イベント
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_item",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

select_promotion

このイベントは、リストからプロモーションが選択されたことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
creative_name string × summer_banner2 プロモーション用のクリエイティブの名前。

商品アイテム単位で設定されている場合は無視されます。
creative_slot string × featured_app_1 イベントに関連付けられたプロモーション用のクリエイティブ スロットの名前。

商品アイテム単位で設定されている場合は無視されます。
promotion_id string × P_12345 イベントに関連付けられたプロモーションの ID。

商品アイテム単位で設定されている場合は無視されます。
promotion_name string × Summer Sale イベントに関連付けられたプロモーションの名前。

商品アイテム単位で設定されている場合は無視されます。
items Array<Item> × イベントの商品アイテム。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテムの ID。

*item_id または item_name が必要です。

item_name string ○* Stan and Friends Tee

商品アイテムの名前。

*item_id または item_name が必要です。

affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
注: 「affiliation」はアイテム スコープでのみ使用できます。
coupon string × SUMMER_FUN 商品アイテムに関連付けられたクーポンの名前またはコード。

イベント単位と商品アイテム単位の coupon パラメータは独立しています。
creative_name string × summer_banner2 プロモーション用のクリエイティブの名前。

設定すると、イベント単位の creative_name は無視されます。
設定しない場合、イベント単位の creative_name(存在する場合)が使用されます。
creative_slot string × featured_app_1 商品アイテムに関連付けられたプロモーション用のクリエイティブ スロットの名前。

設定すると、イベント単位の creative_slot は無視されます。
設定しない場合、イベント単位の creative_slot(存在する場合)が使用されます。
discount number × 2.22 商品アイテムに関連付けられた割引額の単位。
index number × 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × アパレル 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
item_category2 string × Adult 商品アイテムのカテゴリの第 2 階層またはその他の分類。
item_category3 string × Shirts 商品アイテムのカテゴリの第 3 階層またはその他の分類。
item_category4 string × Crew 商品アイテムのカテゴリの第 4 階層またはその他の分類。
item_category5 string × Short sleeve 商品アイテムのカテゴリの第 5 階層またはその他の分類。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。

設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id(存在する場合)が使用されます。
item_list_name string × 関連プロダクト ユーザーに商品アイテムが表示されたリストの名前。

設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name(存在する場合)が使用されます。
item_variant string × green 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。
location_id string × ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) 商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。
注: 「location_id」はアイテム スコープでのみ使用できます。
price number × 1,001 万台 指定された通貨パラメータの単位で表した商品アイテムの価格の単位。
商品アイテムに割引を適用する場合は、price に割引単価を設定し、discount パラメータで単価割引を指定します。
promotion_id string × P_12345 商品アイテムに関連付けられたプロモーションの ID。

設定すると、イベント単位の promotion_id は無視されます。
設定しない場合、イベント単位の promotion_id(存在する場合)が使用されます。
promotion_name string × Summer Sale 商品アイテムに関連付けられたプロモーションの名前。

設定すると、イベント単位の promotion_name は無視されます。
設定しない場合、イベント単位の promotion_name(存在する場合)が使用されます。
quantity number × 3

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。

items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • データレイヤー変数(名前 - データレイヤー変数名):
    • e コマースのクリエイティブ名 - ecommerce.creative_name
    • e コマースのクリエイティブ スロット - ecommerce.creative_slot
    • e コマースのプロモーション ID - ecommerce.promotion_id
    • e コマースのプロモーション名 - ecommerce.promotion_name
    • e コマース アイテム - ecommerce.items
  • イベント パラメータ(パラメータ名 - 値):
    • creative_name - &lbrace;&lbrace;e コマースのクリエイティブ名&rbrace;&rbrace;
    • creative_slot - &lbrace;&lbrace;e コマースのクリエイティブ スロット&rbrace;&rbrace;
    • promotion_id - &lbrace;&lbrace;e コマースのプロモーション ID&rbrace;&rbrace;
    • promotion_name - &lbrace;&lbrace;e コマースのプロモーション名&rbrace;&rbrace;
    • items - &lbrace;&lbrace;e コマース アイテム&rbrace;&rbrace;
  • 変数タイプ: データレイヤー変数 - 'ecommerce.items'
  • トリガー: event が select_promotion と等しい

トリガーの設定:

  • トリガーのタイプ: カスタム イベント
  • イベント名: select_promotion
  • このトリガーの発生場所: すべてのカスタム イベント
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_promotion",
  ecommerce: {
    creative_name: "Summer Banner",
    creative_slot: "featured_app_1",
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

share

このイベントは、ユーザーがコンテンツを共有した際に使用されます。

パラメータ

名前 タイプ 必須 値の例 説明
method string × Twitter コンテンツを共有する方法。
content_type string × イメージ 共有コンテンツの種類。
item_id string × C_12345 共有コンテンツの ID。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: share
  • イベント パラメータ(パラメータ名 - 値):
    • method - Twitter
    • content_type - 画像
    • item_id~ C_12345
  • トリガー: ユーザーがコンテンツを共有したとき

sign_up

このイベントは、ユーザーがアカウントに登録したことを示します。ログインしているユーザーとログインしていないユーザーの行動の違いを把握するには、このイベントを使用します。

パラメータ

名前 タイプ 必須 値の例 説明
method string × Google 登録に使用された方法。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: sign_up
  • イベント パラメータ(パラメータ名 - 値):
    • method - Google
  • トリガー: ユーザーがアカウントに登録したとき

spend_virtual_currency

このイベントでは、アプリ内の仮想アイテムの売り上げを測定して、最も人気のある仮想アイテムを特定することができます。

パラメータ

名前 タイプ 必須 値の例 説明
value number はい 5 仮想通貨の価値。
virtual_currency_name string Gems 仮想通貨の名前。
item_name string × Starter Boost 仮想通貨が使用されている商品アイテムの名前。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: spend_virtual_currency
  • イベント パラメータ(パラメータ名 - 値):
    • value~ 5
    • virtual_currency_name - ジェム
    • item_name - スターター ブースト
  • トリガー: ユーザーがバーチャル アイテムを購入したとき

tutorial_begin

このイベントは、オンボーディング プロセスの開始を示します。チュートリアルを完了したユーザー数を把握するには、このイベントを目標到達プロセスで tutorial_complete とともに使用します。

パラメータ

このイベントのパラメータはありません。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: tutorial_begin
  • トリガー: ユーザーがオンボーディング プロセスを開始したとき

tutorial_complete

このイベントは、ユーザーがオンボーディング プロセスを完了したことを示します。チュートリアルを完了したユーザー数を把握するには、このイベントを目標到達プロセスで tutorial_begin とともに使用します。

パラメータ

このイベントで使用するパラメータの候補はありません。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: tutorial_complete
  • トリガー: ユーザーがオンボーディング プロセスを完了したとき

unlock_achievement

ユーザーがレベルを達成したときに、このイベントをログに記録します。このイベントを使用すると、ユーザーによるゲームの利用状況を把握できます。

パラメータ

名前 タイプ 必須 値の例 説明
achievement_id string はい A_12345 達成されたレベルの ID。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: unlock_achievement
  • イベント パラメータ(パラメータ名 - 値):
    • achievement_id~ A_12345
  • トリガー: ユーザーがレベルを達成したとき

view_cart

このイベントは、ユーザーがカートを表示したことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
currency string ○* USD イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。

*value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
value number ○* 3,003 万台 イベントの金銭的価値。

* valueitems 内のすべてのアイテムの (price * quantity) の合計に設定します。shipping または tax は含めないでください。
* 有意義なレポートを作成するには、通常 value が必要です。 イベントにコンバージョンとしてマークを付ける場合は、value を設定することをおすすめします。
* value を設定する場合は currency が必要です。
items Array<Item> イベントの商品アイテム。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテムの ID。

*item_id または item_name が必要です。

item_name string ○* Stan and Friends Tee

商品アイテムの名前。

*item_id または item_name が必要です。

affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
注: 「affiliation」はアイテム スコープでのみ使用できます。
coupon string × SUMMER_FUN 商品アイテムに関連付けられたクーポンの名前またはコード。

イベント単位と商品アイテム単位の coupon パラメータは独立しています。
creative_name string × summer_banner2 プロモーション用のクリエイティブの名前。

設定すると、イベント単位の creative_name は無視されます。
設定しない場合、イベント単位の creative_name(存在する場合)が使用されます。
creative_slot string × featured_app_1 商品アイテムに関連付けられたプロモーション用のクリエイティブ スロットの名前。

設定すると、イベント単位の creative_slot は無視されます。
設定しない場合、イベント単位の creative_slot(存在する場合)が使用されます。
discount number × 2.22 商品アイテムに関連付けられた割引額の単位。
index number × 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × アパレル 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
item_category2 string × Adult 商品アイテムのカテゴリの第 2 階層またはその他の分類。
item_category3 string × Shirts 商品アイテムのカテゴリの第 3 階層またはその他の分類。
item_category4 string × Crew 商品アイテムのカテゴリの第 4 階層またはその他の分類。
item_category5 string × Short sleeve 商品アイテムのカテゴリの第 5 階層またはその他の分類。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。

設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id(存在する場合)が使用されます。
item_list_name string × 関連プロダクト ユーザーに商品アイテムが表示されたリストの名前。

設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name(存在する場合)が使用されます。
item_variant string × green 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。
location_id string × ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) 商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。
注: 「location_id」はアイテム スコープでのみ使用できます。
price number × 1,001 万台 指定された通貨パラメータの単位で表した商品アイテムの価格の単位。
商品アイテムに割引を適用する場合は、price に割引単価を設定し、discount パラメータで単価割引を指定します。
promotion_id string × P_12345 商品アイテムに関連付けられたプロモーションの ID。

設定すると、イベント単位の promotion_id は無視されます。
設定しない場合、イベント単位の promotion_id(存在する場合)が使用されます。
promotion_name string × Summer Sale 商品アイテムに関連付けられたプロモーションの名前。

設定すると、イベント単位の promotion_name は無視されます。
設定しない場合、イベント単位の promotion_name(存在する場合)が使用されます。
quantity number × 3

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。

items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: view_cart
  • データレイヤー変数(名前 - データレイヤー変数名):
    • e コマース アイテム - ecommerce.items
    • e コマースの値 - ecommerce.value
    • e コマースの通貨 - ecommerce.currency
  • イベント パラメータ(パラメータ名 - 値):
    • items - &lbrace;&lbrace;e コマース アイテム&rbrace;&rbrace;
    • value - &lbrace;&lbrace;e コマースの値&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;e コマースの通貨&rbrace;&rbrace;
  • トリガー: event が view_cart と等しい

トリガーの設定:

  • トリガーのタイプ: カスタム イベント
  • イベント名: view_cart
  • このトリガーの発生場所: すべてのカスタム イベント
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

view_item

このイベントは、一部のコンテンツがユーザーに表示されたことを示します。最もよく閲覧されている商品アイテムを特定するには、このイベントを使用します。

パラメータ

名前 タイプ 必須 値の例 説明
currency string ○* USD イベントに関連付けられた商品アイテムの通貨(3 文字の ISO 4217 形式)。

*value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
value number ○* 3,003 万台 イベントの金銭的価値。

* valueitems 内のすべてのアイテムの (price * quantity) の合計に設定します。shipping または tax は含めないでください。
* 有意義なレポートを作成するには、通常 value が必要です。 イベントにコンバージョンとしてマークを付ける場合は、value を設定することをおすすめします。
* value を設定する場合は currency が必要です。
items Array<Item> イベントの商品アイテム。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテムの ID。

*item_id または item_name が必要です。

item_name string ○* Stan and Friends Tee

商品アイテムの名前。

*item_id または item_name が必要です。

affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
注: 「affiliation」はアイテム スコープでのみ使用できます。
coupon string × SUMMER_FUN 商品アイテムに関連付けられたクーポンの名前またはコード。

イベント単位と商品アイテム単位の coupon パラメータは独立しています。
creative_name string × summer_banner2 プロモーション用のクリエイティブの名前。

設定すると、イベント単位の creative_name は無視されます。
設定しない場合、イベント単位の creative_name(存在する場合)が使用されます。
creative_slot string × featured_app_1 商品アイテムに関連付けられたプロモーション用のクリエイティブ スロットの名前。

設定すると、イベント単位の creative_slot は無視されます。
設定しない場合、イベント単位の creative_slot(存在する場合)が使用されます。
discount number × 2.22 商品アイテムに関連付けられた割引額の単位。
index number × 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × アパレル 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
item_category2 string × Adult 商品アイテムのカテゴリの第 2 階層またはその他の分類。
item_category3 string × Shirts 商品アイテムのカテゴリの第 3 階層またはその他の分類。
item_category4 string × Crew 商品アイテムのカテゴリの第 4 階層またはその他の分類。
item_category5 string × Short sleeve 商品アイテムのカテゴリの第 5 階層またはその他の分類。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。

設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id(存在する場合)が使用されます。
item_list_name string × 関連プロダクト ユーザーに商品アイテムが表示されたリストの名前。

設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name(存在する場合)が使用されます。
item_variant string × green 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。
location_id string × ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) 商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。
注: 「location_id」はアイテム スコープでのみ使用できます。
price number × 1,001 万台 指定された通貨パラメータの単位で表した商品アイテムの価格の単位。
商品アイテムに割引を適用する場合は、price に割引単価を設定し、discount パラメータで単価割引を指定します。
promotion_id string × P_12345 商品アイテムに関連付けられたプロモーションの ID。

設定すると、イベント単位の promotion_id は無視されます。
設定しない場合、イベント単位の promotion_id(存在する場合)が使用されます。
promotion_name string × Summer Sale 商品アイテムに関連付けられたプロモーションの名前。

設定すると、イベント単位の promotion_name は無視されます。
設定しない場合、イベント単位の promotion_name(存在する場合)が使用されます。
quantity number × 3

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。

items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: view_item
  • データレイヤー変数(名前 - データレイヤー変数名):
    • e コマース アイテム - ecommerce.items
    • e コマースの値 - ecommerce.value
    • e コマースの通貨 - ecommerce.currency
  • イベント パラメータ(パラメータ名 - 値):
    • items - &lbrace;&lbrace;e コマース アイテム&rbrace;&rbrace;
    • value - &lbrace;&lbrace;e コマースの値&rbrace;&rbrace;
    • currency - &lbrace;&lbrace;e コマースの通貨&rbrace;&rbrace;
  • トリガー: event が view_item と等しい

トリガーの設定:

  • トリガーのタイプ: カスタム イベント
  • イベント名: view_item
  • このトリガーの発生場所: すべてのカスタム イベント
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

view_item_list

ユーザーに特定のカテゴリの商品アイテムのリストが表示されたときに、このイベントをログに記録します。

パラメータ

名前 タイプ 必須 値の例 説明
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。

商品アイテム単位で設定されている場合は無視されます。
item_list_name string × 関連プロダクト ユーザーに商品アイテムが表示されたリストの名前。

商品アイテム単位で設定されている場合は無視されます。
items Array<Item> イベントの商品アイテム。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテムの ID。

*item_id または item_name が必要です。

item_name string ○* Stan and Friends Tee

商品アイテムの名前。

*item_id または item_name が必要です。

affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
注: 「affiliation」はアイテム スコープでのみ使用できます。
coupon string × SUMMER_FUN 商品アイテムに関連付けられたクーポンの名前またはコード。

イベント単位と商品アイテム単位の coupon パラメータは独立しています。
creative_name string × summer_banner2 プロモーション用のクリエイティブの名前。

設定すると、イベント単位の creative_name は無視されます。
設定しない場合、イベント単位の creative_name(存在する場合)が使用されます。
creative_slot string × featured_app_1 商品アイテムに関連付けられたプロモーション用のクリエイティブ スロットの名前。

設定すると、イベント単位の creative_slot は無視されます。
設定しない場合、イベント単位の creative_slot(存在する場合)が使用されます。
discount number × 2.22 商品アイテムに関連付けられた割引額の単位。
index number × 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × アパレル 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
item_category2 string × Adult 商品アイテムのカテゴリの第 2 階層またはその他の分類。
item_category3 string × Shirts 商品アイテムのカテゴリの第 3 階層またはその他の分類。
item_category4 string × Crew 商品アイテムのカテゴリの第 4 階層またはその他の分類。
item_category5 string × Short sleeve 商品アイテムのカテゴリの第 5 階層またはその他の分類。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。

設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id(存在する場合)が使用されます。
item_list_name string × 関連プロダクト ユーザーに商品アイテムが表示されたリストの名前。

設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name(存在する場合)が使用されます。
item_variant string × green 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。
location_id string × ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) 商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。
注: 「location_id」はアイテム スコープでのみ使用できます。
price number × 1,001 万台 指定された通貨パラメータの単位で表した商品アイテムの価格の単位。
商品アイテムに割引を適用する場合は、price に割引単価を設定し、discount パラメータで単価割引を指定します。
promotion_id string × P_12345 商品アイテムに関連付けられたプロモーションの ID。

設定すると、イベント単位の promotion_id は無視されます。
設定しない場合、イベント単位の promotion_id(存在する場合)が使用されます。
promotion_name string × Summer Sale 商品アイテムに関連付けられたプロモーションの名前。

設定すると、イベント単位の promotion_name は無視されます。
設定しない場合、イベント単位の promotion_name(存在する場合)が使用されます。
quantity number × 3

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。

items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: view_item_list
  • データレイヤー変数(名前 - データレイヤー変数名):
    • e コマース アイテム - ecommerce.items
    • e コマースのアイテムリスト ID - ecommerce.item_list_id
    • e コマースのアイテムリスト名 - ecommerce.item_list_name
  • イベント パラメータ(パラメータ名 - 値):
    • items - &lbrace;&lbrace;e コマース アイテム&rbrace;&rbrace;
    • item_list_id - &lbrace;&lbrace;e コマースのアイテムリスト ID&rbrace;&rbrace;
    • item_list_name - &lbrace;&lbrace;e コマースのアイテムリスト名&rbrace;&rbrace;
  • トリガー: event が view_item_list と等しい

トリガーの設定:

  • トリガーのタイプ: カスタム イベント
  • イベント名: view_item_list
  • このトリガーの発生場所: すべてのカスタム イベント
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item_list",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
     {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.03,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

view_promotion

このイベントは、リストからプロモーションが表示されたことを示します。

パラメータ

名前 タイプ 必須 値の例 説明
creative_name string × summer_banner2 プロモーション用のクリエイティブの名前。

商品アイテム単位で設定されている場合は無視されます。
creative_slot string × featured_app_1 イベントに関連付けられたプロモーション用のクリエイティブ スロットの名前。

商品アイテム単位で設定されている場合は無視されます。
promotion_id string × P_12345 イベントに関連付けられたプロモーションの ID。

商品アイテム単位で設定されている場合は無視されます。
promotion_name string × Summer Sale イベントに関連付けられたプロモーションの名前。

商品アイテム単位で設定されている場合は無視されます。
items Array<Item> ○* イベントの商品アイテム。

*items 配列では、プロモーションに関連付けられた商品アイテムを表す要素を 1 つだけ含むことが想定されています。複数の要素が指定されている場合、items の最初の要素のみが使用されます。

商品アイテム パラメータ

名前 タイプ 必須 値の例 説明
item_id string ○* SKU_12345

商品アイテムの ID。

*item_id または item_name が必要です。

item_name string ○* Stan and Friends Tee

商品アイテムの名前。

*item_id または item_name が必要です。

affiliation string × Google Store 仕入れ先業者や実店舗を指定する商品アフィリエーション。
注: 「affiliation」はアイテム スコープでのみ使用できます。
coupon string × SUMMER_FUN 商品アイテムに関連付けられたクーポンの名前またはコード。

イベント単位と商品アイテム単位の coupon パラメータは独立しています。
creative_name string × summer_banner2 プロモーション用のクリエイティブの名前。

設定すると、イベント単位の creative_name は無視されます。
設定しない場合、イベント単位の creative_name(存在する場合)が使用されます。
creative_slot string × featured_app_1 商品アイテムに関連付けられたプロモーション用のクリエイティブ スロットの名前。

設定すると、イベント単位の creative_slot は無視されます。
設定しない場合、イベント単位の creative_slot(存在する場合)が使用されます。
discount number × 2.22 商品アイテムに関連付けられた割引額の単位。
index number × 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × アパレル 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
item_category2 string × Adult 商品アイテムのカテゴリの第 2 階層またはその他の分類。
item_category3 string × Shirts 商品アイテムのカテゴリの第 3 階層またはその他の分類。
item_category4 string × Crew 商品アイテムのカテゴリの第 4 階層またはその他の分類。
item_category5 string × Short sleeve 商品アイテムのカテゴリの第 5 階層またはその他の分類。
item_list_id string × related_products ユーザーに商品アイテムが表示されたリストの ID。

設定すると、イベント単位の item_list_id は無視されます。
設定しない場合、イベント単位の item_list_id(存在する場合)が使用されます。
item_list_name string × 関連プロダクト ユーザーに商品アイテムが表示されたリストの名前。

設定すると、イベント単位の item_list_name は無視されます。
設定しない場合、イベント単位の item_list_name(存在する場合)が使用されます。
item_variant string × green 商品アイテムのバリエーションまたは固有のコード、あるいはその他の詳細やオプションに関する説明。
location_id string × ChIJIQBpAG2ahYAR_6128GcTUEo(サンフランシスコの Google プレイス ID) 商品アイテムに関連付けられた場所(実店舗の所在地など)。関連するアイテムに対応する Google プレイス ID を使用することをおすすめします。カスタムの地域 ID も使用できます。
注: 「location_id」はアイテム スコープでのみ使用できます。
price number × 1,001 万台 指定された通貨パラメータの単位で表した商品アイテムの価格の単位。
商品アイテムに割引を適用する場合は、price に割引単価を設定し、discount パラメータで単価割引を指定します。
promotion_id string × P_12345 商品アイテムに関連付けられたプロモーションの ID。

設定すると、イベント単位の promotion_id は無視されます。
設定しない場合、イベント単位の promotion_id(存在する場合)が使用されます。
promotion_name string × Summer Sale 商品アイテムに関連付けられたプロモーションの名前。

設定すると、イベント単位の promotion_name は無視されます。
設定しない場合、イベント単位の promotion_name(存在する場合)が使用されます。
quantity number × 3

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。

items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

以下はタグ マネージャーの実装例です。

タグの設定を確認する

タグの設定:

  • タグタイプ: GA4 イベント
  • イベント名: view_promotion
  • データレイヤー変数(名前 - データレイヤー変数名):
    • e コマースのクリエイティブ名 - ecommerce.creative_name
    • e コマースのクリエイティブ スロット - ecommerce.creative_slot
    • e コマースのプロモーション ID - ecommerce.promotion_id
    • e コマースのプロモーション名 - ecommerce.promotion_name
    • e コマース アイテム - ecommerce.items
  • イベント パラメータ(パラメータ名 - 値):
    • creative_name - &lbrace;&lbrace;e コマースのクリエイティブ名&rbrace;&rbrace;
    • creative_slot - &lbrace;&lbrace;e コマースのクリエイティブ スロット&rbrace;&rbrace;
    • promotion_id - &lbrace;&lbrace;e コマースのプロモーション ID&rbrace;&rbrace;
    • promotion_name - &lbrace;&lbrace;e コマースのプロモーション名&rbrace;&rbrace;
    • items - &lbrace;&lbrace;e コマース アイテム&rbrace;&rbrace;
  • トリガー: event が view_promotion と等しい

トリガーの設定:

  • トリガーのタイプ: カスタム イベント
  • イベント名: view_promotion
  • このトリガーの発生場所: すべてのカスタム イベント
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_promotion",
  ecommerce: {
    creative_name: "Summer Banner",
    creative_slot: "featured_app_1",
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});