事件

add_payment_info

此事件表示用户在电子商务结账流程中提交了自己的付款信息。

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 *如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`value`	`number`	是*	7.77	与事件相关的货币价值。为了生成有意义的报告，通常必须提供 `value`。如果您将事件标记为转化，则建议您设置 `value`。如果设置 `value`，则必须提供 `currency`。
`coupon`	`string`	否	SUMMER_FUN	与事件相关的优惠券名称/代码。事件级和商品级 `coupon` 参数彼此独立。
`payment_type`	`string`	否	信用卡	选定的付款方式。
`items`	`Array<Item>`	是		与事件相关的商品。

Item 参数

名称	类型	是否必须提供	示例值	说明
`item_id`	`string`	是*	SKU_12345	商品的 ID。 *必须提供 `item_id` 或 `item_name` 中的一个。
`item_name`	`string`	是*	Stan 和 Friends Tee	商品的名称。 *必须提供 `item_id` 或 `item_name` 中的一个。
`affiliation`	`string`	否	Google 商店	用于指定供应公司或实体店面的商品关联商户。注意：`affiliation` 仅适用于商品级范围。
`coupon`	`string`	否	SUMMER_FUN	与商品相关的优惠券名称/代码。事件级和商品级 `coupon` 参数彼此独立。
`creative_name`	`string`	否	summer_banner2	促销广告素材的名称。如果设置此参数，系统会忽略事件级 `creative_name`。如果未设置此参数，系统会使用事件级 `creative_name`（如果存在）。
`creative_slot`	`string`	否	featured_app_1	与商品相关的促销广告素材投放到的广告位的名称。如果设置此参数，系统会忽略事件级 `creative_slot`。如果未设置此参数，系统会使用事件级 `creative_slot`（如果存在）。
`discount`	`number`	否	2.22	与商品相关的折扣货币价值。
`index`	`number`	否	5	列表中商品的索引/商品在列表中的位置。
`item_brand`	`string`	否	Google	商品所属品牌。
`item_category`	`string`	否	服饰	商品所属类别。如果将其用作类别层级或类目的一部分，则为第一个类别。
`item_category2`	`string`	否	成人	商品的第二个类别层级或其他类目。
`item_category3`	`string`	否	衬衫	商品的第三个类别层级或其他类目。
`item_category4`	`string`	否	圆领	商品的第四个类别层级或其他类目。
`item_category5`	`string`	否	短袖	商品的第五个类别层级或其他类目。
`item_list_id`	`string`	否	related_products	商品向用户展示时所在列表的 ID。如果设置此参数，系统会忽略事件级 `item_list_id`。如果未设置此参数，系统会使用事件级 `item_list_id`（如果存在）。
`item_list_name`	`string`	否	相关商品	商品向用户展示时所在列表的名称。如果设置此参数，系统会忽略事件级 `item_list_name`。如果未设置此参数，系统会使用事件级 `item_list_name`（如果存在）。
`item_variant`	`string`	否	绿色	用于提供其他商品详情/选项的商品款式/规格、唯一代码或说明。
`location_id`	`string`	否	ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID）	与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。注意：`location id` 仅适用于商品级范围。
`price`	`number`	否	9.99	商品的货币价格（以指定的 currency 参数为单位）。
`promotion_id`	`string`	否	P_12345	与商品相关的促销活动的 ID。如果设置此参数，系统会忽略事件级 `promotion_id`。如果未设置此参数，系统会使用事件级 `promotion_id`（如果存在）。
`promotion_name`	`string`	否	夏季促销	与商品相关的促销活动的名称。如果设置此参数，系统会忽略事件级 `promotion_name`。如果未设置此参数，系统会使用事件级 `promotion_name`（如果存在）。
`quantity`	`number`	否	1	商品数量。如果未设置，`quantity` 将设置为 1。

除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

发送事件

在 GA4 Event Builder 中试用此事件

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": 7.77,
        "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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

add_shipping_info

此事件表示用户在电子商务结账流程中提交了自己的配送信息。

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 *如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`value`	`number`	是*	7.77	与事件相关的货币价值。为了生成有意义的报告，通常必须提供 `value`。如果您将事件标记为转化，则建议您设置 `value`。如果设置 `value`，则必须提供 `currency`。
`coupon`	`string`	否	SUMMER_FUN	与事件相关的优惠券名称/代码。事件级和商品级 `coupon` 参数彼此独立。
`shipping_tier`	`string`	否	Ground	用户为所购商品选择的配送级别（例如 `Ground`、`Air` 和 `Next-day`）。
`items`	`Array<Item>`	是		与事件相关的商品。

Item 参数

名称	类型	是否必须提供	示例值	说明
`item_id`	`string`	是*	SKU_12345	商品的 ID。 *必须提供 `item_id` 或 `item_name` 中的一个。
`item_name`	`string`	是*	Stan 和 Friends Tee	商品的名称。 *必须提供 `item_id` 或 `item_name` 中的一个。
`affiliation`	`string`	否	Google 商店	用于指定供应公司或实体店面的商品关联商户。注意：`affiliation` 仅适用于商品级范围。
`coupon`	`string`	否	SUMMER_FUN	与商品相关的优惠券名称/代码。事件级和商品级 `coupon` 参数彼此独立。
`creative_name`	`string`	否	summer_banner2	促销广告素材的名称。如果设置此参数，系统会忽略事件级 `creative_name`。如果未设置此参数，系统会使用事件级 `creative_name`（如果存在）。
`creative_slot`	`string`	否	featured_app_1	与商品相关的促销广告素材投放到的广告位的名称。如果设置此参数，系统会忽略事件级 `creative_slot`。如果未设置此参数，系统会使用事件级 `creative_slot`（如果存在）。
`discount`	`number`	否	2.22	与商品相关的折扣货币价值。
`index`	`number`	否	5	列表中商品的索引/商品在列表中的位置。
`item_brand`	`string`	否	Google	商品所属品牌。
`item_category`	`string`	否	服饰	商品所属类别。如果将其用作类别层级或类目的一部分，则为第一个类别。
`item_category2`	`string`	否	成人	商品的第二个类别层级或其他类目。
`item_category3`	`string`	否	衬衫	商品的第三个类别层级或其他类目。
`item_category4`	`string`	否	圆领	商品的第四个类别层级或其他类目。
`item_category5`	`string`	否	短袖	商品的第五个类别层级或其他类目。
`item_list_id`	`string`	否	related_products	商品向用户展示时所在列表的 ID。如果设置此参数，系统会忽略事件级 `item_list_id`。如果未设置此参数，系统会使用事件级 `item_list_id`（如果存在）。
`item_list_name`	`string`	否	相关商品	商品向用户展示时所在列表的名称。如果设置此参数，系统会忽略事件级 `item_list_name`。如果未设置此参数，系统会使用事件级 `item_list_name`（如果存在）。
`item_variant`	`string`	否	绿色	用于提供其他商品详情/选项的商品款式/规格、唯一代码或说明。
`location_id`	`string`	否	ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID）	与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。注意：`location id` 仅适用于商品级范围。
`price`	`number`	否	9.99	商品的货币价格（以指定的 currency 参数为单位）。
`promotion_id`	`string`	否	P_12345	与商品相关的促销活动的 ID。如果设置此参数，系统会忽略事件级 `promotion_id`。如果未设置此参数，系统会使用事件级 `promotion_id`（如果存在）。
`promotion_name`	`string`	否	夏季促销	与商品相关的促销活动的名称。如果设置此参数，系统会忽略事件级 `promotion_name`。如果未设置此参数，系统会使用事件级 `promotion_name`（如果存在）。
`quantity`	`number`	否	1	商品数量。如果未设置，`quantity` 将设置为 1。

除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

发送事件

在 GA4 Event Builder 中试用此事件

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": 7.77,
        "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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

add_to_cart

此事件表示商品已添加到购物车，可供购买。

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 *如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`value`	`number`	是*	7.77	与事件相关的货币价值。为了生成有意义的报告，通常必须提供 `value`。如果您将事件标记为转化，则建议您设置 `value`。如果设置 `value`，则必须提供 `currency`。
`items`	`Array<Item>`	是		与事件相关的商品。

Item 参数

名称	类型	是否必须提供	示例值	说明
`item_id`	`string`	是*	SKU_12345	商品的 ID。 *必须提供 `item_id` 或 `item_name` 中的一个。
`item_name`	`string`	是*	Stan 和 Friends Tee	商品的名称。 *必须提供 `item_id` 或 `item_name` 中的一个。
`affiliation`	`string`	否	Google 商店	用于指定供应公司或实体店面的商品关联商户。注意：`affiliation` 仅适用于商品级范围。
`coupon`	`string`	否	SUMMER_FUN	与商品相关的优惠券名称/代码。事件级和商品级 `coupon` 参数彼此独立。
`creative_name`	`string`	否	summer_banner2	促销广告素材的名称。如果设置此参数，系统会忽略事件级 `creative_name`。如果未设置此参数，系统会使用事件级 `creative_name`（如果存在）。
`creative_slot`	`string`	否	featured_app_1	与商品相关的促销广告素材投放到的广告位的名称。如果设置此参数，系统会忽略事件级 `creative_slot`。如果未设置此参数，系统会使用事件级 `creative_slot`（如果存在）。
`discount`	`number`	否	2.22	与商品相关的折扣货币价值。
`index`	`number`	否	5	列表中商品的索引/商品在列表中的位置。
`item_brand`	`string`	否	Google	商品所属品牌。
`item_category`	`string`	否	服饰	商品所属类别。如果将其用作类别层级或类目的一部分，则为第一个类别。
`item_category2`	`string`	否	成人	商品的第二个类别层级或其他类目。
`item_category3`	`string`	否	衬衫	商品的第三个类别层级或其他类目。
`item_category4`	`string`	否	圆领	商品的第四个类别层级或其他类目。
`item_category5`	`string`	否	短袖	商品的第五个类别层级或其他类目。
`item_list_id`	`string`	否	related_products	商品向用户展示时所在列表的 ID。如果设置此参数，系统会忽略事件级 `item_list_id`。如果未设置此参数，系统会使用事件级 `item_list_id`（如果存在）。
`item_list_name`	`string`	否	相关商品	商品向用户展示时所在列表的名称。如果设置此参数，系统会忽略事件级 `item_list_name`。如果未设置此参数，系统会使用事件级 `item_list_name`（如果存在）。
`item_variant`	`string`	否	绿色	用于提供其他商品详情/选项的商品款式/规格、唯一代码或说明。
`location_id`	`string`	否	ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID）	与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。注意：`location id` 仅适用于商品级范围。
`price`	`number`	否	9.99	商品的货币价格（以指定的 currency 参数为单位）。
`promotion_id`	`string`	否	P_12345	与商品相关的促销活动的 ID。如果设置此参数，系统会忽略事件级 `promotion_id`。如果未设置此参数，系统会使用事件级 `promotion_id`（如果存在）。
`promotion_name`	`string`	否	夏季促销	与商品相关的促销活动的名称。如果设置此参数，系统会忽略事件级 `promotion_name`。如果未设置此参数，系统会使用事件级 `promotion_name`（如果存在）。
`quantity`	`number`	否	1	商品数量。如果未设置，`quantity` 将设置为 1。

除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

发送事件

在 GA4 Event Builder 中试用此事件

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": 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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

add_to_wishlist

此事件表示商品已添加到心愿单。使用此事件可找出您应用中的热门礼品。

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 *如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`value`	`number`	是*	7.77	与事件相关的货币价值。为了生成有意义的报告，通常必须提供 `value`。如果您将事件标记为转化，则建议您设置 `value`。如果设置 `value`，则必须提供 `currency`。
`items`	`Array<Item>`	是		与事件相关的商品。

Item 参数

名称	类型	是否必须提供	示例值	说明
`item_id`	`string`	是*	SKU_12345	商品的 ID。 *必须提供 `item_id` 或 `item_name` 中的一个。
`item_name`	`string`	是*	Stan 和 Friends Tee	商品的名称。 *必须提供 `item_id` 或 `item_name` 中的一个。
`affiliation`	`string`	否	Google 商店	用于指定供应公司或实体店面的商品关联商户。注意：`affiliation` 仅适用于商品级范围。
`coupon`	`string`	否	SUMMER_FUN	与商品相关的优惠券名称/代码。事件级和商品级 `coupon` 参数彼此独立。
`creative_name`	`string`	否	summer_banner2	促销广告素材的名称。如果设置此参数，系统会忽略事件级 `creative_name`。如果未设置此参数，系统会使用事件级 `creative_name`（如果存在）。
`creative_slot`	`string`	否	featured_app_1	与商品相关的促销广告素材投放到的广告位的名称。如果设置此参数，系统会忽略事件级 `creative_slot`。如果未设置此参数，系统会使用事件级 `creative_slot`（如果存在）。
`discount`	`number`	否	2.22	与商品相关的折扣货币价值。
`index`	`number`	否	5	列表中商品的索引/商品在列表中的位置。
`item_brand`	`string`	否	Google	商品所属品牌。
`item_category`	`string`	否	服饰	商品所属类别。如果将其用作类别层级或类目的一部分，则为第一个类别。
`item_category2`	`string`	否	成人	商品的第二个类别层级或其他类目。
`item_category3`	`string`	否	衬衫	商品的第三个类别层级或其他类目。
`item_category4`	`string`	否	圆领	商品的第四个类别层级或其他类目。
`item_category5`	`string`	否	短袖	商品的第五个类别层级或其他类目。
`item_list_id`	`string`	否	related_products	商品向用户展示时所在列表的 ID。如果设置此参数，系统会忽略事件级 `item_list_id`。如果未设置此参数，系统会使用事件级 `item_list_id`（如果存在）。
`item_list_name`	`string`	否	相关商品	商品向用户展示时所在列表的名称。如果设置此参数，系统会忽略事件级 `item_list_name`。如果未设置此参数，系统会使用事件级 `item_list_name`（如果存在）。
`item_variant`	`string`	否	绿色	用于提供其他商品详情/选项的商品款式/规格、唯一代码或说明。
`location_id`	`string`	否	ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID）	与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。注意：`location id` 仅适用于商品级范围。
`price`	`number`	否	9.99	商品的货币价格（以指定的 currency 参数为单位）。
`promotion_id`	`string`	否	P_12345	与商品相关的促销活动的 ID。如果设置此参数，系统会忽略事件级 `promotion_id`。如果未设置此参数，系统会使用事件级 `promotion_id`（如果存在）。
`promotion_name`	`string`	否	夏季促销	与商品相关的促销活动的名称。如果设置此参数，系统会忽略事件级 `promotion_name`。如果未设置此参数，系统会使用事件级 `promotion_name`（如果存在）。
`quantity`	`number`	否	1	商品数量。如果未设置，`quantity` 将设置为 1。

除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

发送事件

在 GA4 Event Builder 中试用此事件

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": 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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

begin_checkout

此事件表示用户已开始结账流程。

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 *如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`value`	`number`	是*	7.77	与事件相关的货币价值。为了生成有意义的报告，通常必须提供 `value`。如果您将事件标记为转化，则建议您设置 `value`。如果设置 `value`，则必须提供 `currency`。
`coupon`	`string`	否	SUMMER_FUN	与事件相关的优惠券名称/代码。事件级和商品级 `coupon` 参数彼此独立。
`items`	`Array<Item>`	是		与事件相关的商品。

Item 参数

名称	类型	是否必须提供	示例值	说明
`item_id`	`string`	是*	SKU_12345	商品的 ID。 *必须提供 `item_id` 或 `item_name` 中的一个。
`item_name`	`string`	是*	Stan 和 Friends Tee	商品的名称。 *必须提供 `item_id` 或 `item_name` 中的一个。
`affiliation`	`string`	否	Google 商店	用于指定供应公司或实体店面的商品关联商户。注意：`affiliation` 仅适用于商品级范围。
`coupon`	`string`	否	SUMMER_FUN	与商品相关的优惠券名称/代码。事件级和商品级 `coupon` 参数彼此独立。
`creative_name`	`string`	否	summer_banner2	促销广告素材的名称。如果设置此参数，系统会忽略事件级 `creative_name`。如果未设置此参数，系统会使用事件级 `creative_name`（如果存在）。
`creative_slot`	`string`	否	featured_app_1	与商品相关的促销广告素材投放到的广告位的名称。如果设置此参数，系统会忽略事件级 `creative_slot`。如果未设置此参数，系统会使用事件级 `creative_slot`（如果存在）。
`discount`	`number`	否	2.22	与商品相关的折扣货币价值。
`index`	`number`	否	5	列表中商品的索引/商品在列表中的位置。
`item_brand`	`string`	否	Google	商品所属品牌。
`item_category`	`string`	否	服饰	商品所属类别。如果将其用作类别层级或类目的一部分，则为第一个类别。
`item_category2`	`string`	否	成人	商品的第二个类别层级或其他类目。
`item_category3`	`string`	否	衬衫	商品的第三个类别层级或其他类目。
`item_category4`	`string`	否	圆领	商品的第四个类别层级或其他类目。
`item_category5`	`string`	否	短袖	商品的第五个类别层级或其他类目。
`item_list_id`	`string`	否	related_products	商品向用户展示时所在列表的 ID。如果设置此参数，系统会忽略事件级 `item_list_id`。如果未设置此参数，系统会使用事件级 `item_list_id`（如果存在）。
`item_list_name`	`string`	否	相关商品	商品向用户展示时所在列表的名称。如果设置此参数，系统会忽略事件级 `item_list_name`。如果未设置此参数，系统会使用事件级 `item_list_name`（如果存在）。
`item_variant`	`string`	否	绿色	用于提供其他商品详情/选项的商品款式/规格、唯一代码或说明。
`location_id`	`string`	否	ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID）	与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。注意：`location id` 仅适用于商品级范围。
`price`	`number`	否	9.99	商品的货币价格（以指定的 currency 参数为单位）。
`promotion_id`	`string`	否	P_12345	与商品相关的促销活动的 ID。如果设置此参数，系统会忽略事件级 `promotion_id`。如果未设置此参数，系统会使用事件级 `promotion_id`（如果存在）。
`promotion_name`	`string`	否	夏季促销	与商品相关的促销活动的名称。如果设置此参数，系统会忽略事件级 `promotion_name`。如果未设置此参数，系统会使用事件级 `promotion_name`（如果存在）。
`quantity`	`number`	否	1	商品数量。如果未设置，`quantity` 将设置为 1。

除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

发送事件

在 GA4 Event Builder 中试用此事件

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": 7.77,
        "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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

campaign_details

使用此事件发送将应用于未来事件的广告系列详情。

参数

名称	类型	是否必须提供	示例值	说明
`campaign_id`	`string`	否	google_1234	广告系列 ID。
`campaign`	`string`	否	Summer_fun	用于标识具体的促销活动或战略性广告系列的名称。
`source`	`string`	否	google	广告系列流量来源（例如 Google、电子邮件等）。
`medium`	`string`	否	cpc	广告系列媒介（例如电子邮件、每次点击费用等）。
`term`	`string`	否	summer+travel	广告系列字词，用于付费搜索，为广告提供关键字。
`content`	`string`	否	logolink	广告系列内容，用于 A/B 测试和内容定位广告，以区分指向相同网址的不同广告或链接。

发送事件

在 GA4 Event Builder 中试用此事件

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

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

earn_virtual_currency

此事件将衡量用户在游戏中获得虚拟货币的情况。请在记录此事件时一同记录 spend_virtual_currency 事件，以便更好地了解您的虚拟经济情况。

参数

名称	类型	是否必须提供	示例值	说明
`virtual_currency_name`	`string`	否	宝石	虚拟货币的名称。
`value`	`number`	否	5	虚拟货币的价值。

发送事件

在 GA4 Event Builder 中试用此事件

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

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

generate_lead

此事件将衡量带来潜在客户的情况（例如，通过表单）。请记录此事件，以了解营销广告系列的效果，以及向潜在客户进行再营销后吸引了多少客户重新与您的商家互动。

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 *如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`value`	`number`	是*	7.77	与事件相关的货币价值。为了生成有意义的报告，通常必须提供 `value`。如果您将事件标记为转化，则建议您设置 `value`。如果设置 `value`，则必须提供 `currency`。

发送事件

在 GA4 Event Builder 中试用此事件

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

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

join_group

在用户加入群组（例如公会、团队或家庭）时记录此事件。使用此事件可分析特定群组或社交功能的受欢迎程度。

参数

名称	类型	是否必须提供	示例值	说明
`group_id`	`string`	否	G_12345	群组的 ID。

发送事件

在 GA4 Event Builder 中试用此事件

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

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

level_up

此事件表示玩家在游戏中升级了。使用此事件可衡量用户群的等级分布情况，以及找出难以通过的关卡。

参数

名称	类型	是否必须提供	示例值	说明
`level`	`number`	否	5	角色的等级。
`character`	`string`	否	玩家 1	升级的角色。

发送事件

在 GA4 Event Builder 中试用此事件

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

发送此事件即表示用户登录了您的网站或应用。

参数

名称	类型	是否必须提供	示例值	说明
`method`	`string`	否	Google	登录时所用的方法。

发送事件

在 GA4 Event Builder 中试用此事件

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

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

post_score

在用户发布得分时发送此事件。使用此事件可了解用户在您游戏中的表现，并将最高得分与受众群体或行为关联起来。

参数

名称	类型	是否必须提供	示例值	说明
`score`	`number`	是	10000	要发布的得分。
`level`	`number`	否	5	得分对应的关卡。
`character`	`string`	否	玩家 1	获得相应得分的角色。

发送事件

在 GA4 Event Builder 中试用此事件

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

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

purchase

此事件表示用户已购买一件或多件商品。

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 *如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`transaction_id`	`string`	是	T_12345	交易的唯一标识符。 `transaction_id` 参数有助于避免出现重复的购买事件。
`value`	`number`	是*	12.21	与事件相关的货币价值。如需生成有意义的报告和填充“购买者”预测性受众群体，则必须提供 `value`。如果设置 `value`，则必须提供 `currency`。
`coupon`	`string`	否	SUMMER_FUN	与事件相关的优惠券名称/代码。事件级和商品级 `coupon` 参数彼此独立。
`shipping`	`number`	否	3.33	与交易相关的运费。
`tax`	`number`	否	1.11	与交易相关的税费。
`items`	`Array<Item>`	是		与事件相关的商品。

Item 参数

名称	类型	是否必须提供	示例值	说明
`item_id`	`string`	是*	SKU_12345	商品的 ID。 *必须提供 `item_id` 或 `item_name` 中的一个。
`item_name`	`string`	是*	Stan 和 Friends Tee	商品的名称。 *必须提供 `item_id` 或 `item_name` 中的一个。
`affiliation`	`string`	否	Google 商店	用于指定供应公司或实体店面的商品关联商户。注意：`affiliation` 仅适用于商品级范围。
`coupon`	`string`	否	SUMMER_FUN	与商品相关的优惠券名称/代码。事件级和商品级 `coupon` 参数彼此独立。
`creative_name`	`string`	否	summer_banner2	促销广告素材的名称。如果设置此参数，系统会忽略事件级 `creative_name`。如果未设置此参数，系统会使用事件级 `creative_name`（如果存在）。
`creative_slot`	`string`	否	featured_app_1	与商品相关的促销广告素材投放到的广告位的名称。如果设置此参数，系统会忽略事件级 `creative_slot`。如果未设置此参数，系统会使用事件级 `creative_slot`（如果存在）。
`discount`	`number`	否	2.22	与商品相关的折扣货币价值。
`index`	`number`	否	5	列表中商品的索引/商品在列表中的位置。
`item_brand`	`string`	否	Google	商品所属品牌。
`item_category`	`string`	否	服饰	商品所属类别。如果将其用作类别层级或类目的一部分，则为第一个类别。
`item_category2`	`string`	否	成人	商品的第二个类别层级或其他类目。
`item_category3`	`string`	否	衬衫	商品的第三个类别层级或其他类目。
`item_category4`	`string`	否	圆领	商品的第四个类别层级或其他类目。
`item_category5`	`string`	否	短袖	商品的第五个类别层级或其他类目。
`item_list_id`	`string`	否	related_products	商品向用户展示时所在列表的 ID。如果设置此参数，系统会忽略事件级 `item_list_id`。如果未设置此参数，系统会使用事件级 `item_list_id`（如果存在）。
`item_list_name`	`string`	否	相关商品	商品向用户展示时所在列表的名称。如果设置此参数，系统会忽略事件级 `item_list_name`。如果未设置此参数，系统会使用事件级 `item_list_name`（如果存在）。
`item_variant`	`string`	否	绿色	用于提供其他商品详情/选项的商品款式/规格、唯一代码或说明。
`location_id`	`string`	否	ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID）	与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。注意：`location id` 仅适用于商品级范围。
`price`	`number`	否	9.99	商品的货币价格（以指定的 currency 参数为单位）。
`promotion_id`	`string`	否	P_12345	与商品相关的促销活动的 ID。如果设置此参数，系统会忽略事件级 `promotion_id`。如果未设置此参数，系统会使用事件级 `promotion_id`（如果存在）。
`promotion_name`	`string`	否	夏季促销	与商品相关的促销活动的名称。如果设置此参数，系统会忽略事件级 `promotion_name`。如果未设置此参数，系统会使用事件级 `promotion_name`（如果存在）。
`quantity`	`number`	否	1	商品数量。如果未设置，`quantity` 将设置为 1。

除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

发送事件

在 GA4 Event Builder 中试用此事件

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": 12.21,
        "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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

refund

此事件表示向用户退回一件或多件商品的款项。

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 *如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`transaction_id`	`string`	是	T_12345	交易的唯一标识符。
`value`	`number`	是*	7.77	与事件相关的货币价值。为了生成有意义的报告，通常必须提供 `value`。如果您将事件标记为转化，则建议您设置 `value`。如果设置 `value`，则必须提供 `currency`。
`coupon`	`string`	否	SUMMER_FUN	与事件相关的优惠券名称/代码。事件级和商品级 `coupon` 参数彼此独立。
`shipping`	`number`	否	3.33	与交易相关的运费。
`tax`	`number`	否	1.11	与交易相关的税费。
`items`	`Array<Item>`	否*		与事件相关的商品。

Item 参数

名称	类型	是否必须提供	示例值	说明
`item_id`	`string`	是*	SKU_12345	商品的 ID。 *必须提供 `item_id` 或 `item_name` 中的一个。
`item_name`	`string`	是*	Stan 和 Friends Tee	商品的名称。 *必须提供 `item_id` 或 `item_name` 中的一个。
`affiliation`	`string`	否	Google 商店	用于指定供应公司或实体店面的商品关联商户。注意：`affiliation` 仅适用于商品级范围。
`coupon`	`string`	否	SUMMER_FUN	与商品相关的优惠券名称/代码。事件级和商品级 `coupon` 参数彼此独立。
`creative_name`	`string`	否	summer_banner2	促销广告素材的名称。如果设置此参数，系统会忽略事件级 `creative_name`。如果未设置此参数，系统会使用事件级 `creative_name`（如果存在）。
`creative_slot`	`string`	否	featured_app_1	与商品相关的促销广告素材投放到的广告位的名称。如果设置此参数，系统会忽略事件级 `creative_slot`。如果未设置此参数，系统会使用事件级 `creative_slot`（如果存在）。
`discount`	`number`	否	2.22	与商品相关的折扣货币价值。
`index`	`number`	否	5	列表中商品的索引/商品在列表中的位置。
`item_brand`	`string`	否	Google	商品所属品牌。
`item_category`	`string`	否	服饰	商品所属类别。如果将其用作类别层级或类目的一部分，则为第一个类别。
`item_category2`	`string`	否	成人	商品的第二个类别层级或其他类目。
`item_category3`	`string`	否	衬衫	商品的第三个类别层级或其他类目。
`item_category4`	`string`	否	圆领	商品的第四个类别层级或其他类目。
`item_category5`	`string`	否	短袖	商品的第五个类别层级或其他类目。
`item_list_id`	`string`	否	related_products	商品向用户展示时所在列表的 ID。如果设置此参数，系统会忽略事件级 `item_list_id`。如果未设置此参数，系统会使用事件级 `item_list_id`（如果存在）。
`item_list_name`	`string`	否	相关商品	商品向用户展示时所在列表的名称。如果设置此参数，系统会忽略事件级 `item_list_name`。如果未设置此参数，系统会使用事件级 `item_list_name`（如果存在）。
`item_variant`	`string`	否	绿色	用于提供其他商品详情/选项的商品款式/规格、唯一代码或说明。
`location_id`	`string`	否	ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID）	与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。注意：`location id` 仅适用于商品级范围。
`price`	`number`	否	9.99	商品的货币价格（以指定的 currency 参数为单位）。
`promotion_id`	`string`	否	P_12345	与商品相关的促销活动的 ID。如果设置此参数，系统会忽略事件级 `promotion_id`。如果未设置此参数，系统会使用事件级 `promotion_id`（如果存在）。
`promotion_name`	`string`	否	夏季促销	与商品相关的促销活动的名称。如果设置此参数，系统会忽略事件级 `promotion_name`。如果未设置此参数，系统会使用事件级 `promotion_name`（如果存在）。
`quantity`	`number`	否	1	商品数量。如果未设置，`quantity` 将设置为 1。

除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

发送事件

在 GA4 Event Builder 中试用此事件

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": 12.21,
        "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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

remove_from_cart

此事件表示商品已从购物车中移除。

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 *如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`value`	`number`	是*	7.77	与事件相关的货币价值。为了生成有意义的报告，通常必须提供 `value`。如果您将事件标记为转化，则建议您设置 `value`。如果设置 `value`，则必须提供 `currency`。
`items`	`Array<Item>`	是		与事件相关的商品。

Item 参数

名称	类型	是否必须提供	示例值	说明
`item_id`	`string`	是*	SKU_12345	商品的 ID。 *必须提供 `item_id` 或 `item_name` 中的一个。
`item_name`	`string`	是*	Stan 和 Friends Tee	商品的名称。 *必须提供 `item_id` 或 `item_name` 中的一个。
`affiliation`	`string`	否	Google 商店	用于指定供应公司或实体店面的商品关联商户。注意：`affiliation` 仅适用于商品级范围。
`coupon`	`string`	否	SUMMER_FUN	与商品相关的优惠券名称/代码。事件级和商品级 `coupon` 参数彼此独立。
`creative_name`	`string`	否	summer_banner2	促销广告素材的名称。如果设置此参数，系统会忽略事件级 `creative_name`。如果未设置此参数，系统会使用事件级 `creative_name`（如果存在）。
`creative_slot`	`string`	否	featured_app_1	与商品相关的促销广告素材投放到的广告位的名称。如果设置此参数，系统会忽略事件级 `creative_slot`。如果未设置此参数，系统会使用事件级 `creative_slot`（如果存在）。
`discount`	`number`	否	2.22	与商品相关的折扣货币价值。
`index`	`number`	否	5	列表中商品的索引/商品在列表中的位置。
`item_brand`	`string`	否	Google	商品所属品牌。
`item_category`	`string`	否	服饰	商品所属类别。如果将其用作类别层级或类目的一部分，则为第一个类别。
`item_category2`	`string`	否	成人	商品的第二个类别层级或其他类目。
`item_category3`	`string`	否	衬衫	商品的第三个类别层级或其他类目。
`item_category4`	`string`	否	圆领	商品的第四个类别层级或其他类目。
`item_category5`	`string`	否	短袖	商品的第五个类别层级或其他类目。
`item_list_id`	`string`	否	related_products	商品向用户展示时所在列表的 ID。如果设置此参数，系统会忽略事件级 `item_list_id`。如果未设置此参数，系统会使用事件级 `item_list_id`（如果存在）。
`item_list_name`	`string`	否	相关商品	商品向用户展示时所在列表的名称。如果设置此参数，系统会忽略事件级 `item_list_name`。如果未设置此参数，系统会使用事件级 `item_list_name`（如果存在）。
`item_variant`	`string`	否	绿色	用于提供其他商品详情/选项的商品款式/规格、唯一代码或说明。
`location_id`	`string`	否	ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID）	与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。注意：`location id` 仅适用于商品级范围。
`price`	`number`	否	9.99	商品的货币价格（以指定的 currency 参数为单位）。
`promotion_id`	`string`	否	P_12345	与商品相关的促销活动的 ID。如果设置此参数，系统会忽略事件级 `promotion_id`。如果未设置此参数，系统会使用事件级 `promotion_id`（如果存在）。
`promotion_name`	`string`	否	夏季促销	与商品相关的促销活动的名称。如果设置此参数，系统会忽略事件级 `promotion_name`。如果未设置此参数，系统会使用事件级 `promotion_name`（如果存在）。
`quantity`	`number`	否	1	商品数量。如果未设置，`quantity` 将设置为 1。

除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

发送事件

在 GA4 Event Builder 中试用此事件

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": 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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

search

记录此事件，以表明用户何时执行了搜索。您可以使用此事件来确定用户在您的网站或应用上搜索的内容。例如，如果用户在执行搜索后查看了搜索结果页，您就可以发送此事件。

参数

名称	类型	是否必须提供	示例值	说明
`search_term`	`string`	是	T 恤	搜索的字词。

发送事件

在 GA4 Event Builder 中试用此事件

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`	否	产品	所选内容的类型。
`content_id`	`string`	否	C_12345	所选内容的标识符。

发送事件

在 GA4 Event Builder 中试用此事件

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

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

select_item

此事件表示从列表中选择了商品。

参数

名称	类型	是否必须提供	示例值	说明
`item_list_id`	`string`	否	related_products	商品向用户展示时所在列表的 ID。如果在商品级别进行设置，系统会忽略此参数。
`item_list_name`	`string`	否	相关商品	商品向用户展示时所在列表的名称。如果在商品级别进行设置，系统会忽略此参数。
`items`	`Array<Item>`	是*		与事件相关的商品。 *`items` 数组应包含一个表示所选商品的元素。如果提供了多个元素，则仅使用 `items` 中的第一个元素。

Item 参数

名称	类型	是否必须提供	示例值	说明
`item_id`	`string`	是*	SKU_12345	商品的 ID。 *必须提供 `item_id` 或 `item_name` 中的一个。
`item_name`	`string`	是*	Stan 和 Friends Tee	商品的名称。 *必须提供 `item_id` 或 `item_name` 中的一个。
`affiliation`	`string`	否	Google 商店	用于指定供应公司或实体店面的商品关联商户。注意：`affiliation` 仅适用于商品级范围。
`coupon`	`string`	否	SUMMER_FUN	与商品相关的优惠券名称/代码。事件级和商品级 `coupon` 参数彼此独立。
`creative_name`	`string`	否	summer_banner2	促销广告素材的名称。如果设置此参数，系统会忽略事件级 `creative_name`。如果未设置此参数，系统会使用事件级 `creative_name`（如果存在）。
`creative_slot`	`string`	否	featured_app_1	与商品相关的促销广告素材投放到的广告位的名称。如果设置此参数，系统会忽略事件级 `creative_slot`。如果未设置此参数，系统会使用事件级 `creative_slot`（如果存在）。
`discount`	`number`	否	2.22	与商品相关的折扣货币价值。
`index`	`number`	否	5	列表中商品的索引/商品在列表中的位置。
`item_brand`	`string`	否	Google	商品所属品牌。
`item_category`	`string`	否	服饰	商品所属类别。如果将其用作类别层级或类目的一部分，则为第一个类别。
`item_category2`	`string`	否	成人	商品的第二个类别层级或其他类目。
`item_category3`	`string`	否	衬衫	商品的第三个类别层级或其他类目。
`item_category4`	`string`	否	圆领	商品的第四个类别层级或其他类目。
`item_category5`	`string`	否	短袖	商品的第五个类别层级或其他类目。
`item_list_id`	`string`	否	related_products	商品向用户展示时所在列表的 ID。如果设置此参数，系统会忽略事件级 `item_list_id`。如果未设置此参数，系统会使用事件级 `item_list_id`（如果存在）。
`item_list_name`	`string`	否	相关商品	商品向用户展示时所在列表的名称。如果设置此参数，系统会忽略事件级 `item_list_name`。如果未设置此参数，系统会使用事件级 `item_list_name`（如果存在）。
`item_variant`	`string`	否	绿色	用于提供其他商品详情/选项的商品款式/规格、唯一代码或说明。
`location_id`	`string`	否	ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID）	与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。注意：`location id` 仅适用于商品级范围。
`price`	`number`	否	9.99	商品的货币价格（以指定的 currency 参数为单位）。
`promotion_id`	`string`	否	P_12345	与商品相关的促销活动的 ID。如果设置此参数，系统会忽略事件级 `promotion_id`。如果未设置此参数，系统会使用事件级 `promotion_id`（如果存在）。
`promotion_name`	`string`	否	夏季促销	与商品相关的促销活动的名称。如果设置此参数，系统会忽略事件级 `promotion_name`。如果未设置此参数，系统会使用事件级 `promotion_name`（如果存在）。
`quantity`	`number`	否	1	商品数量。如果未设置，`quantity` 将设置为 1。

除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

发送事件

在 GA4 Event Builder 中试用此事件

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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

select_promotion

此事件表示从列表中选择了推广活动。

参数

名称	类型	是否必须提供	示例值	说明
`creative_name`	`string`	否	summer_banner2	促销广告素材的名称。如果在商品级别进行设置，系统会忽略此参数。
`creative_slot`	`string`	否	featured_app_1	与事件相关的促销广告素材投放到的广告位的名称。如果在商品级别进行设置，系统会忽略此参数。
`promotion_id`	`string`	否	P_12345	与事件相关的促销活动的 ID。如果在商品级别进行设置，系统会忽略此参数。
`promotion_name`	`string`	否	夏季促销	与事件相关的促销活动的名称。如果在商品级别进行设置，系统会忽略此参数。
`items`	`Array<Item>`	否		与事件相关的商品。

Item 参数

名称	类型	是否必须提供	示例值	说明
`item_id`	`string`	是*	SKU_12345	商品的 ID。 *必须提供 `item_id` 或 `item_name` 中的一个。
`item_name`	`string`	是*	Stan 和 Friends Tee	商品的名称。 *必须提供 `item_id` 或 `item_name` 中的一个。
`affiliation`	`string`	否	Google 商店	用于指定供应公司或实体店面的商品关联商户。注意：`affiliation` 仅适用于商品级范围。
`coupon`	`string`	否	SUMMER_FUN	与商品相关的优惠券名称/代码。事件级和商品级 `coupon` 参数彼此独立。
`creative_name`	`string`	否	summer_banner2	促销广告素材的名称。如果设置此参数，系统会忽略事件级 `creative_name`。如果未设置此参数，系统会使用事件级 `creative_name`（如果存在）。
`creative_slot`	`string`	否	featured_app_1	与商品相关的促销广告素材投放到的广告位的名称。如果设置此参数，系统会忽略事件级 `creative_slot`。如果未设置此参数，系统会使用事件级 `creative_slot`（如果存在）。
`discount`	`number`	否	2.22	与商品相关的折扣货币价值。
`index`	`number`	否	5	列表中商品的索引/商品在列表中的位置。
`item_brand`	`string`	否	Google	商品所属品牌。
`item_category`	`string`	否	服饰	商品所属类别。如果将其用作类别层级或类目的一部分，则为第一个类别。
`item_category2`	`string`	否	成人	商品的第二个类别层级或其他类目。
`item_category3`	`string`	否	衬衫	商品的第三个类别层级或其他类目。
`item_category4`	`string`	否	圆领	商品的第四个类别层级或其他类目。
`item_category5`	`string`	否	短袖	商品的第五个类别层级或其他类目。
`item_list_id`	`string`	否	related_products	商品向用户展示时所在列表的 ID。如果设置此参数，系统会忽略事件级 `item_list_id`。如果未设置此参数，系统会使用事件级 `item_list_id`（如果存在）。
`item_list_name`	`string`	否	相关商品	商品向用户展示时所在列表的名称。如果设置此参数，系统会忽略事件级 `item_list_name`。如果未设置此参数，系统会使用事件级 `item_list_name`（如果存在）。
`item_variant`	`string`	否	绿色	用于提供其他商品详情/选项的商品款式/规格、唯一代码或说明。
`location_id`	`string`	否	ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID）	与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。注意：`location id` 仅适用于商品级范围。
`price`	`number`	否	9.99	商品的货币价格（以指定的 currency 参数为单位）。
`promotion_id`	`string`	否	P_12345	与商品相关的促销活动的 ID。如果设置此参数，系统会忽略事件级 `promotion_id`。如果未设置此参数，系统会使用事件级 `promotion_id`（如果存在）。
`promotion_name`	`string`	否	夏季促销	与商品相关的促销活动的名称。如果设置此参数，系统会忽略事件级 `promotion_name`。如果未设置此参数，系统会使用事件级 `promotion_name`（如果存在）。
`quantity`	`number`	否	1	商品数量。如果未设置，`quantity` 将设置为 1。

除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

发送事件

在 GA4 Event Builder 中试用此事件

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": 9.99,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 1
          }
        ]
      }
    }]
  })
});

在用户分享了内容时使用此事件。

参数

名称	类型	是否必须提供	示例值	说明
`method`	`string`	否	Twitter	共享内容的方法。
`content_type`	`string`	否	图片	共享内容的类型。
`item_id`	`string`	否	C_12345	共享内容的 ID。

发送事件

在 GA4 Event Builder 中试用此事件

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

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

sign_up

此事件表示用户已注册账号。使用此事件可了解登录用户和退出用户的不同行为。

参数

名称	类型	是否必须提供	示例值	说明
`method`	`string`	否	Google	注册时所用的方法。

发送事件

在 GA4 Event Builder 中试用此事件

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

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

spend_virtual_currency

此事件衡量的是应用内虚拟商品的销售情况，有助于您确定哪些虚拟商品最受欢迎。

参数

名称	类型	是否必须提供	示例值	说明
`value`	`number`	是	5	虚拟货币的价值。
`virtual_currency_name`	`string`	是	宝石	虚拟货币的名称。
`item_name`	`string`	否	启动积分加倍活动	使用虚拟货币的商品的名称。

发送事件

在 GA4 Event Builder 中试用此事件

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

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

tutorial_begin

此事件表示新手入门流程已开始。在包含 tutorial_complete 的漏斗中使用此事件可了解有多少用户完成了教程。

参数

未针对此事件推荐任何参数。

此事件没有任何参数。

发送事件

在 GA4 Event Builder 中试用此事件

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

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

tutorial_complete

此事件表示用户已完成新手入门流程。在包含 tutorial_begin 的漏斗中使用此事件可了解有多少用户完成了教程。

参数

未针对此事件推荐任何参数。

发送事件

在 GA4 Event Builder 中试用此事件

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

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

unlock_achievement

在用户解锁成就时记录此事件。此事件有助于您了解用户在您游戏中的体验。

参数

名称	类型	是否必须提供	示例值	说明
`achievement_id`	`string`	是	A_12345	已解锁成就的 ID。

发送事件

在 GA4 Event Builder 中试用此事件

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

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

view_cart

此事件表示用户查看了购物车。

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 *如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`value`	`number`	是*	7.77	与事件相关的货币价值。为了生成有意义的报告，通常必须提供 `value`。如果您将事件标记为转化，则建议您设置 `value`。如果设置 `value`，则必须提供 `currency`。
`items`	`Array<Item>`	是		与事件相关的商品。

Item 参数

名称	类型	是否必须提供	示例值	说明
`item_id`	`string`	是*	SKU_12345	商品的 ID。 *必须提供 `item_id` 或 `item_name` 中的一个。
`item_name`	`string`	是*	Stan 和 Friends Tee	商品的名称。 *必须提供 `item_id` 或 `item_name` 中的一个。
`affiliation`	`string`	否	Google 商店	用于指定供应公司或实体店面的商品关联商户。注意：`affiliation` 仅适用于商品级范围。
`coupon`	`string`	否	SUMMER_FUN	与商品相关的优惠券名称/代码。事件级和商品级 `coupon` 参数彼此独立。
`creative_name`	`string`	否	summer_banner2	促销广告素材的名称。如果设置此参数，系统会忽略事件级 `creative_name`。如果未设置此参数，系统会使用事件级 `creative_name`（如果存在）。
`creative_slot`	`string`	否	featured_app_1	与商品相关的促销广告素材投放到的广告位的名称。如果设置此参数，系统会忽略事件级 `creative_slot`。如果未设置此参数，系统会使用事件级 `creative_slot`（如果存在）。
`discount`	`number`	否	2.22	与商品相关的折扣货币价值。
`index`	`number`	否	5	列表中商品的索引/商品在列表中的位置。
`item_brand`	`string`	否	Google	商品所属品牌。
`item_category`	`string`	否	服饰	商品所属类别。如果将其用作类别层级或类目的一部分，则为第一个类别。
`item_category2`	`string`	否	成人	商品的第二个类别层级或其他类目。
`item_category3`	`string`	否	衬衫	商品的第三个类别层级或其他类目。
`item_category4`	`string`	否	圆领	商品的第四个类别层级或其他类目。
`item_category5`	`string`	否	短袖	商品的第五个类别层级或其他类目。
`item_list_id`	`string`	否	related_products	商品向用户展示时所在列表的 ID。如果设置此参数，系统会忽略事件级 `item_list_id`。如果未设置此参数，系统会使用事件级 `item_list_id`（如果存在）。
`item_list_name`	`string`	否	相关商品	商品向用户展示时所在列表的名称。如果设置此参数，系统会忽略事件级 `item_list_name`。如果未设置此参数，系统会使用事件级 `item_list_name`（如果存在）。
`item_variant`	`string`	否	绿色	用于提供其他商品详情/选项的商品款式/规格、唯一代码或说明。
`location_id`	`string`	否	ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID）	与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。注意：`location id` 仅适用于商品级范围。
`price`	`number`	否	9.99	商品的货币价格（以指定的 currency 参数为单位）。
`promotion_id`	`string`	否	P_12345	与商品相关的促销活动的 ID。如果设置此参数，系统会忽略事件级 `promotion_id`。如果未设置此参数，系统会使用事件级 `promotion_id`（如果存在）。
`promotion_name`	`string`	否	夏季促销	与商品相关的促销活动的名称。如果设置此参数，系统会忽略事件级 `promotion_name`。如果未设置此参数，系统会使用事件级 `promotion_name`（如果存在）。
`quantity`	`number`	否	1	商品数量。如果未设置，`quantity` 将设置为 1。

除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

发送事件

在 GA4 Event Builder 中试用此事件

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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

view_item

此事件表示向用户展示了某些内容。使用此事件可了解用户查看了哪些最热门商品。

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 *如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`value`	`number`	是*	7.77	与事件相关的货币价值。为了生成有意义的报告，通常必须提供 `value`。如果您将事件标记为转化，则建议您设置 `value`。如果设置 `value`，则必须提供 `currency`。
`items`	`Array<Item>`	是		与事件相关的商品。

Item 参数

名称	类型	是否必须提供	示例值	说明
`item_id`	`string`	是*	SKU_12345	商品的 ID。 *必须提供 `item_id` 或 `item_name` 中的一个。
`item_name`	`string`	是*	Stan 和 Friends Tee	商品的名称。 *必须提供 `item_id` 或 `item_name` 中的一个。
`affiliation`	`string`	否	Google 商店	用于指定供应公司或实体店面的商品关联商户。注意：`affiliation` 仅适用于商品级范围。
`coupon`	`string`	否	SUMMER_FUN	与商品相关的优惠券名称/代码。事件级和商品级 `coupon` 参数彼此独立。
`creative_name`	`string`	否	summer_banner2	促销广告素材的名称。如果设置此参数，系统会忽略事件级 `creative_name`。如果未设置此参数，系统会使用事件级 `creative_name`（如果存在）。
`creative_slot`	`string`	否	featured_app_1	与商品相关的促销广告素材投放到的广告位的名称。如果设置此参数，系统会忽略事件级 `creative_slot`。如果未设置此参数，系统会使用事件级 `creative_slot`（如果存在）。
`discount`	`number`	否	2.22	与商品相关的折扣货币价值。
`index`	`number`	否	5	列表中商品的索引/商品在列表中的位置。
`item_brand`	`string`	否	Google	商品所属品牌。
`item_category`	`string`	否	服饰	商品所属类别。如果将其用作类别层级或类目的一部分，则为第一个类别。
`item_category2`	`string`	否	成人	商品的第二个类别层级或其他类目。
`item_category3`	`string`	否	衬衫	商品的第三个类别层级或其他类目。
`item_category4`	`string`	否	圆领	商品的第四个类别层级或其他类目。
`item_category5`	`string`	否	短袖	商品的第五个类别层级或其他类目。
`item_list_id`	`string`	否	related_products	商品向用户展示时所在列表的 ID。如果设置此参数，系统会忽略事件级 `item_list_id`。如果未设置此参数，系统会使用事件级 `item_list_id`（如果存在）。
`item_list_name`	`string`	否	相关商品	商品向用户展示时所在列表的名称。如果设置此参数，系统会忽略事件级 `item_list_name`。如果未设置此参数，系统会使用事件级 `item_list_name`（如果存在）。
`item_variant`	`string`	否	绿色	用于提供其他商品详情/选项的商品款式/规格、唯一代码或说明。
`location_id`	`string`	否	ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID）	与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。注意：`location id` 仅适用于商品级范围。
`price`	`number`	否	9.99	商品的货币价格（以指定的 currency 参数为单位）。
`promotion_id`	`string`	否	P_12345	与商品相关的促销活动的 ID。如果设置此参数，系统会忽略事件级 `promotion_id`。如果未设置此参数，系统会使用事件级 `promotion_id`（如果存在）。
`promotion_name`	`string`	否	夏季促销	与商品相关的促销活动的名称。如果设置此参数，系统会忽略事件级 `promotion_name`。如果未设置此参数，系统会使用事件级 `promotion_name`（如果存在）。
`quantity`	`number`	否	1	商品数量。如果未设置，`quantity` 将设置为 1。

除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

发送事件

在 GA4 Event Builder 中试用此事件

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": 9.99,
            "quantity": 1
          }
        ],
      }
    }]
  })
});

view_item_list

向用户展示某类商品的列表时记录此事件。

参数

名称	类型	是否必须提供	示例值	说明
`item_list_id`	`string`	否	related_products	商品向用户展示时所在列表的 ID。如果在商品级别进行设置，系统会忽略此参数。
`item_list_name`	`string`	否	相关商品	商品向用户展示时所在列表的名称。如果在商品级别进行设置，系统会忽略此参数。
`items`	`Array<Item>`	是		与事件相关的商品。

Item 参数

名称	类型	是否必须提供	示例值	说明
`item_id`	`string`	是*	SKU_12345	商品的 ID。 *必须提供 `item_id` 或 `item_name` 中的一个。
`item_name`	`string`	是*	Stan 和 Friends Tee	商品的名称。 *必须提供 `item_id` 或 `item_name` 中的一个。
`affiliation`	`string`	否	Google 商店	用于指定供应公司或实体店面的商品关联商户。注意：`affiliation` 仅适用于商品级范围。
`coupon`	`string`	否	SUMMER_FUN	与商品相关的优惠券名称/代码。事件级和商品级 `coupon` 参数彼此独立。
`creative_name`	`string`	否	summer_banner2	促销广告素材的名称。如果设置此参数，系统会忽略事件级 `creative_name`。如果未设置此参数，系统会使用事件级 `creative_name`（如果存在）。
`creative_slot`	`string`	否	featured_app_1	与商品相关的促销广告素材投放到的广告位的名称。如果设置此参数，系统会忽略事件级 `creative_slot`。如果未设置此参数，系统会使用事件级 `creative_slot`（如果存在）。
`discount`	`number`	否	2.22	与商品相关的折扣货币价值。
`index`	`number`	否	5	列表中商品的索引/商品在列表中的位置。
`item_brand`	`string`	否	Google	商品所属品牌。
`item_category`	`string`	否	服饰	商品所属类别。如果将其用作类别层级或类目的一部分，则为第一个类别。
`item_category2`	`string`	否	成人	商品的第二个类别层级或其他类目。
`item_category3`	`string`	否	衬衫	商品的第三个类别层级或其他类目。
`item_category4`	`string`	否	圆领	商品的第四个类别层级或其他类目。
`item_category5`	`string`	否	短袖	商品的第五个类别层级或其他类目。
`item_list_id`	`string`	否	related_products	商品向用户展示时所在列表的 ID。如果设置此参数，系统会忽略事件级 `item_list_id`。如果未设置此参数，系统会使用事件级 `item_list_id`（如果存在）。
`item_list_name`	`string`	否	相关商品	商品向用户展示时所在列表的名称。如果设置此参数，系统会忽略事件级 `item_list_name`。如果未设置此参数，系统会使用事件级 `item_list_name`（如果存在）。
`item_variant`	`string`	否	绿色	用于提供其他商品详情/选项的商品款式/规格、唯一代码或说明。
`location_id`	`string`	否	ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID）	与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。注意：`location id` 仅适用于商品级范围。
`price`	`number`	否	9.99	商品的货币价格（以指定的 currency 参数为单位）。
`promotion_id`	`string`	否	P_12345	与商品相关的促销活动的 ID。如果设置此参数，系统会忽略事件级 `promotion_id`。如果未设置此参数，系统会使用事件级 `promotion_id`（如果存在）。
`promotion_name`	`string`	否	夏季促销	与商品相关的促销活动的名称。如果设置此参数，系统会忽略事件级 `promotion_name`。如果未设置此参数，系统会使用事件级 `promotion_name`（如果存在）。
`quantity`	`number`	否	1	商品数量。如果未设置，`quantity` 将设置为 1。

除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

发送事件

在 GA4 Event Builder 中试用此事件

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": 9.99,
            "quantity": 1
          }
        ]
      }
    }]
  })
});

view_promotion

此事件表示从列表查看了推广活动。

参数

名称	类型	是否必须提供	示例值	说明
`creative_name`	`string`	否	summer_banner2	促销广告素材的名称。如果在商品级别进行设置，系统会忽略此参数。
`creative_slot`	`string`	否	featured_app_1	与事件相关的促销广告素材投放到的广告位的名称。如果在商品级别进行设置，系统会忽略此参数。
`promotion_id`	`string`	否	P_12345	与事件相关的促销活动的 ID。如果在商品级别进行设置，系统会忽略此参数。
`promotion_name`	`string`	否	夏季促销	与事件相关的促销活动的名称。如果在商品级别进行设置，系统会忽略此参数。
`items`	`Array<Item>`	是*		与事件相关的商品。 *`items` 数组应包含一个表示促销活动相关商品的元素。如果提供了多个元素，则仅使用 `items` 中的第一个元素。

Item 参数

名称	类型	是否必须提供	示例值	说明
`item_id`	`string`	是*	SKU_12345	商品的 ID。 *必须提供 `item_id` 或 `item_name` 中的一个。
`item_name`	`string`	是*	Stan 和 Friends Tee	商品的名称。 *必须提供 `item_id` 或 `item_name` 中的一个。
`affiliation`	`string`	否	Google 商店	用于指定供应公司或实体店面的商品关联商户。注意：`affiliation` 仅适用于商品级范围。
`coupon`	`string`	否	SUMMER_FUN	与商品相关的优惠券名称/代码。事件级和商品级 `coupon` 参数彼此独立。
`creative_name`	`string`	否	summer_banner2	促销广告素材的名称。如果设置此参数，系统会忽略事件级 `creative_name`。如果未设置此参数，系统会使用事件级 `creative_name`（如果存在）。
`creative_slot`	`string`	否	featured_app_1	与商品相关的促销广告素材投放到的广告位的名称。如果设置此参数，系统会忽略事件级 `creative_slot`。如果未设置此参数，系统会使用事件级 `creative_slot`（如果存在）。
`discount`	`number`	否	2.22	与商品相关的折扣货币价值。
`index`	`number`	否	5	列表中商品的索引/商品在列表中的位置。
`item_brand`	`string`	否	Google	商品所属品牌。
`item_category`	`string`	否	服饰	商品所属类别。如果将其用作类别层级或类目的一部分，则为第一个类别。
`item_category2`	`string`	否	成人	商品的第二个类别层级或其他类目。
`item_category3`	`string`	否	衬衫	商品的第三个类别层级或其他类目。
`item_category4`	`string`	否	圆领	商品的第四个类别层级或其他类目。
`item_category5`	`string`	否	短袖	商品的第五个类别层级或其他类目。
`item_list_id`	`string`	否	related_products	商品向用户展示时所在列表的 ID。如果设置此参数，系统会忽略事件级 `item_list_id`。如果未设置此参数，系统会使用事件级 `item_list_id`（如果存在）。
`item_list_name`	`string`	否	相关商品	商品向用户展示时所在列表的名称。如果设置此参数，系统会忽略事件级 `item_list_name`。如果未设置此参数，系统会使用事件级 `item_list_name`（如果存在）。
`item_variant`	`string`	否	绿色	用于提供其他商品详情/选项的商品款式/规格、唯一代码或说明。
`location_id`	`string`	否	ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID）	与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。注意：`location id` 仅适用于商品级范围。
`price`	`number`	否	9.99	商品的货币价格（以指定的 currency 参数为单位）。
`promotion_id`	`string`	否	P_12345	与商品相关的促销活动的 ID。如果设置此参数，系统会忽略事件级 `promotion_id`。如果未设置此参数，系统会使用事件级 `promotion_id`（如果存在）。
`promotion_name`	`string`	否	夏季促销	与商品相关的促销活动的名称。如果设置此参数，系统会忽略事件级 `promotion_name`。如果未设置此参数，系统会使用事件级 `promotion_name`（如果存在）。
`quantity`	`number`	否	1	商品数量。如果未设置，`quantity` 将设置为 1。

除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

发送事件

在 GA4 Event Builder 中试用此事件

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": 9.99,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 1
          }
        ]
      }
    }]
  })
});

view_search_results

向用户展示搜索结果时记录此事件。请注意，您可以通过 Google Analytics（分析）中的增强型事件衡量功能，实现 view_search_results 事件自动收集。

参数

名称	类型	是否必须提供	示例值	说明
`search_term`	`string`	否	服饰	搜索时所用的字词。

发送事件

在 GA4 Event Builder 中试用此事件

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