Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Google アナリティクスの推奨イベント

推奨されるイベントは次のとおりです。独自のカスタムイベントを作成して送信することもできます。

カスタムイベント名を作成する際は、次の点に注意してください。

イベントの命名規則に沿って命名します。
予約済みの名前と接頭辞は避けてください。
イベント名やパラメータ名の 40 文字制限など、イベント収集の上限を超えないようにします。

詳しくは、スタートガイドをご覧ください。

Measurement Protocol からアップグレードする場合は、Measurement Protocol からのアップグレードで手順をご確認ください。

すべてのプロパティ向け

`ad_impression`

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

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

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`currency`	`string`	×	USD	イベントに関連付けられた商品アイテムの通貨（3 文字の ISO 4217 形式）。 *`conversion_value` を設定する場合、収益の指標が正確に計算されるように `currency` を指定する必要があります。
`conversion_value`	`number`	いいえ	3.99	広告インプレッションの値。 * 有意義なレポートを作成するには、通常、`conversion_value` を指定する必要があります。 * `conversion_value` を設定する場合は `currency` を指定する必要があります。

パラメータ

名前	タイプ	必須	値の例	説明
`ad_platform`	`string`	いいえ	MoPub	広告プラットフォーム。
`ad_source`	`string`	いいえ	AdColony	広告のソース。
`ad_format`	`string`	いいえ	バナー	広告フォーマット。
`ad_unit_name`	`string`	いいえ	Banner_03	広告ユニット名。

例

次の例は、Data Manager API を使用して ad_impression イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "ad_impression",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 3.99,
      "additionalEventParameters": [
        {
          "parameterName": "ad_platform",
          "value": "MoPub"
        },
        {
          "parameterName": "ad_source",
          "value": "AdColony"
        },
        {
          "parameterName": "ad_format",
          "value": "Banner"
        },
        {
          "parameterName": "ad_unit_name",
          "value": "Banner_03"
        }
      ]
    }
  ]
}

Measurement Protocol

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

`earn_virtual_currency`

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`conversion_value`	`number`	×	5	仮想通貨の価値。

パラメータ

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

例

次の例は、Data Manager API を使用して earn_virtual_currency イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "earn_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

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

`join_group`

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

パラメータ

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

例

次の例は、Data Manager API を使用して join_group イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "join_group",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "group_id",
          "value": "G_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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

`login`

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

パラメータ

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

例

次の例は、Data Manager API を使用して login イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "login",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

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

`screen_view`

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

このイベントは、画面の切り替えが発生したことを示すために使用します。

パラメータ

名前	タイプ	必須	値の例	説明
`screen_class`	`string`	いいえ	MainActivity	スクリーンのクラス。
`screen_name`	`string`	いいえ	About	スクリーンの名前。

例

次の例は、Data Manager API を使用して screen_view イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "screen_view",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "additionalEventParameters": [
        {
          "parameterName": "screen_class",
          "value": "MainActivity"
        },
        {
          "parameterName": "screen_name",
          "value": "About"
        }
      ]
    }
  ]
}

Measurement Protocol

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`

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

パラメータ

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

例

次の例は、Data Manager API を使用して search イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "search",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "t-shirts"
        }
      ]
    }
  ]
}

Measurement Protocol

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	選択されたコンテンツの識別子。値には数字以外の文字を少なくとも 1 つ含める必要があります。

例

次の例は、Data Manager API を使用して select_content イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_content",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "content_type",
          "value": "product"
        },
        {
          "parameterName": "content_id",
          "value": "C_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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

`share`

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`cart_data.items`	`Item[]`	×		イベントの商品アイテム。 `Event` オブジェクトの `cart_data.items` フィールドを設定します。

商品アイテムフィールド

名前	タイプ	必須	値の例	説明
`item_id`	`string`	はい	I_12345	アイテムの一意の識別子。`Item` オブジェクトの `item_id` フィールドを設定します。
`unit_price`	`number`	はい	27.67	このアイテムの単価。税金、送料、イベントスコープ（注文単位）の割引は含みません。アイテムにアイテムスコープの割引がある場合は、割引後の単価を使用します。たとえば、アイテムの単価が 27.67 で、単位割引が 6.66 の場合、`unitPrice` を 21.01 に設定します。
`quantity`	`number`	はい	1	この特定のアイテムについて購入された単位数。

パラメータ

名前	タイプ	必須	値の例	説明
`method`	`string`	×	Twitter	コンテンツを共有する方法。
`content_type`	`string`	×	image	共有コンテンツの種類。

例

次の例は、Data Manager API を使用して share イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "share",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "C_12345",
            "quantity": 1,
            "unitPrice": 27.67
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Twitter"
        },
        {
          "parameterName": "content_type",
          "value": "image"
        }
      ]
    }
  ]
}

Measurement Protocol

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

例

次の例は、Data Manager API を使用して sign_up イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "sign_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

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`

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`conversion_value`	`number`	○	5	仮想通貨の価値。
`cart_data.items`	`Item[]`	いいえ		イベントの商品アイテム。 `Event` オブジェクトの `cart_data.items` フィールドを設定します。

商品アイテムフィールド

名前	タイプ	必須	値の例	説明
`item_id`	`string`	はい	I_12345	アイテムの一意の識別子。`Item` オブジェクトの `item_id` フィールドを設定します。
`unit_price`	`number`	はい	27.67	このアイテムの単価。税金、送料、イベントスコープ（注文単位）の割引は含みません。アイテムにアイテムスコープの割引がある場合は、割引後の単価を使用します。たとえば、アイテムの単価が 27.67 で、単位割引が 6.66 の場合、`unitPrice` を 21.01 に設定します。
`quantity`	`number`	はい	1	この特定のアイテムについて購入された単位数。

商品アイテムパラメータ

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

パラメータ

名前	タイプ	必須	値の例	説明
`virtual_currency_name`	`string`	○	Gems	仮想通貨の名前。

例

次の例は、Data Manager API を使用して spend_virtual_currency イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "spend_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "I_12345",
            "quantity": 1,
            "unitPrice": 27.67,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Starter Boost"
              }
            ]
          }
        ]
      },
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

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

パラメータ

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

例

次の例は、Data Manager API を使用して tutorial_begin イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_begin",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

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

パラメータ

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

例

次の例は、Data Manager API を使用して tutorial_complete イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_complete",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

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

`view_search_results`

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

パラメータ

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

例

次の例は、Data Manager API を使用して view_search_results イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_search_results",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "Clothing"
        }
      ]
    }
  ]
}

Measurement Protocol

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

`campaign_details`

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

例

次の例は、Data Manager API を使用して campaign_details イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "campaign_details",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "campaign_id",
          "value": "google_1234"
        },
        {
          "parameterName": "campaign",
          "value": "Summer_fun"
        },
        {
          "parameterName": "source",
          "value": "google"
        },
        {
          "parameterName": "medium",
          "value": "cpc"
        },
        {
          "parameterName": "term",
          "value": "summer+travel"
        },
        {
          "parameterName": "content",
          "value": "logolink"
        }
      ]
    }
  ]
}

Measurement Protocol

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

オンライン販売

`add_payment_info`

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`currency`	`string`	○*	USD	イベントに関連付けられた商品アイテムの通貨（3 文字の ISO 4217 形式）。 * `view_item` イベントの値の指標が収益に貢献しないようにする * `conversion_value` を設定する場合、収益の指標が正確に計算されるように `currency` を指定する必要があります。
`conversion_value`	`number`	○*	30.03	イベントの金銭的価値。 * `conversion_value` を `items` 内のすべてのアイテムの `(price * quantity)` の合計に設定します。`shipping` または `tax` は含めないでください。 * 有意義なレポートを作成するには、通常、`conversion_value` を指定する必要があります。イベントをキーイベントとして扱う場合は、`conversion_value` を設定することをおすすめします。 * `conversion_value` を設定する場合は `currency` を指定する必要があります。
`cart_data.items`	`Item[]`	はい		イベントの商品アイテム。 `Event` オブジェクトの `cart_data.items` フィールドを設定します。
`cart_data.coupon_codes`	`string[]`	いいえ	SUMMER_FUN	イベントに関連付けられたクーポンコード。 `CartData` オブジェクトの `coupon_codes` フィールドを設定します。 * このリストにはクーポンコードを 1 つだけ指定してください。 * これは商品アイテム単位のクーポンコードとは独立しています。

商品アイテムフィールド

名前	タイプ	必須	値の例	説明
`item_id`	`string`	はい	I_12345	アイテムの一意の識別子。`Item` オブジェクトの `item_id` フィールドを設定します。
`unit_price`	`number`	はい	27.67	このアイテムの単価。税金、送料、イベントスコープ（注文単位）の割引は含みません。アイテムにアイテムスコープの割引がある場合は、割引後の単価を使用します。たとえば、アイテムの単価が 27.67 で、単位割引が 6.66 の場合、`unitPrice` を 21.01 に設定します。
`quantity`	`number`	はい	1	この特定のアイテムについて購入された単位数。

パラメータ

名前	タイプ	必須	値の例	説明
`payment_type`	`string`	いいえ	Credit Card	選択した支払い方法。

例

次の例は、Data Manager API を使用して add_payment_info イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_payment_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "payment_type",
          "value": "Credit Card"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`add_shipping_info`

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`currency`	`string`	○*	USD	イベントに関連付けられた商品アイテムの通貨（3 文字の ISO 4217 形式）。 * `view_item` イベントの値の指標が収益に貢献しないようにする * `conversion_value` を設定する場合、収益の指標が正確に計算されるように `currency` を指定する必要があります。
`conversion_value`	`number`	○*	30.03	イベントの金銭的価値。 * `conversion_value` を `items` 内のすべてのアイテムの `(price * quantity)` の合計に設定します。`shipping` または `tax` は含めないでください。 * 有意義なレポートを作成するには、通常、`conversion_value` を指定する必要があります。イベントをキーイベントとして扱う場合は、`conversion_value` を設定することをおすすめします。 * `conversion_value` を設定する場合は `currency` を指定する必要があります。
`cart_data.items`	`Item[]`	はい		イベントの商品アイテム。 `Event` オブジェクトの `cart_data.items` フィールドを設定します。
`cart_data.coupon_codes`	`string[]`	いいえ	SUMMER_FUN	イベントに関連付けられたクーポンコード。 `CartData` オブジェクトの `coupon_codes` フィールドを設定します。 * このリストにはクーポンコードを 1 つだけ指定してください。 * これは商品アイテム単位のクーポンコードとは独立しています。

商品アイテムフィールド

名前	タイプ	必須	値の例	説明
`item_id`	`string`	はい	I_12345	アイテムの一意の識別子。`Item` オブジェクトの `item_id` フィールドを設定します。
`unit_price`	`number`	はい	27.67	このアイテムの単価。税金、送料、イベントスコープ（注文単位）の割引は含みません。アイテムにアイテムスコープの割引がある場合は、割引後の単価を使用します。たとえば、アイテムの単価が 27.67 で、単位割引が 6.66 の場合、`unitPrice` を 21.01 に設定します。
`quantity`	`number`	はい	1	この特定のアイテムについて購入された単位数。

パラメータ

名前	タイプ	必須	値の例	説明
`shipping_tier`	`string`	×	Ground	購入された商品アイテムの配送方法で選択されている送料区分（`Ground`、`Air`、`Next-day` など）。

例

次の例は、Data Manager API を使用して add_shipping_info イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_shipping_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping_tier",
          "value": "Ground"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`add_to_cart`

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`currency`	`string`	○*	USD	イベントに関連付けられた商品アイテムの通貨（3 文字の ISO 4217 形式）。 * `view_item` イベントの値の指標が収益に貢献しないようにする * `conversion_value` を設定する場合、収益の指標が正確に計算されるように `currency` を指定する必要があります。
`conversion_value`	`number`	○*	30.03	イベントの金銭的価値。 * `conversion_value` を `items` 内のすべてのアイテムの `(price * quantity)` の合計に設定します。`shipping` または `tax` は含めないでください。 * 有意義なレポートを作成するには、通常、`conversion_value` を指定する必要があります。イベントをキーイベントとして扱う場合は、`conversion_value` を設定することをおすすめします。 * `conversion_value` を設定する場合は `currency` を指定する必要があります。
`cart_data.items`	`Item[]`	はい		イベントの商品アイテム。 `Event` オブジェクトの `cart_data.items` フィールドを設定します。

商品アイテムフィールド

名前	タイプ	必須	値の例	説明
`item_id`	`string`	はい	I_12345	アイテムの一意の識別子。`Item` オブジェクトの `item_id` フィールドを設定します。
`unit_price`	`number`	はい	27.67	このアイテムの単価。税金、送料、イベントスコープ（注文単位）の割引は含みません。アイテムにアイテムスコープの割引がある場合は、割引後の単価を使用します。たとえば、アイテムの単価が 27.67 で、単位割引が 6.66 の場合、`unitPrice` を 21.01 に設定します。
`quantity`	`number`	はい	1	この特定のアイテムについて購入された単位数。

商品アイテムパラメータ

名前	タイプ	必須	値の例	説明
`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` はアイテムスコープでのみ使用できます。

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

例

次の例は、Data Manager API を使用して add_to_cart イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`add_to_wishlist`

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`currency`	`string`	○*	USD	イベントに関連付けられた商品アイテムの通貨（3 文字の ISO 4217 形式）。 * `view_item` イベントの値の指標が収益に貢献しないようにする * `conversion_value` を設定する場合、収益の指標が正確に計算されるように `currency` を指定する必要があります。
`conversion_value`	`number`	○*	30.03	イベントの金銭的価値。 * `conversion_value` を `items` 内のすべてのアイテムの `(price * quantity)` の合計に設定します。`shipping` または `tax` は含めないでください。 * 有意義なレポートを作成するには、通常、`conversion_value` を指定する必要があります。イベントをキーイベントとして扱う場合は、`conversion_value` を設定することをおすすめします。 * `conversion_value` を設定する場合は `currency` を指定する必要があります。
`cart_data.items`	`Item[]`	はい		イベントの商品アイテム。 `Event` オブジェクトの `cart_data.items` フィールドを設定します。

商品アイテムフィールド

名前	タイプ	必須	値の例	説明
`item_id`	`string`	はい	I_12345	アイテムの一意の識別子。`Item` オブジェクトの `item_id` フィールドを設定します。
`unit_price`	`number`	はい	27.67	このアイテムの単価。税金、送料、イベントスコープ（注文単位）の割引は含みません。アイテムにアイテムスコープの割引がある場合は、割引後の単価を使用します。たとえば、アイテムの単価が 27.67 で、単位割引が 6.66 の場合、`unitPrice` を 21.01 に設定します。
`quantity`	`number`	はい	1	この特定のアイテムについて購入された単位数。

商品アイテムパラメータ

名前	タイプ	必須	値の例	説明
`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` はアイテムスコープでのみ使用できます。

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

例

次の例は、Data Manager API を使用して add_to_wishlist イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_wishlist",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`begin_checkout`

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`currency`	`string`	○*	USD	イベントに関連付けられた商品アイテムの通貨（3 文字の ISO 4217 形式）。 * `view_item` イベントの値の指標が収益に貢献しないようにする * `conversion_value` を設定する場合、収益の指標が正確に計算されるように `currency` を指定する必要があります。
`conversion_value`	`number`	○*	30.03	イベントの金銭的価値。 * `conversion_value` を `items` 内のすべてのアイテムの `(price * quantity)` の合計に設定します。`shipping` または `tax` は含めないでください。 * 有意義なレポートを作成するには、通常、`conversion_value` を指定する必要があります。イベントをキーイベントとして扱う場合は、`conversion_value` を設定することをおすすめします。 * `conversion_value` を設定する場合は `currency` を指定する必要があります。
`cart_data.items`	`Item[]`	はい		イベントの商品アイテム。 `Event` オブジェクトの `cart_data.items` フィールドを設定します。
`cart_data.coupon_codes`	`string[]`	いいえ	SUMMER_FUN	イベントに関連付けられたクーポンコード。 `CartData` オブジェクトの `coupon_codes` フィールドを設定します。 * このリストにはクーポンコードを 1 つだけ指定してください。 * これは商品アイテム単位のクーポンコードとは独立しています。

商品アイテムフィールド

名前	タイプ	必須	値の例	説明
`item_id`	`string`	はい	I_12345	アイテムの一意の識別子。`Item` オブジェクトの `item_id` フィールドを設定します。
`unit_price`	`number`	はい	27.67	このアイテムの単価。税金、送料、イベントスコープ（注文単位）の割引は含みません。アイテムにアイテムスコープの割引がある場合は、割引後の単価を使用します。たとえば、アイテムの単価が 27.67 で、単位割引が 6.66 の場合、`unitPrice` を 21.01 に設定します。
`quantity`	`number`	はい	1	この特定のアイテムについて購入された単位数。

商品アイテムパラメータ

名前	タイプ	必須	値の例	説明
`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` はアイテムスコープでのみ使用できます。

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

例

次の例は、Data Manager API を使用して begin_checkout イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "begin_checkout",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`in_app_purchase`

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

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`currency`	`string`	○*	USD	イベントの `conversion_value` の通貨（3 文字の ISO 4217 形式）。 * `conversion_value` を設定する場合、収益の指標が正確に計算されるように `currency` を指定する必要があります。
`conversion_value`	`number`	○*	30.03	イベントの金銭的価値。有意義なレポートを作成するには、通常、`conversion_value` を指定する必要があります。イベントをキーイベントとして扱う場合は、`conversion_value` を設定することをおすすめします。 `conversion_value` を設定する場合は `currency` を指定する必要があります。
`cart_data.items`	`Item[]`	いいえ		イベントの商品アイテム。 `Event` オブジェクトの `cart_data.items` フィールドを設定します。

商品アイテムフィールド

名前	タイプ	必須	値の例	説明
`item_id`	`string`	はい	I_12345	アイテムの一意の識別子。`Item` オブジェクトの `item_id` フィールドを設定します。
`unit_price`	`number`	はい	27.67	このアイテムの単価。税金、送料、イベントスコープ（注文単位）の割引は含みません。アイテムにアイテムスコープの割引がある場合は、割引後の単価を使用します。たとえば、アイテムの単価が 27.67 で、単位割引が 6.66 の場合、`unitPrice` を 21.01 に設定します。
`quantity`	`number`	はい	1	この特定のアイテムについて購入された単位数。

パラメータ

名前	タイプ	必須	値の例	説明
`product_id`	`string`	いいえ	ABC123456789	商品の ID。
`subscription`	`boolean`	いいえ	true	購入が定期購入かどうかを示します。設定しない場合、デフォルトで `false` になります。
`free_trial`	`boolean`	いいえ	true	イベントが定期購入の無料トライアル用かどうかを示します。設定しない場合、デフォルトで `false` になります。
`price_is_discounted`	`boolean`	いいえ	false	`price` が割引されているかどうかを示します。設定しない場合、デフォルトで `false` になります。

例

次の例は、Data Manager API を使用して in_app_purchase イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "in_app_purchase",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "cartData": {
        "items": [
          {
            "itemId": "ABC123456789",
            "quantity": 3,
            "unitPrice": 10.01
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "subscription",
          "value": true
        },
        {
          "parameterName": "free_trial",
          "value": false
        },
        {
          "parameterName": "price_is_discounted",
          "value": false
        }
      ]
    }
  ]
}

Measurement Protocol

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

`purchase`

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`currency`	`string`	○*	USD	イベントに関連付けられた商品アイテムの通貨（3 文字の ISO 4217 形式）。 * `view_item` イベントの値の指標が収益に貢献しないようにする * `conversion_value` を設定する場合、収益の指標が正確に計算されるように `currency` を指定する必要があります。
`conversion_value`	`number`	○*	30.03	イベントの金銭的価値。 * `conversion_value` を `items` 内のすべてのアイテムの `(price * quantity)` の合計に設定します。`shipping` または `tax` は含めないでください。 * 有意義なレポートを作成するには、通常、`conversion_value` を指定する必要があります。イベントをキーイベントとして扱う場合は、`conversion_value` を設定することをおすすめします。 * `conversion_value` を設定する場合は `currency` を指定する必要があります。
`transaction_id`	`string`	はい	T_12345	取引を一意に識別する ID。 `transaction_id` パラメータを使用すると、購入イベントの重複を回避できます。`Event` オブジェクトの `transaction_id` フィールドを設定します。
`user_properties.customer_type`	`CustomerType`	いいえ	`NEW`	コンバージョンが `NEW` ユーザーと `RETURNING` ユーザーのどちらによるものか。
`cart_data.items`	`Item[]`	はい		イベントの商品アイテム。 `Event` オブジェクトの `cart_data.items` フィールドを設定します。
`cart_data.coupon_codes`	`string[]`	いいえ	SUMMER_FUN	イベントに関連付けられたクーポンコード。 `CartData` オブジェクトの `coupon_codes` フィールドを設定します。 * このリストにはクーポンコードを 1 つだけ指定してください。 * これは商品アイテム単位のクーポンコードとは独立しています。

商品アイテムフィールド

名前	タイプ	必須	値の例	説明
`item_id`	`string`	はい	I_12345	アイテムの一意の識別子。`Item` オブジェクトの `item_id` フィールドを設定します。
`unit_price`	`number`	はい	27.67	このアイテムの単価。税金、送料、イベントスコープ（注文単位）の割引は含みません。アイテムにアイテムスコープの割引がある場合は、割引後の単価を使用します。たとえば、アイテムの単価が 27.67 で、単位割引が 6.66 の場合、`unitPrice` を 21.01 に設定します。
`quantity`	`number`	はい	1	この特定のアイテムについて購入された単位数。

パラメータ

名前	タイプ	必須	値の例	説明
`shipping`	`number`	×	3.33	取引に関連付けられた送料。
`tax`	`number`	×	1.11	取引に関連付けられた税金。

商品アイテムパラメータ

名前	タイプ	必須	値の例	説明
`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` はアイテムスコープでのみ使用できます。

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

例

次の例は、Data Manager API を使用して purchase イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "purchase",
      "transactionId": "TRANSACTION_ID",
      "conversionValue": 83.99,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "userProperties": {
        "customerType": "RETURNING"
      },
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 3,
            "unitPrice": 10.01,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Stan and Friends Tee"
              },
              {
                "parameterName": "affiliation",
                "value": "Google Merchandise Store"
              },
              {
                "parameterName": "discount",
                "value": "2.22"
              },
              {
                "parameterName": "index",
                "value": "0"
              },
              {
                "parameterName": "item_brand",
                "value": "Google"
              },
              {
                "parameterName": "item_category",
                "value": "Apparel"
              },
              {
                "parameterName": "item_category2",
                "value": "Adult"
              },
              {
                "parameterName": "item_category3",
                "value": "Shirts"
              },
              {
                "parameterName": "item_category4",
                "value": "Crew"
              },
              {
                "parameterName": "item_category5",
                "value": "Short sleeve"
              },
              {
                "parameterName": "item_list_id",
                "value": "related_products"
              },
              {
                "parameterName": "item_list_name",
                "value": "Related Products"
              },
              {
                "parameterName": "item_variant",
                "value": "green"
              },
              {
                "parameterName": "location_id",
                "value": "ChIJIQBpAG2ahYAR_6128GcTUEo"
              },
              {
                "parameterName": "google_business_vertical",
                "value": "retail"
              }
            ]
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": "3.33"
        },
        {
          "parameterName": "tax",
          "value": "1.11"
        }
      ]
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`refund`

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`currency`	`string`	○*	USD	イベントに関連付けられた商品アイテムの通貨（3 文字の ISO 4217 形式）。 * `view_item` イベントの値の指標が収益に貢献しないようにする * `conversion_value` を設定する場合、収益の指標が正確に計算されるように `currency` を指定する必要があります。
`conversion_value`	`number`	○*	30.03	イベントの金銭的価値。 * `conversion_value` を `items` 内のすべてのアイテムの `(price * quantity)` の合計に設定します。`shipping` または `tax` は含めないでください。 * 有意義なレポートを作成するには、通常、`conversion_value` を指定する必要があります。イベントをキーイベントとして扱う場合は、`conversion_value` を設定することをおすすめします。 * `conversion_value` を設定する場合は `currency` を指定する必要があります。
`transaction_id`	`string`	はい	T_12345	取引を一意に識別する ID。
`cart_data.items`	`Item[]`	いいえ		イベントの商品アイテム。 `Event` オブジェクトの `cart_data.items` フィールドを設定します。
`cart_data.coupon_codes`	`string[]`	いいえ	SUMMER_FUN	イベントに関連付けられたクーポンコード。 `CartData` オブジェクトの `coupon_codes` フィールドを設定します。 * このリストにはクーポンコードを 1 つだけ指定してください。 * これは商品アイテム単位のクーポンコードとは独立しています。

商品アイテムフィールド

名前	タイプ	必須	値の例	説明
`item_id`	`string`	はい	I_12345	アイテムの一意の識別子。`Item` オブジェクトの `item_id` フィールドを設定します。
`unit_price`	`number`	はい	27.67	このアイテムの単価。税金、送料、イベントスコープ（注文単位）の割引は含みません。アイテムにアイテムスコープの割引がある場合は、割引後の単価を使用します。たとえば、アイテムの単価が 27.67 で、単位割引が 6.66 の場合、`unitPrice` を 21.01 に設定します。
`quantity`	`number`	はい	1	この特定のアイテムについて購入された単位数。

パラメータ

名前	タイプ	必須	値の例	説明
`shipping`	`number`	×	3.33	取引に関連付けられた送料。
`tax`	`number`	×	1.11	取引に関連付けられた税金。

商品アイテムパラメータ

名前	タイプ	必須	値の例	説明
`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` はアイテムスコープでのみ使用できます。

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

例

次の例は、Data Manager API を使用して refund イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "refund",
      "conversionValue": 30.03,
      "currency": "USD",
      "transactionId": "T_12345",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": 3.33
        },
        {
          "parameterName": "tax",
          "value": 1.11
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`remove_from_cart`

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`currency`	`string`	○*	USD	イベントに関連付けられた商品アイテムの通貨（3 文字の ISO 4217 形式）。 * `view_item` イベントの値の指標が収益に貢献しないようにする * `conversion_value` を設定する場合、収益の指標が正確に計算されるように `currency` を指定する必要があります。
`conversion_value`	`number`	○*	30.03	イベントの金銭的価値。 * `conversion_value` を `items` 内のすべてのアイテムの `(price * quantity)` の合計に設定します。`shipping` または `tax` は含めないでください。 * 有意義なレポートを作成するには、通常、`conversion_value` を指定する必要があります。イベントをキーイベントとして扱う場合は、`conversion_value` を設定することをおすすめします。 * `conversion_value` を設定する場合は `currency` を指定する必要があります。
`cart_data.items`	`Item[]`	はい		イベントの商品アイテム。 `Event` オブジェクトの `cart_data.items` フィールドを設定します。

商品アイテムフィールド

名前	タイプ	必須	値の例	説明
`item_id`	`string`	はい	I_12345	アイテムの一意の識別子。`Item` オブジェクトの `item_id` フィールドを設定します。
`unit_price`	`number`	はい	27.67	このアイテムの単価。税金、送料、イベントスコープ（注文単位）の割引は含みません。アイテムにアイテムスコープの割引がある場合は、割引後の単価を使用します。たとえば、アイテムの単価が 27.67 で、単位割引が 6.66 の場合、`unitPrice` を 21.01 に設定します。
`quantity`	`number`	はい	1	この特定のアイテムについて購入された単位数。

商品アイテムパラメータ

名前	タイプ	必須	値の例	説明
`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` はアイテムスコープでのみ使用できます。

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

例

次の例は、Data Manager API を使用して remove_from_cart イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "remove_from_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`select_item`

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`cart_data.items`	`Item[]`	○*		イベントの商品アイテム。 *`items` 配列では、選択された商品アイテムを表す要素を 1 つだけ含むことが想定されています。複数の要素が指定されている場合、`items` の最初の要素のみが使用されます。 `Event` オブジェクトの `cart_data.items` フィールドを設定します。

パラメータ

名前	タイプ	必須	値の例	説明
`item_list_id`	`string`	×	related_products	ユーザーに商品アイテムが表示されたリストの ID。商品アイテム単位で設定されている場合は無視されます。
`item_list_name`	`string`	×	Related products	ユーザーに商品アイテムが表示されたリストの名前。商品アイテム単位で設定されている場合は無視されます。

商品アイテムパラメータ

名前	タイプ	必須	値の例	説明
`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` はアイテムスコープでのみ使用できます。

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

例

次の例は、Data Manager API を使用して select_item イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_item",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`select_promotion`

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`cart_data.items`	`Item[]`	×		イベントの商品アイテム。 `Event` オブジェクトの `cart_data.items` フィールドを設定します。

商品アイテムフィールド

名前	タイプ	必須	値の例	説明
`item_id`	`string`	はい	I_12345	アイテムの一意の識別子。`Item` オブジェクトの `item_id` フィールドを設定します。
`unit_price`	`number`	はい	27.67	このアイテムの単価。税金、送料、イベントスコープ（注文単位）の割引は含みません。アイテムにアイテムスコープの割引がある場合は、割引後の単価を使用します。たとえば、アイテムの単価が 27.67 で、単位割引が 6.66 の場合、`unitPrice` を 21.01 に設定します。
`quantity`	`number`	はい	1	この特定のアイテムについて購入された単位数。

パラメータ

名前	タイプ	必須	値の例	説明
`creative_name`	`string`	×	summer_banner2	プロモーション用のクリエイティブの名前。
`creative_slot`	`string`	いいえ	featured_app_1	イベントに関連付けられたプロモーション用のクリエイティブスロットの名前。
`promotion_id`	`string`	いいえ	P_12345	イベントに関連付けられたプロモーションの ID。
`promotion_name`	`string`	いいえ	Summer Sale	イベントに関連付けられたプロモーションの名前。

Google アナリティクスのレポートで「アイテムプロモーション ID」や「アイテムプロモーション名」などのアイテムスコープのプロモーションディメンションを入力するために、Google アナリティクスではまず、e コマースイベントの items 配列内の各オブジェクトで対応するプロモーションパラメータ（promotion_id、promotion_name、creative_name、creative_slot）が検索されます。アイテムオブジェクト内にパラメータが見つからない場合、Google アナリティクスは、イベントレベルのパラメータが指定されていれば、その値を使用します。特定のアイテムのアイテムスコープのプロモーションディメンションは、関連するパラメータがアイテムオブジェクトとイベントレベルのパラメータの両方で欠落している場合にのみ、「(not set)」とレポートされます。アイテム単位のパラメータは、常にイベント単位のパラメータよりも優先されます。

商品アイテムパラメータ

名前	タイプ	必須	値の例	説明
`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_slot`	`string`	いいえ	featured_app_1	商品アイテムに関連付けられたプロモーション用のクリエイティブスロットの名前。設定しない場合、デフォルトでイベント単位の `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` はアイテムスコープでのみ使用できます。
`promotion_id`	`string`	いいえ	P_12345	商品アイテムに関連付けられたプロモーションの ID。設定しない場合、デフォルトでイベント単位の `promotion_id` になります。
`promotion_name`	`string`	いいえ	Summer Sale	商品アイテムに関連付けられたプロモーションの名前。設定しない場合、デフォルトでイベント単位の `promotion_name` になります。

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

例

次の例は、Data Manager API を使用して select_promotion イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`view_cart`

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`currency`	`string`	○*	USD	イベントに関連付けられた商品アイテムの通貨（3 文字の ISO 4217 形式）。 * `view_item` イベントの値の指標が収益に貢献しないようにする * `conversion_value` を設定する場合、収益の指標が正確に計算されるように `currency` を指定する必要があります。
`conversion_value`	`number`	○*	30.03	イベントの金銭的価値。 * `conversion_value` を `items` 内のすべてのアイテムの `(price * quantity)` の合計に設定します。`shipping` または `tax` は含めないでください。 * 有意義なレポートを作成するには、通常、`conversion_value` を指定する必要があります。イベントをキーイベントとして扱う場合は、`conversion_value` を設定することをおすすめします。 * `conversion_value` を設定する場合は `currency` を指定する必要があります。
`cart_data.items`	`Item[]`	はい		イベントの商品アイテム。 `Event` オブジェクトの `cart_data.items` フィールドを設定します。

商品アイテムフィールド

名前	タイプ	必須	値の例	説明
`item_id`	`string`	はい	I_12345	アイテムの一意の識別子。`Item` オブジェクトの `item_id` フィールドを設定します。
`unit_price`	`number`	はい	27.67	このアイテムの単価。税金、送料、イベントスコープ（注文単位）の割引は含みません。アイテムにアイテムスコープの割引がある場合は、割引後の単価を使用します。たとえば、アイテムの単価が 27.67 で、単位割引が 6.66 の場合、`unitPrice` を 21.01 に設定します。
`quantity`	`number`	はい	1	この特定のアイテムについて購入された単位数。

商品アイテムパラメータ

名前	タイプ	必須	値の例	説明
`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` はアイテムスコープでのみ使用できます。

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

例

次の例は、Data Manager API を使用して view_cart イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_cart",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`view_item`

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`currency`	`string`	○*	USD	イベントに関連付けられた商品アイテムの通貨（3 文字の ISO 4217 形式）。 * `view_item` イベントの値の指標が収益に貢献しないようにする * `conversion_value` を設定する場合、収益の指標が正確に計算されるように `currency` を指定する必要があります。
`conversion_value`	`number`	○*	30.03	イベントの金銭的価値。 * `conversion_value` を `items` 内のすべてのアイテムの `(price * quantity)` の合計に設定します。`shipping` または `tax` は含めないでください。 * 有意義なレポートを作成するには、通常、`conversion_value` を指定する必要があります。イベントをキーイベントとして扱う場合は、`conversion_value` を設定することをおすすめします。 * `conversion_value` を設定する場合は `currency` を指定する必要があります。
`cart_data.items`	`Item[]`	はい		イベントの商品アイテム。 `Event` オブジェクトの `cart_data.items` フィールドを設定します。

商品アイテムフィールド

名前	タイプ	必須	値の例	説明
`item_id`	`string`	はい	I_12345	アイテムの一意の識別子。`Item` オブジェクトの `item_id` フィールドを設定します。
`unit_price`	`number`	はい	27.67	このアイテムの単価。税金、送料、イベントスコープ（注文単位）の割引は含みません。アイテムにアイテムスコープの割引がある場合は、割引後の単価を使用します。たとえば、アイテムの単価が 27.67 で、単位割引が 6.66 の場合、`unitPrice` を 21.01 に設定します。
`quantity`	`number`	はい	1	この特定のアイテムについて購入された単位数。

商品アイテムパラメータ

名前	タイプ	必須	値の例	説明
`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` はアイテムスコープでのみ使用できます。

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

例

次の例は、Data Manager API を使用して view_item イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ],
      }
    }]
  })
});

`view_item_list`

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`currency`	`string`	○*	USD	イベントに関連付けられた商品アイテムの通貨（3 文字の ISO 4217 形式）。 * `view_item` イベントの値の指標が収益に貢献しないようにする * `conversion_value` を設定する場合、収益の指標が正確に計算されるように `currency` を指定する必要があります。
`cart_data.items`	`Item[]`	はい		イベントの商品アイテム。 `Event` オブジェクトの `cart_data.items` フィールドを設定します。

商品アイテムフィールド

名前	タイプ	必須	値の例	説明
`item_id`	`string`	はい	I_12345	アイテムの一意の識別子。`Item` オブジェクトの `item_id` フィールドを設定します。
`unit_price`	`number`	はい	27.67	このアイテムの単価。税金、送料、イベントスコープ（注文単位）の割引は含みません。アイテムにアイテムスコープの割引がある場合は、割引後の単価を使用します。たとえば、アイテムの単価が 27.67 で、単位割引が 6.66 の場合、`unitPrice` を 21.01 に設定します。
`quantity`	`number`	はい	1	この特定のアイテムについて購入された単位数。

商品アイテムパラメータ

名前	タイプ	必須	値の例	説明
`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` はアイテムスコープでのみ使用できます。

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

例

次の例は、Data Manager API を使用して view_item_list イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item_list",
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

`view_promotion`

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`cart_data.items`	`Item[]`	○*		イベントの商品アイテム。 *`items` 配列では、プロモーションに関連付けられた商品アイテムを表す要素を 1 つだけ含むことが想定されています。複数の要素が指定されている場合、`items` の最初の要素のみが使用されます。 `Event` オブジェクトの `cart_data.items` フィールドを設定します。

商品アイテムフィールド

名前	タイプ	必須	値の例	説明
`item_id`	`string`	はい	I_12345	アイテムの一意の識別子。`Item` オブジェクトの `item_id` フィールドを設定します。
`unit_price`	`number`	はい	27.67	このアイテムの単価。税金、送料、イベントスコープ（注文単位）の割引は含みません。アイテムにアイテムスコープの割引がある場合は、割引後の単価を使用します。たとえば、アイテムの単価が 27.67 で、単位割引が 6.66 の場合、`unitPrice` を 21.01 に設定します。
`quantity`	`number`	はい	1	この特定のアイテムについて購入された単位数。

パラメータ

名前	タイプ	必須	値の例	説明
`creative_name`	`string`	×	summer_banner2	プロモーション用のクリエイティブの名前。
`creative_slot`	`string`	いいえ	featured_app_1	イベントに関連付けられたプロモーション用のクリエイティブスロットの名前。
`promotion_id`	`string`	いいえ	P_12345	イベントに関連付けられたプロモーションの ID。
`promotion_name`	`string`	いいえ	Summer Sale	イベントに関連付けられたプロモーションの名前。

Google アナリティクスのレポートで「アイテムプロモーション ID」や「アイテムプロモーション名」などのアイテムスコープのプロモーションディメンションを入力するために、Google アナリティクスではまず、e コマースイベントの items 配列内の各オブジェクトで対応するプロモーションパラメータ（promotion_id、promotion_name、creative_name、creative_slot）が検索されます。アイテムオブジェクト内にパラメータが見つからない場合、Google アナリティクスは、イベントレベルのパラメータが指定されていれば、その値を使用します。特定のアイテムのアイテムスコープのプロモーションディメンションは、アイテムオブジェクトとイベントレベルのパラメータの両方に関連するパラメータがない場合にのみ、「(not set)」とレポートされます。アイテム単位のパラメータは、常にイベント単位のパラメータよりも優先されます。

商品アイテムパラメータ

名前	タイプ	必須	値の例	説明
`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_slot`	`string`	いいえ	featured_app_1	商品アイテムに関連付けられたプロモーション用のクリエイティブスロットの名前。設定しない場合、デフォルトでイベント単位の `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` はアイテムスコープでのみ使用できます。
`promotion_id`	`string`	いいえ	P_12345	商品アイテムに関連付けられたプロモーションの ID。設定しない場合、デフォルトでイベント単位の `promotion_id` になります。
`promotion_name`	`string`	いいえ	Summer Sale	商品アイテムに関連付けられたプロモーションの名前。設定しない場合、デフォルトでイベント単位の `promotion_name` になります。

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

例

次の例は、Data Manager API を使用して view_promotion イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

ゲーム

`level_up`

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

パラメータ

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

例

次の例は、Data Manager API を使用して level_up イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "level_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

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

`post_score`

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

パラメータ

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

例

次の例は、Data Manager API を使用して post_score イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "post_score",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "score",
          "value": 10000
        },
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

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

`unlock_achievement`

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

パラメータ

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

例

次の例は、Data Manager API を使用して unlock_achievement イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "unlock_achievement",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "achievement_id",
          "value": "A_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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

リード獲得

`close_convert_lead`

有望な見込み顧客が顧客に転換されたときに、このイベントをログに記録します。通常、これは契約の締結、有料サブスクリプションの開始、最終販売の完了など、リード育成プロセスの終了を意味します。

注: フォームの送信、ニュースレターの登録、デモのリクエストなど、最初の見込み顧客の獲得をトラッキングするには、generate_lead イベントを使用します。

イベントフィールド

名前	タイプ	必須	値の例	説明
`currency`	`string`	○*	USD	イベントの `conversion_value` の通貨（3 文字の ISO 4217 形式）。 * `conversion_value` を設定する場合、収益の指標が正確に計算されるように `currency` を指定する必要があります。
`conversion_value`	`number`	○*	30.03	イベントの金銭的価値。有意義なレポートを作成するには、通常、`conversion_value` を指定する必要があります。イベントをキーイベントとして扱う場合は、`conversion_value` を設定することをおすすめします。 `conversion_value` を設定する場合は `currency` を指定する必要があります。

例

次の例は、Data Manager API を使用して close_convert_lead イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_convert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

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	イベントの `conversion_value` の通貨（3 文字の ISO 4217 形式）。 * `conversion_value` を設定する場合、収益の指標が正確に計算されるように `currency` を指定する必要があります。
`conversion_value`	`number`	○*	30.03	イベントの金銭的価値。有意義なレポートを作成するには、通常、`conversion_value` を指定する必要があります。イベントをキーイベントとして扱う場合は、`conversion_value` を設定することをおすすめします。 `conversion_value` を設定する場合は `currency` を指定する必要があります。

パラメータ

名前	タイプ	必須	値の例	説明
`unconvert_lead_reason`	`string`	いいえ	返信なし	見込み顧客がコンバージョンに至らなかった理由。

例

次の例は、Data Manager API を使用して close_unconvert_lead イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_unconvert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "unconvert_lead_reason",
          "value": "Never responded"
        }
      ]
    }
  ]
}

Measurement Protocol

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	イベントの `conversion_value` の通貨（3 文字の ISO 4217 形式）。 * `conversion_value` を設定する場合、収益の指標が正確に計算されるように `currency` を指定する必要があります。
`conversion_value`	`number`	○*	30.03	イベントの金銭的価値。有意義なレポートを作成するには、通常、`conversion_value` を指定する必要があります。イベントをキーイベントとして扱う場合は、`conversion_value` を設定することをおすすめします。 `conversion_value` を設定する場合は `currency` を指定する必要があります。

パラメータ

名前	タイプ	必須	値の例	説明
`disqualified_lead_reason`	`string`	いいえ	購入する予定はない	見込み顧客が不適格とマークが付けられた理由。

例

次の例は、Data Manager API を使用して disqualify_lead イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "disqualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "disqualified_lead_reason",
          "value": "Not looking to buy"
        }
      ]
    }
  ]
}

Measurement Protocol

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

`generate_lead`

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`currency`	`string`	○*	USD	イベントの `conversion_value` の通貨（3 文字の ISO 4217 形式）。 * `conversion_value` を設定する場合、収益の指標が正確に計算されるように `currency` を指定する必要があります。
`conversion_value`	`number`	○*	30.03	イベントの金銭的価値。有意義なレポートを作成するには、通常、`conversion_value` を指定する必要があります。イベントをキーイベントとして扱う場合は、`conversion_value` を設定することをおすすめします。 `conversion_value` を設定する場合は `currency` を指定する必要があります。

パラメータ

名前	タイプ	必須	値の例	説明
`lead_source`	`string`	いいえ	展示会	見込み顧客のソース。

例

次の例は、Data Manager API を使用して generate_lead イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "generate_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_source",
          "value": "Trade show"
        }
      ]
    }
  ]
}

Measurement Protocol

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

`qualify_lead`

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`currency`	`string`	○*	USD	イベントの `conversion_value` の通貨（3 文字の ISO 4217 形式）。 * `conversion_value` を設定する場合、収益の指標が正確に計算されるように `currency` を指定する必要があります。
`conversion_value`	`number`	○*	30.03	イベントの金銭的価値。有意義なレポートを作成するには、通常、`conversion_value` を指定する必要があります。イベントをキーイベントとして扱う場合は、`conversion_value` を設定することをおすすめします。 `conversion_value` を設定する場合は `currency` を指定する必要があります。

例

次の例は、Data Manager API を使用して qualify_lead イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "qualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

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

`working_lead`

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

イベントフィールド

名前	タイプ	必須	値の例	説明
`currency`	`string`	○*	USD	イベントの `conversion_value` の通貨（3 文字の ISO 4217 形式）。 * `conversion_value` を設定する場合、収益の指標が正確に計算されるように `currency` を指定する必要があります。
`conversion_value`	`number`	○*	30.03	イベントの金銭的価値。有意義なレポートを作成するには、通常、`conversion_value` を指定する必要があります。イベントをキーイベントとして扱う場合は、`conversion_value` を設定することをおすすめします。 `conversion_value` を設定する場合は `currency` を指定する必要があります。

パラメータ

名前	タイプ	必須	値の例	説明
`lead_status`	`string`	いいえ	会話を開始しました	見込み顧客のステータス。

例

次の例は、Data Manager API を使用して working_lead イベントを送信する方法を示しています。Measurement Protocol からアップグレードする場合は、タブを使用してリクエストを Data Manager API に移行します。

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "working_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_status",
          "value": "Started conversations"
        }
      ]
    }
  ]
}

Measurement Protocol

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

Google アナリティクスの推奨イベント コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

すべてのプロパティ向け

ad_impression

イベント フィールド

パラメータ

例

Data Manager API

Measurement Protocol

earn_virtual_currency

イベント フィールド

パラメータ

例

Data Manager API

Measurement Protocol

join_group

パラメータ

例

Data Manager API

Measurement Protocol

login

パラメータ

例

Data Manager API

Measurement Protocol

screen_view

パラメータ

例

Data Manager API

Measurement Protocol

search

パラメータ

例

Data Manager API

Measurement Protocol

select_content

パラメータ

例

Data Manager API

Measurement Protocol

share

イベント フィールド

商品アイテム フィールド

パラメータ

例

Data Manager API

Measurement Protocol

sign_up

パラメータ

例

Data Manager API

Measurement Protocol

spend_virtual_currency

イベント フィールド

商品アイテム フィールド

商品アイテム パラメータ

パラメータ

例

Data Manager API

Measurement Protocol

tutorial_begin

パラメータ

例

Data Manager API

Measurement Protocol

tutorial_complete

パラメータ

例

Data Manager API

Measurement Protocol

view_search_results

パラメータ

例

Data Manager API

Measurement Protocol

campaign_details

パラメータ

例

Data Manager API

Measurement Protocol

オンライン販売

Google アナリティクスの推奨イベント

`ad_impression`

イベントフィールド

`earn_virtual_currency`

イベントフィールド

`join_group`

`login`

`screen_view`

`search`

`select_content`

`share`

イベントフィールド

商品アイテムフィールド

`sign_up`

`spend_virtual_currency`

イベントフィールド

商品アイテムフィールド

商品アイテムパラメータ

`tutorial_begin`

`tutorial_complete`

`view_search_results`

`campaign_details`

`add_payment_info`

イベントフィールド

商品アイテムフィールド

`add_shipping_info`

イベントフィールド

商品アイテムフィールド

`add_to_cart`

イベントフィールド

商品アイテムフィールド

商品アイテムパラメータ

`add_to_wishlist`

イベントフィールド

商品アイテムフィールド

商品アイテムパラメータ

`begin_checkout`

イベントフィールド

商品アイテムフィールド

商品アイテムパラメータ

`in_app_purchase`

イベントフィールド

商品アイテムフィールド

`purchase`

イベントフィールド

商品アイテムフィールド

商品アイテムパラメータ

`refund`

イベントフィールド

商品アイテムフィールド

商品アイテムパラメータ

`remove_from_cart`

イベントフィールド

商品アイテムフィールド

商品アイテムパラメータ

`select_item`

イベントフィールド

商品アイテムパラメータ