イベント

ad_impression

このイベントは、ユーザーに広告のインプレッションが表示されたときに使用します。

パラメータ

名前	タイプ	必須	値の例	説明
ad_platform	string	×	MoPub	広告プラットフォーム。
ad_source	string	×	AdColony	広告ソース。
ad_format	string	×	バナー	広告フォーマット。
ad_unit_name	string	×	Banner_03	広告ユニット名。
currency	string	×	USD	イベントに関連付けられた商品アイテムの通貨（3 文字の ISO 4217 形式）。 *value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
value	number	×	3.99	広告インプレッションの価値。 * 有意義なレポートを作成するには、通常 value が必要です。 * value を設定する場合は currency が必要です。

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events":[{
      "name":"ad_impression",
      "params":{
        "ad_platform": "MoPub",
        "ad_source": "AdColony",
        "ad_format": "Banner",
        "ad_unit_name": "Banner_03",
        "currency": "USD",
        "value": 3.99
      }
    }]
  })
});

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

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_payment_info",
      "params": {
        "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",
            "currency": "USD",
            "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 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_shipping_info",
      "params": {
        "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",
            "currency": "USD",
            "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 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_wishlist",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;


fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "begin_checkout",
      "params": {
        "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",
            "currency": "USD",
            "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
          }
        ]
      }
    }]
  })
});

campaign_details

このイベントを使って、今後のイベントに適用されるキャンペーンの詳細情報を送信します。

パラメータ

名前	タイプ	必須	値の例	説明
campaign_id	string	×	google_1234	キャンペーン ID。
campaign	string	×	Summer_fun	特定のプロモーションまたは戦略的キャンペーンを識別するために使用する名前。
source	string	×	google	キャンペーンのトラフィック ソース（google、email など）。
medium	string	×	cpc	キャンペーン メディア（メール、クリック単価など）。
term	string	×	summer+travel	広告にキーワードを設定している有料検索で使用するキャンペーンのキーワード。
content	string	×	logolink	A/B テストやコンテンツ ターゲット広告で、同じ URL を参照する広告やリンクを区別するために使用するキャンペーンのコンテンツ。

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "campaign_details",
      "params": {
        "campaign_id": "google_1234",
        "campaign": "Summer_fun",
        "source": "google",
        "medium": "cpc",
        "term": "summer+travel",
        "content": "logolink"
      }
    }]
  })
});

earn_virtual_currency

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

パラメータ

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

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "earn_virtual_currency",
      "params": {
        "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 が必要です。

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "generate_lead",
      "params": {
        "currency": "USD",
        "value": 99.99
      }
    }]
  })
});

join_group

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

パラメータ

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

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events":[{
      "name":"join_group",
      "params":{
        "group_id":"G_12345"
      }
    }]
  })
});

level_up

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

パラメータ

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

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "level_up",
      "params": {
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

login

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

パラメータ

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

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "login",
      "params": {
        "method": "Google"
      }
    }]
  })
});

post_score

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

パラメータ

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

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "post_score",
      "params": {
        "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 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "purchase",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "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",
            "currency": "USD",
            "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
          }
        ]
      }
    }]
  })
});

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

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "refund",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "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",
            "currency": "USD",
            "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 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "remove_from_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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
          }
        ]
      }
    }]
  })
});

screen_view

このイベントは、画面の遷移が発生したことを示します。

パラメータ

名前	タイプ	必須	値の例	説明
screen_class	string	×	MainActivity	画面のクラス。
screen_name	string	×	基本情報	スクリーンの名前。

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "screen_view",
      "params": {
        "screen_class": "MainActivity",
        "screen_name": "About"
      }
    }]
  })
});

検索

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

パラメータ

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

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "search",
      "params": {
        "search_term": "t-shirts"
      }
    }]
  })
});

select_content

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

パラメータ

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

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_content",
      "params": {
        "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 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_item",
      "params": {
        "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",
            "currency": "USD",
            "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 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_promotion",
      "params": {
        "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",
            "currency": "USD",
            "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。

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "share",
      "params": {
        "method": "Twitter",
        "content_type": "image",
        "item_id": "C_12345"
      }
    }]
  })
});

sign_up

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

パラメータ

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

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "sign_up",
      "params": {
        "method": "Google"
      }
    }]
  })
});

spend_virtual_currency

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

パラメータ

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

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "spend_virtual_currency",
      "params": {
        "value": 5,
        "virtual_currency_name": "Gems",
        "item_name": "Starter Boost"
      }
    }]
  })
});

tutorial_begin

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

パラメータ

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

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

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "tutorial_begin"
    }]
  })
});

tutorial_complete

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

パラメータ

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

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "tutorial_complete"
    }]
  })
});

unlock_achievement

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

パラメータ

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

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "unlock_achievement",
      "params": {
        "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 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_cart",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item_list",
      "params": {
        "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",
            "currency": "USD",
            "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 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_promotion",
      "params": {
        "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",
            "currency": "USD",
            "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
          }
        ]
      }
    }]
  })
});

view_search_results

ユーザーに検索結果が表示されたときに、このイベントをログに記録します。なお、Google アナリティクスの拡張イベント計測機能を使って、view_search_results イベントの自動収集を有効にできます。

パラメータ

名前	タイプ	必須	値の例	説明
search_term	string	×	Clothing	検索に使用されたキーワード。

注: 検索語句が現在のセッションで初めて入力されたものである場合、値が 1 の unique_search_term パラメータが view_search_results イベントで送信されます。現在のセッションですでに送信されている検索語句の場合、パラメータの値は 0 になります。

イベント送信

このイベントを GA4 イベント ビルダーで試す

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_search_results",
      "params": {
        "search_term": "Clothing"
      }
    }]
  })
});