イベント

ad_impression

このイベントは、アプリ ストリームでのみ使用できます。

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

  • Measurement Protocol を使用して送信された ad_impression は、Google 広告などの他の広告プラットフォームへのエクスポートには含まれません。
  • Measurement Protocol を使用して ad_impression イベントを送信すると、リンクされた Google 広告サービスのタグ設定または SDK を構成している場合、インプレッションが重複する可能性があります。Measurement Protocol を使用して ad_impression イベントを送信するのは、タグ付けまたは SDK でイベントがキャプチャされなかった場合のみです。

パラメータ

名前 タイプ 必須 値の例 説明
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 を指定する必要があります。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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({
    "app_instance_id": "app_instance_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 形式）。

収益に貢献しない view_item イベントの値の指標

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

* 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 パラメータは独立しています。
discount number × 2.22 商品アイテムに関連付けられた単位割引額。
index number いいえ 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × Apparel 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
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 × Related products ユーザーに商品アイテムが表示されたリストの名前。

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

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。
items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 形式）。

収益に貢献しない view_item イベントの値の指標

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

* 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 パラメータは独立しています。
discount number × 2.22 商品アイテムに関連付けられた単位割引額。
index number いいえ 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × Apparel 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
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 × Related products ユーザーに商品アイテムが表示されたリストの名前。

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

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。
items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 形式）。

収益に貢献しない view_item イベントの値の指標

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

* 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 パラメータは独立しています。
discount number × 2.22 商品アイテムに関連付けられた単位割引額。
index number いいえ 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × Apparel 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
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 × Related products ユーザーに商品アイテムが表示されたリストの名前。

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

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。
items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 形式）。

収益に貢献しない view_item イベントの値の指標

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

* 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 パラメータは独立しています。
discount number × 2.22 商品アイテムに関連付けられた単位割引額。
index number いいえ 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × Apparel 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
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 × Related products ユーザーに商品アイテムが表示されたリストの名前。

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

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。
items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 形式）。

収益に貢献しない view_item イベントの値の指標

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

* 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 パラメータは独立しています。
discount number × 2.22 商品アイテムに関連付けられた単位割引額。
index number いいえ 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × Apparel 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
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 × Related products ユーザーに商品アイテムが表示されたリストの名前。

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

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。
items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 を参照する広告やリンクを区別するために使用するキャンペーンのコンテンツ。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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

close_convert_lead

このイベントは、見込み顧客がコンバージョンしてクローズされたタイミングを測定します（購入など）。

パラメータ

名前 タイプ 必須 値の例 説明
currency string ○* USD イベントの value の通貨（3 文字の ISO 4217 形式）。

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

*有意義なレポートを作成するには、通常、value を指定する必要があります。 イベントをキーイベントとして扱う場合は、value を設定することをおすすめします。
*value を設定する場合は currency を指定する必要があります。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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": "close_convert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

close_unconvert_lead

このイベントは、ユーザーがコンバージョンに至らなかった見込み顧客としてマークされたタイミングと、その理由を測定します。

パラメータ

名前 タイプ 必須 値の例 説明
currency string ○* USD イベントの value の通貨（3 文字の ISO 4217 形式）。

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

*有意義なレポートを作成するには、通常、value を指定する必要があります。 イベントをキーイベントとして扱う場合は、value を設定することをおすすめします。
*value を設定する場合は currency を指定する必要があります。
unconvert_lead_reason string いいえ 返信なし 見込み顧客がコンバージョンに至らなかった理由。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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": "close_unconvert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "unconvert_lead_reason": "Never responded"
      }
    }]
  })
});

disqualify_lead

このイベントは、ユーザーが見込み顧客として不適格と判断されたタイミングと、その理由を測定します。

パラメータ

名前 タイプ 必須 値の例 説明
currency string ○* USD イベントの value の通貨（3 文字の ISO 4217 形式）。

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

*有意義なレポートを作成するには、通常、value を指定する必要があります。 イベントをキーイベントとして扱う場合は、value を設定することをおすすめします。
*value を設定する場合は currency を指定する必要があります。
disqualified_lead_reason string いいえ 購入する予定はない 見込み顧客が不適格とマークが付けられた理由。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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": "disqualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "disqualified_lead_reason": "Not looking to buy"
      }
    }]
  })
});

earn_virtual_currency

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

パラメータ

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

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 イベントの value の通貨（3 文字の ISO 4217 形式）。

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

*有意義なレポートを作成するには、通常、value を指定する必要があります。 イベントをキーイベントとして扱う場合は、value を設定することをおすすめします。
*value を設定する場合は currency を指定する必要があります。
lead_source string いいえ 展示会 見込み顧客のソース。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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": 30.03,
        "lead_source": "Trade show"
      }
    }]
  })
});

in_app_purchase

このイベントは、アプリ ストリームでのみ使用できます。

このイベントは、ユーザーがアプリ内購入を行ったときに使用します。

パラメータ

名前 タイプ 必須 値の例 説明
currency string ○* USD イベントの value の通貨（3 文字の ISO 4217 形式）。

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

*有意義なレポートを作成するには、通常、value を指定する必要があります。 イベントをキーイベントとして扱う場合は、value を設定することをおすすめします。
*value を設定する場合は currency を指定する必要があります。
quantity number いいえ 3

アイテムの数量。
設定しない場合、quantity は 1 に設定されます。
product_id string いいえ ABC123456789 商品の ID。
subscription boolean いいえ true

購入が定期購入かどうかを示します。
設定しない場合、デフォルトで false になります。
free_trial boolean いいえ true

イベントが定期購入の無料トライアル用かどうかを示します。
設定しない場合、デフォルトで false になります。
price_is_discounted boolean いいえ false

price が割引されているかどうかを示します。
設定しない場合、デフォルトで false になります。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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({
    "app_instance_id": "app_instance_id",
    "events":[{
      "name":"in_app_purchase",
      "params":{
        "currency": "USD",
        "value": 30.03,
        "quantity": 3,
        "product_id": "ABC123456789",
        "subscription": true,
        "free_trial": false,
        "price_is_discounted": false
      }
    }]
  })
});

join_group

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

パラメータ

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

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 レベルアップしたキャラクター。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 ログインに使用するメソッド。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 スコアを達成したキャラクター。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 形式）。

収益に貢献しない view_item イベントの値の指標

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

* value を items 内のすべてのアイテムの (price * quantity) の合計に設定します。shipping または tax は含めないでください。
* 有意義なレポートを作成するには、通常、value を指定する必要があります。 イベントをキーイベントとして扱う場合は、value を設定することをおすすめします。
* value を設定する場合は currency を指定する必要があります。
customer_type string（new / returning） いいえ 新規 コンバージョンは `new` 顧客と `returning` 顧客のどちらによるものか。
  • new: 設定した期間（540 日間のウィンドウが推奨されておりデフォルトで設定されていますが、必須ではありません）内に購入を行っていない新規顧客。
  • returning: 設定した期間内に購入を行っているリピーター。

判断できない場合は値を指定しないでください（ユーザーがゲストとして購入した場合など）。
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 パラメータは独立しています。
discount number × 2.22 商品アイテムに関連付けられた単位割引額。
index number いいえ 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × Apparel 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
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 × Related products ユーザーに商品アイテムが表示されたリストの名前。

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

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。
items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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

qualify_lead

このイベントは、ユーザーが認定見込み顧客になるための条件を満たしたとマークされたタイミングを測定します。

パラメータ

名前 タイプ 必須 値の例 説明
currency string ○* USD イベントの value の通貨（3 文字の ISO 4217 形式）。

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

*有意義なレポートを作成するには、通常、value を指定する必要があります。 イベントをキーイベントとして扱う場合は、value を設定することをおすすめします。
*value を設定する場合は currency を指定する必要があります。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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": "qualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

refund

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

パラメータ

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

収益に貢献しない view_item イベントの値の指標

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

* 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 パラメータは独立しています。
discount number × 2.22 商品アイテムに関連付けられた単位割引額。
index number いいえ 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × Apparel 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
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 × Related products ユーザーに商品アイテムが表示されたリストの名前。

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

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。
items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 形式）。

収益に貢献しない view_item イベントの値の指標

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

* 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 パラメータは独立しています。
discount number × 2.22 商品アイテムに関連付けられた単位割引額。
index number いいえ 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × Apparel 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
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 × Related products ユーザーに商品アイテムが表示されたリストの名前。

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

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。
items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 いいえ About スクリーンの名前。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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({
    "app_instance_id": "app_instance_id",
    "events": [{
      "name": "screen_view",
      "params": {
        "screen_class": "MainActivity",
        "screen_name": "About"
      }
    }]
  })
});

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

パラメータ

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

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 選択されたコンテンツの識別子。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 × Related products ユーザーに商品アイテムが表示されたリストの名前。

商品アイテム単位で設定されている場合は無視されます。
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 パラメータは独立しています。
discount number × 2.22 商品アイテムに関連付けられた単位割引額。
index number いいえ 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × Apparel 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
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 × Related products ユーザーに商品アイテムが表示されたリストの名前。

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

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。
items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 × Apparel 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
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 × Related products ユーザーに商品アイテムが表示されたリストの名前。

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

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 × image 共有コンテンツの種類。
item_id string × C_12345 共有コンテンツの ID。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 登録に使用された方法。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 仮想通貨が使用されている商品アイテムの名前。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 とともに使用します。

パラメータ

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

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

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 とともに使用します。

パラメータ

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

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 形式）。

収益に貢献しない view_item イベントの値の指標

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

* 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 パラメータは独立しています。
discount number × 2.22 商品アイテムに関連付けられた単位割引額。
index number いいえ 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × Apparel 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
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 × Related products ユーザーに商品アイテムが表示されたリストの名前。

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

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。
items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 形式）。

収益に貢献しない view_item イベントの値の指標

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

* 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 パラメータは独立しています。
discount number × 2.22 商品アイテムに関連付けられた単位割引額。
index number いいえ 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × Apparel 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
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 × Related products ユーザーに商品アイテムが表示されたリストの名前。

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

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。
items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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

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

パラメータ

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

収益に貢献しない view_item イベントの値の指標

* value を設定する場合、収益の指標が正確に計算されるように currency を指定する必要があります。
item_list_id string いいえ related_products ユーザーに商品アイテムが表示されたリストの ID。

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

商品アイテム単位で設定されている場合は無視されます。
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 パラメータは独立しています。
discount number × 2.22 商品アイテムに関連付けられた単位割引額。
index number いいえ 5 リスト内の商品アイテムのインデックスまたは位置。
item_brand string × Google 商品アイテムのブランド。
item_category string × Apparel 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
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 × Related products ユーザーに商品アイテムが表示されたリストの名前。

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

商品アイテムの数量。

設定しない場合、quantity は 1 に設定されます。
items 配列には既定のパラメータとは別に、27 の カスタム パラメータ を含めることができます。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 × Apparel 商品アイテムのカテゴリ。カテゴリの階層または分類の一部として使用されている場合は、これが最初のカテゴリになります。
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 × Related products ユーザーに商品アイテムが表示されたリストの名前。

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

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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 検索に使用されたキーワード。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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

working_lead

ユーザーが担当者に連絡したとき、または担当者から連絡を受けたときを測定します。

パラメータ

名前 タイプ 必須 値の例 説明
currency string ○* USD イベントの value の通貨（3 文字の ISO 4217 形式）。

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

*有意義なレポートを作成するには、通常、value を指定する必要があります。 イベントをキーイベントとして扱う場合は、value を設定することをおすすめします。
*value を設定する場合は currency を指定する必要があります。
lead_status string いいえ 開始した会話 見込み顧客のステータス。

イベント送信

このイベントを Google アナリティクス イベント ビルダーで試す

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": "working_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_status": "Started conversations"
      }
    }]
  })
});