推奨イベント

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

Google タグ タグ マネージャー Firebase

add_payment_info

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

パラメータ

名前	タイプ	必須	値の例	説明
currency	string	○*	USD	イベントに関連付けられた商品アイテムの通貨（3 文字の ISO 4217 形式）。 *value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
value	number	○*	3,003 万台	イベントの金銭的価値。 * value を items 内のすべてのアイテムの (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 の カスタム パラメータ を含めることができます。

例

以下は gtag.js の実装例です。

gtag("event", "add_payment_info", {
  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 万台	イベントの金銭的価値。 * value を items 内のすべてのアイテムの (price * quantity) の合計に設定します。shipping または tax は含めないでください。 * 有意義なレポートを作成するには、通常 value が必要です。 イベントにコンバージョンとしてマークを付ける場合は、value を設定することをおすすめします。 * value を設定する場合は currency が必要です。
coupon	string	×	SUMMER_FUN	イベントに関連付けられたクーポンの名前またはコード。 イベント単位と商品アイテム単位の coupon パラメータは独立しています。
shipping_tier	string	×	Ground	購入された商品アイテムの配送方法で選択されている送料区分（Ground、Air、Next-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 の カスタム パラメータ を含めることができます。

例

以下は gtag.js の実装例です。

gtag("event", "add_shipping_info", {
  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 万台	イベントの金銭的価値。 * value を items 内のすべてのアイテムの (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 の カスタム パラメータ を含めることができます。

例

以下は gtag.js の実装例です。

gtag("event", "add_to_cart", {
  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 万台	イベントの金銭的価値。 * value を items 内のすべてのアイテムの (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 の カスタム パラメータ を含めることができます。

例

以下は gtag.js の実装例です。

gtag("event", "add_to_wishlist", {
  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 万台	イベントの金銭的価値。 * value を items 内のすべてのアイテムの (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 の カスタム パラメータ を含めることができます。

例

以下は gtag.js の実装例です。

gtag("event", "begin_checkout", {
  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	仮想通貨の価値。

例

以下は gtag.js の実装例です。

gtag("event", "earn_virtual_currency", {
  virtual_currency_name: "Gems",
  value: 5
});

generate_lead

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

パラメータ

名前	タイプ	必須	値の例	説明
currency	string	○*	USD	イベントに関連付けられた商品アイテムの通貨（3 文字の ISO 4217 形式）。 *value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
value	number	○*	3,003 万台	イベントの金銭的価値。 * value を items 内のすべてのアイテムの (price * quantity) の合計に設定します。shipping または tax は含めないでください。 * 有意義なレポートを作成するには、通常 value が必要です。 イベントにコンバージョンとしてマークを付ける場合は、value を設定することをおすすめします。 * value を設定する場合は currency が必要です。

例

以下は gtag.js の実装例です。

gtag("event", "generate_lead", {
  currency: "USD",
  value: 99.99
});

join_group

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

パラメータ

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

例

以下は gtag.js の実装例です。

gtag("event", "join_group", {
  group_id: "G_12345"
});

level_end

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

パラメータ

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

例

以下は gtag.js の実装例です。

gtag("event", "level_end", {
  level_name: "The journey begins...",
  success: true
});

level_start

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

パラメータ

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

例

以下は gtag.js の実装例です。

gtag("event", "level_start", {
  level_name: "The journey begins..."
});

level_up

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

パラメータ

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

例

以下は gtag.js の実装例です。

gtag("event", "level_up", {
  level: 5,
  character: "Player 1"
});

login

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

パラメータ

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

例

以下は gtag.js の実装例です。

gtag("event", "login", {
  method: "Google"
});

post_score

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

パラメータ

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

例

以下は gtag.js の実装例です。

gtag("event", "post_score", {
  score: 10000,
  level: 5,
  character: "Player 1"
});

purchase

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

パラメータ

名前	タイプ	必須	値の例	説明
currency	string	○*	USD	イベントに関連付けられた商品アイテムの通貨（3 文字の ISO 4217 形式）。 *value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
value	number	○*	3,003 万台	イベントの金銭的価値。 * value を items 内のすべてのアイテムの (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 の カスタム パラメータ を含めることができます。

例

以下は gtag.js の実装例です。

gtag("event", "purchase", {
    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 つ以上の商品アイテムについてユーザーに払い戻しが行われたことを示します。

注: アナリティクスで払い戻しの指標を商品アイテムごとに確認する場合は、refund イベントに商品アイテムの情報を含めることをおすすめします。

パラメータ

名前	タイプ	必須	値の例	説明
currency	string	○*	USD	イベントに関連付けられた商品アイテムの通貨（3 文字の ISO 4217 形式）。 *value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
transaction_id	string	はい	T_12345	取引を一意に識別する ID。
value	number	○*	3,003 万台	イベントの金銭的価値。 * value を items 内のすべてのアイテムの (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 の カスタム パラメータ を含めることができます。

例

以下は gtag.js の実装例です。

gtag("event", "refund", {
  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 万台	イベントの金銭的価値。 * value を items 内のすべてのアイテムの (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 の カスタム パラメータ を含めることができます。

例

以下は gtag.js の実装例です。

gtag("event", "remove_from_cart", {
  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	検索されたキーワード。

例

以下は gtag.js の実装例です。

gtag("event", "search", {
  search_term: "t-shirts"
});

select_content

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

パラメータ

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

例

以下は gtag.js の実装例です。

gtag("event", "select_content", {
  content_type: "product",
  content_id: "C_12345"
});

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 の カスタム パラメータ を含めることができます。

例

以下は gtag.js の実装例です。

gtag("event", "select_item", {
  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 の カスタム パラメータ を含めることができます。

例

以下は gtag.js の実装例です。

gtag("event", "select_promotion", {
  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",
      creative_name: "summer_banner2",
      creative_slot: "featured_app_1",
      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,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 3
    }
  ],
});

share

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

パラメータ

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

例

以下は gtag.js の実装例です。

gtag("event", "share", {
  method: "Twitter",
  content_type: "image",
  item_id: "C_12345",
});

sign_up

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

パラメータ

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

例

以下は gtag.js の実装例です。

gtag("event", "sign_up", {
  method: "Google"
});

spend_virtual_currency

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

パラメータ

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

例

以下は gtag.js の実装例です。

gtag("event", "spend_virtual_currency", {
  value: 5,
  virtual_currency_name: "Gems",
  item_name: "Starter Boost"
});

tutorial_begin

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

パラメータ

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

例

以下は gtag.js の実装例です。

gtag("event", "tutorial_begin");

tutorial_complete

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

パラメータ

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

例

以下は gtag.js の実装例です。

gtag("event", "tutorial_complete");

unlock_achievement

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

パラメータ

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

例

以下は gtag.js の実装例です。

gtag("event", "unlock_achievement", {
  achievement_id: "A_12345"
});

view_cart

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

パラメータ

名前	タイプ	必須	値の例	説明
currency	string	○*	USD	イベントに関連付けられた商品アイテムの通貨（3 文字の ISO 4217 形式）。 *value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
value	number	○*	3,003 万台	イベントの金銭的価値。 * value を items 内のすべてのアイテムの (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 の カスタム パラメータ を含めることができます。

例

以下は gtag.js の実装例です。

gtag("event", "view_cart", {
  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 万台	イベントの金銭的価値。 * value を items 内のすべてのアイテムの (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 の カスタム パラメータ を含めることができます。

例

以下は gtag.js の実装例です。

gtag("event", "view_item", {
  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 の カスタム パラメータ を含めることができます。

例

以下は gtag.js の実装例です。

gtag("event", "view_item_list", {
  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
    }
  ]
});

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 の カスタム パラメータ を含めることができます。

例

以下は gtag.js の実装例です。

gtag("event", "view_promotion", {
  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",
      creative_name: "summer_banner2",
      creative_slot: "featured_app_1",
      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,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 3
    }
  ]
});