此页面由 Cloud Translation API 翻译。

推荐事件

Google Analytics 会自动发送某些事件类型。本页介绍了可选的其他事件，您可以配置这些事件来衡量更多行为，并为您的业务生成更实用的报告。这些额外的事件需要您付出更多精力进行配置，然后才能使用，因此 Google Analytics 4 无法自动发送这些事件。如需有关如何为您的网站或应用配置推荐事件和自定义事件的分步说明，请参阅设置事件。

如需查看您可以使用的每个事件的详细信息，请选择您的代码管理平台：

`add_payment_info`

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

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 `view_item` 事件中不计入收入的价值指标 * 如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`value`	`number`	是*	30.03	与事件相关的货币价值。 * 将 `value` 设置为 `items` 中所有项的 `(price * quantity)` 的总和。请勿包含 `shipping` 或 `tax`。 * 为了生成有意义的报告，通常必须提供 `value`。如果您将事件标记为关键事件，则建议您设置 `value`。 * 如果设置 `value`，则必须提供 `currency`。
`coupon`	`string`	否	SUMMER_FUN	与事件相关的优惠券名称/代码。事件级和商品级 `coupon` 参数彼此独立。
`payment_type`	`string`	否	信用卡	选定的付款方式。
`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` 参数彼此独立。
`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`	否	10.01	商品的货币单位价格（以指定的 currency 参数为单位）。如果商品适用折扣，请将 `price` 设置为折扣后的单价，并在 `discount` 参数中指定单价折扣。
`quantity`	`number`	否	3	商品数量。如果未设置，`quantity` 将设置为 1。

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：add_payment_info
数据层变量（名称 - 数据层变量名称）：

电子商务商品 - ecommerce.items
电子商务价值 - ecommerce.value
电子商务币种 - ecommerce.currency
电子商务优惠券 - ecommerce.coupon
电子商务付款方式 - ecommerce.payment_type

事件参数（参数名称 - 值）：

items - {{Ecommerce Items}}
value - {{Ecommerce Value}}
currency - {{Ecommerce Currency}}
coupon - {{Ecommerce Coupon}}
payment_type - {{Ecommerce Payment Type}}

触发器：event 为 add_payment_info

触发器配置：

触发器类型：自定义事件
事件名称：add_payment_info
此触发器的触发条件：所有自定义事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_payment_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    payment_type: "Credit Card",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

`add_shipping_info`

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

参数

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

Item 参数

名称	类型	是否必须提供	示例值	说明
`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` 参数彼此独立。
`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`	否	10.01	商品的货币单位价格（以指定的 currency 参数为单位）。如果商品适用折扣，请将 `price` 设置为折扣后的单价，并在 `discount` 参数中指定单价折扣。
`quantity`	`number`	否	3	商品数量。如果未设置，`quantity` 将设置为 1。

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：add_shipping_info
数据层变量（名称 - 数据层变量名称）：

电子商务商品 - ecommerce.items
电子商务价值 - ecommerce.value
电子商务币种 - ecommerce.currency
电子商务优惠券 - ecommerce.coupon
电子商务配送级别 - ecommerce.shipping_tier

事件参数（参数名称 - 值）：

items - {{Ecommerce Items}}
value - {{Ecommerce Value}}
currency - {{Ecommerce Currency}}
coupon - {{Ecommerce Coupon}}
shipping_tier - {{Ecommerce Shipping Tier}}

触发器：event 为 add_shipping_info

触发器配置：

触发器类型：自定义事件
事件名称：add_shipping_info
此触发器的触发条件：所有自定义事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_shipping_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping_tier: "Ground",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

`add_to_cart`

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

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 `view_item` 事件中不计入收入的价值指标 * 如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`value`	`number`	是*	30.03	与事件相关的货币价值。 * 将 `value` 设置为 `items` 中所有项的 `(price * quantity)` 的总和。请勿包含 `shipping` 或 `tax`。 * 为了生成有意义的报告，通常必须提供 `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` 参数彼此独立。
`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`	否	10.01	商品的货币单位价格（以指定的 currency 参数为单位）。如果商品适用折扣，请将 `price` 设置为折扣后的单价，并在 `discount` 参数中指定单价折扣。
`quantity`	`number`	否	3	商品数量。如果未设置，`quantity` 将设置为 1。

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：add_to_cart
数据层变量（名称 - 数据层变量名称）：

电子商务商品 - ecommerce.items
电子商务价值 - ecommerce.value
电子商务币种 - ecommerce.currency

事件参数（参数名称 - 值）：

items - {{Ecommerce Items}}
value - {{Ecommerce Value}}
currency - {{Ecommerce Currency}}

触发器：event 为 add_to_cart

触发器配置：

触发器类型：自定义事件
事件名称：add_to_cart
此触发器的触发条件：所有自定义事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

`add_to_wishlist`

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

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 `view_item` 事件中不计入收入的价值指标 * 如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`value`	`number`	是*	30.03	与事件相关的货币价值。 * 将 `value` 设置为 `items` 中所有项的 `(price * quantity)` 的总和。请勿包含 `shipping` 或 `tax`。 * 为了生成有意义的报告，通常必须提供 `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` 参数彼此独立。
`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`	否	10.01	商品的货币单位价格（以指定的 currency 参数为单位）。如果商品适用折扣，请将 `price` 设置为折扣后的单价，并在 `discount` 参数中指定单价折扣。
`quantity`	`number`	否	3	商品数量。如果未设置，`quantity` 将设置为 1。

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：add_to_wishlist
数据层变量（名称 - 数据层变量名称）：

电子商务商品 - ecommerce.items
电子商务价值 - ecommerce.value
电子商务币种 - ecommerce.currency

事件参数（参数名称 - 值）：

items - {{Ecommerce Items}}
value - {{Ecommerce Value}}
currency - {{Ecommerce Currency}}

触发器：event 为 add_to_wishlist

触发器配置：

触发器类型：自定义事件
事件名称：add_to_wishlist
此触发器的触发条件：所有自定义事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_wishlist",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

`begin_checkout`

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

参数

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

Item 参数

名称	类型	是否必须提供	示例值	说明
`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` 参数彼此独立。
`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`	否	10.01	商品的货币单位价格（以指定的 currency 参数为单位）。如果商品适用折扣，请将 `price` 设置为折扣后的单价，并在 `discount` 参数中指定单价折扣。
`quantity`	`number`	否	3	商品数量。如果未设置，`quantity` 将设置为 1。

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：begin_checkout
数据层变量（名称 - 数据层变量名称）：

电子商务商品 - ecommerce.items
电子商务价值 - ecommerce.value
电子商务币种 - ecommerce.currency
电子商务优惠券 - ecommerce.coupon

事件参数（参数名称 - 值）：

items - {{Ecommerce Items}}
value - {{Ecommerce Value}}
currency - {{Ecommerce Currency}}
coupon - {{Ecommerce Coupon}}

触发器：event 为 begin_checkout

触发器配置：

触发器类型：自定义事件
事件名称：begin_checkout
此触发器的触发条件：所有自定义事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "begin_checkout",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

`close_convert_lead`

此事件将衡量潜在客户何时转化并完成（例如，通过购买）。

参数

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：close_convert_lead
事件参数（参数名称 - 值）：

currency - 美元
value - 30.03

在用户成为已转化的潜在客户（客户）时触发该事件

`close_unconvert_lead`

此事件用于衡量用户何时被标记为未转化为潜在客户，以及原因。

参数

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：close_unconvert_lead
事件参数（参数名称 - 值）：

currency - 美元
value - 30.03

当用户因多种原因被标记为未成为转化的潜在客户时触发该事件

`disqualify_lead`

此事件用于衡量用户被标记为不符合成为潜在客户的条件的时间，以及被标记为不符合条件的原因。

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	美元	事件的 `value` 所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 * 如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`value`	`number`	是*	30.03	与事件相关的货币价值。为了生成有意义的报告，通常必须提供 `value`。如果您将事件标记为关键事件，则建议您设置 `value`。如果设置 `value`，则必须提供 `currency`。
`disqualified_lead_reason`	`string`	否	不想购买	潜在客户被标记为不符合条件的原因。

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：disqualify_lead
事件参数（参数名称 - 值）：

currency - 美元
value - 30.03
disqualified_lead_reason - 不考虑购买

当用户因多种原因之一而被标记为不符合成为潜在客户的条件时触发该事件

`earn_virtual_currency`

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

参数

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：earn_virtual_currency
事件参数（参数名称 - 值）：

virtual_currency_name - Gem
value - 5

在用户获得虚拟货币奖励时触发该事件

`generate_lead`

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

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	美元	事件的 `value` 所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 * 如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`value`	`number`	是*	30.03	与事件相关的货币价值。为了生成有意义的报告，通常必须提供 `value`。如果您将事件标记为关键事件，则建议您设置 `value`。如果设置 `value`，则必须提供 `currency`。
`lead_source`	`string`	否	贸易展览	潜在客户的来源。

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：generate_lead
事件参数（参数名称 - 值）：

currency - 美元
value - 30.03
lead_source - 贸易展览

在发掘到潜在客户时触发该事件

`join_group`

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

参数

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：join_group
事件参数（参数名称 - 值）：

group_id - G_12345

在用户加入群组时触发该事件

`level_end`

此事件表示玩家完成了游戏中的某个关卡。

参数

名称	类型	是否必须提供	示例值	说明
`level_name`	`string`	否	踏上征途…	关卡的名称。
`success`	`boolean`	否	true	如果成功通关，则设为 `true`。

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：level_end
事件参数（参数名称 - 值）：

level_name - 踏上征途…
success - true

在玩家完成某个关卡（如看到关卡确认页）时触发

`level_start`

此事件表示玩家开启了游戏中的某个关卡。

参数

名称	类型	是否必须提供	示例值	说明
`level_name`	`string`	否	踏上征途…	关卡的名称。

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：level_start
事件参数（参数名称 - 值）：

level_name - 踏上征途…

在用户开始新关卡（如看到关卡初始页）时触发

`level_up`

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

参数

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：level_up
事件参数（参数名称 - 值）：

level - 5
character - 玩家 1

在玩家升级时触发

`login`

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

参数

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

示例

`post_score`

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

参数

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：post_score
事件参数（参数名称 - 值）：

score - 10000
level - 5
character - 玩家 1

在用户发布得分时触发

`purchase`

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

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 `view_item` 事件中不计入收入的价值指标 * 如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`value`	`number`	是*	30.03	与事件相关的货币价值。 * 将 `value` 设置为 `items` 中所有项的 `(price * quantity)` 的总和。请勿包含 `shipping` 或 `tax`。 * 为了生成有意义的报告，通常必须提供 `value`。如果您将事件标记为关键事件，则建议您设置 `value`。 * 如果设置 `value`，则必须提供 `currency`。
`transaction_id`	`string`	是	T_12345	交易的唯一标识符。 `transaction_id` 参数有助于避免出现重复的购买事件。
`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` 参数彼此独立。
`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`	否	10.01	商品的货币单位价格（以指定的 currency 参数为单位）。如果商品适用折扣，请将 `price` 设置为折扣后的单价，并在 `discount` 参数中指定单价折扣。
`quantity`	`number`	否	3	商品数量。如果未设置，`quantity` 将设置为 1。

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：purchase

电子商务商品 - ecommerce.items
电子商务交易 ID - ecommerce.transaction_id
电子商务价值 - ecommerce.value
电子商务税费 - ecommerce.tax
电子商务运费 - ecommerce.shipping
电子商务币种 - ecommerce.currency
电子商务优惠券 - ecommerce.coupon

事件参数（参数名称 - 值）：

items - {{Ecommerce Items}}
transaction_id - {{Ecommerce Transaction ID}}
value - {{Ecommerce Value}}
tax - {{Ecommerce Tax}}
shipping - {{Ecommerce Shipping}}
currency - {{Ecommerce Currency}}
coupon - {{Ecommerce Coupon}}

触发器：event 为 purchase

触发器配置：

触发器类型：自定义事件
事件名称：purchase
此触发器的触发条件：所有自定义事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "purchase",
  ecommerce: {
    transaction_id: "T_12345",
    // Sum of (price * quantity) for all items.
    value: 72.05,
    tax: 3.60,
    shipping: 5.99,
    currency: "USD",
    coupon: "SUMMER_SALE",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

`qualify_lead`

此事件用于衡量用户何时被标记为符合成为符合条件的潜在客户的条件。

参数

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：qualify_lead
事件参数（参数名称 - 值）：

currency - 美元
value - 30.03

在用户被标记为符合成为符合条件的潜在客户的条件时触发事件

`refund`

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

参数

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

Item 参数

名称	类型	是否必须提供	示例值	说明
`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` 参数彼此独立。
`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`	否	10.01	商品的货币单位价格（以指定的 currency 参数为单位）。如果商品适用折扣，请将 `price` 设置为折扣后的单价，并在 `discount` 参数中指定单价折扣。
`quantity`	`number`	否	3	商品数量。如果未设置，`quantity` 将设置为 1。

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：refund
数据层变量（名称 - 数据层变量名称）：

电子商务商品 - ecommerce.items
电子商务交易 ID - ecommerce.transaction_id
电子商务价值 - ecommerce.value
电子商务税费 - ecommerce.tax
电子商务运费 - ecommerce.shipping
电子商务币种 - ecommerce.currency
电子商务优惠券 - ecommerce.coupon

事件参数（参数名称 - 值）：

items - {{Ecommerce Items}}
transaction_id - {{Ecommerce Transaction ID}}
value - {{Ecommerce Value}}
tax - {{Ecommerce Tax}}
shipping - {{Ecommerce Shipping}}
currency - {{Ecommerce Currency}}
coupon - {{Ecommerce Coupon}}

触发器：event 为 refund

触发器配置：

触发器类型：自定义事件
事件名称：refund
此触发器的触发条件：所有自定义事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "refund",
  ecommerce: {
    currency: "USD",
    transaction_id: "T_12345", // Transaction ID. Required for purchases and refunds.
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping: 3.33,
    tax: 1.11,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

`remove_from_cart`

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

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 `view_item` 事件中不计入收入的价值指标 * 如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`value`	`number`	是*	30.03	与事件相关的货币价值。 * 将 `value` 设置为 `items` 中所有项的 `(price * quantity)` 的总和。请勿包含 `shipping` 或 `tax`。 * 为了生成有意义的报告，通常必须提供 `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` 参数彼此独立。
`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`	否	10.01	商品的货币单位价格（以指定的 currency 参数为单位）。如果商品适用折扣，请将 `price` 设置为折扣后的单价，并在 `discount` 参数中指定单价折扣。
`quantity`	`number`	否	3	商品数量。如果未设置，`quantity` 将设置为 1。

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：remove_from_cart
数据层变量（名称 - 数据层变量名称）：

电子商务商品 - ecommerce.items
电子商务价值 - ecommerce.value
电子商务币种 - ecommerce.currency

事件参数（参数名称 - 值）：

items - {{Ecommerce Items}}
value - {{Ecommerce Value}}
currency - {{Ecommerce Currency}}

触发器：event 为 remove_from_cart

触发器配置：

触发器类型：自定义事件
事件名称：remove_from_cart
此触发器的触发条件：所有自定义事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "remove_from_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

`search`

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

参数

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

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：search
事件参数（参数名称 - 值）：

search_term - T 恤

当用户在您的网站上进行搜索时触发

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：search
事件参数（参数名称 - 值）：

search_term - T 恤

当用户在您的网站上进行搜索时触发

`select_content`

此事件表示用户选择了某个类型的某些内容。此事件有助于您了解您网站或应用中的热门内容和内容类别。

参数

名称	类型	是否必须提供	示例值	说明
`content_type`	`string`	否	产品	所选内容的类型。
`content_id`	`string`	否	C_12345	所选内容的标识符。

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：select_content
事件参数（参数名称 - 值）：

content_type - 商品
content_id - C_12345

触发器：event 为 select_content

`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` 参数彼此独立。
`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`	否	10.01	商品的货币单位价格（以指定的 currency 参数为单位）。如果商品适用折扣，请将 `price` 设置为折扣后的单价，并在 `discount` 参数中指定单价折扣。
`quantity`	`number`	否	3	商品数量。如果未设置，`quantity` 将设置为 1。

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：select_item
数据层变量（名称 - 数据层变量名称）：

电子商务商品 - ecommerce.items
电子商务商品列表 ID - ecommerce.item_list_id
电子商务商品列表名称 - ecommerce.item_list_name

事件参数（参数名称 - 值）：

items - {{Ecommerce Items}}
item_list_id - {{Ecommerce Item List ID}}
item_list_name - {{Ecommerce Item List Name}}

触发器：event 为 select_item

触发器配置：

触发器类型：自定义事件
事件名称：select_item
此触发器的触发条件：所有自定义事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_item",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

`select_promotion`

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

参数

名称	类型	是否必须提供	示例值	说明
`creative_name`	`string`	否	summer_banner2	促销广告素材的名称。如果在商品级别进行设置，系统会忽略此参数。
`creative_slot`	`string`	否	featured_app_1	与事件相关的促销广告素材投放到的广告位的名称。如果在商品级别进行设置，系统会忽略此参数。
`promotion_id`	`string`	否	P_12345	与事件相关的促销活动的 ID。如果在商品级别进行设置，系统会忽略此参数。
`promotion_name`	`string`	否	夏季促销	与事件相关的促销活动的名称。如果在商品级别进行设置，系统会忽略此参数。
`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`	否	10.01	商品的货币单位价格（以指定的 currency 参数为单位）。如果商品适用折扣，请将 `price` 设置为折扣后的单价，并在 `discount` 参数中指定单价折扣。
`promotion_id`	`string`	否	P_12345	与商品相关的促销活动的 ID。如果设置此参数，系统会忽略事件级 `promotion_id`。如果未设置此参数，系统会使用事件级 `promotion_id`（如果存在）。
`promotion_name`	`string`	否	夏季促销	与商品相关的促销活动的名称。如果设置此参数，系统会忽略事件级 `promotion_name`。如果未设置此参数，系统会使用事件级 `promotion_name`（如果存在）。
`quantity`	`number`	否	3	商品数量。如果未设置，`quantity` 将设置为 1。

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
数据层变量（名称 - 数据层变量名称）：

电子商务广告素材名称 - ecommerce.creative_name
电子商务广告素材位置 - ecommerce.creative_slot
电子商务促销 ID - ecommerce.promotion_id
电子商务促销名称 - ecommerce.promotion_name
电子商务商品 - ecommerce.items

事件参数（参数名称 - 值）：

creative_name - {{Ecommerce Creative Name}}
creative_slot - {{Ecommerce Creative Slot}}
promotion_id - {{Ecommerce Promotion ID}}
promotion_name - {{Ecommerce Promotion Name}}
items - {{Ecommerce Items}}

变量类型：数据层变量 - 'ecommerce.items'
触发器：event 为 select_promotion

触发器配置：

触发器类型：自定义事件
事件名称：select_promotion
此触发器的触发条件：所有自定义事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_promotion",
  ecommerce: {
    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",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

`share`

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

参数

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

以下示例适用于跟踪代码管理器实现：

示例

`sign_up`

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

参数

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

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：sign_up
事件参数（参数名称 - 值）：

method - Google

在用户注册账号时触发

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：sign_up
事件参数（参数名称 - 值）：

method - Google

在用户注册账号时触发

`spend_virtual_currency`

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

参数

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：spend_virtual_currency
事件参数（参数名称 - 值）：

value - 5
virtual_currency_name - Gem
item_name - 启动积分加倍活动

在用户购买虚拟商品时触发

`tutorial_begin`

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

参数

此事件没有任何参数。

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：tutorial_begin
在用户开始新手入门流程时触发

`tutorial_complete`

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

参数

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：tutorial_complete
在用户完成新手入门流程时触发

`unlock_achievement`

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

参数

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：unlock_achievement
事件参数（参数名称 - 值）：

achievement_id - A_12345

在用户解锁成就时触发

`view_cart`

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

参数

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

Item 参数

名称	类型	是否必须提供	示例值	说明
`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` 参数彼此独立。
`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`	否	10.01	商品的货币单位价格（以指定的 currency 参数为单位）。如果商品适用折扣，请将 `price` 设置为折扣后的单价，并在 `discount` 参数中指定单价折扣。
`quantity`	`number`	否	3	商品数量。如果未设置，`quantity` 将设置为 1。

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：view_cart
数据层变量（名称 - 数据层变量名称）：

电子商务商品 - ecommerce.items
电子商务价值 - ecommerce.value
电子商务币种 - ecommerce.currency

事件参数（参数名称 - 值）：

items - {{Ecommerce Items}}
value - {{Ecommerce Value}}
currency - {{Ecommerce Currency}}

触发器：event 为 view_cart

触发器配置：

触发器类型：自定义事件
事件名称：view_cart
此触发器的触发条件：所有自定义事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

`view_item`

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

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 `view_item` 事件中不计入收入的价值指标 * 如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`value`	`number`	是*	30.03	与事件相关的货币价值。 * 将 `value` 设置为 `items` 中所有项的 `(price * quantity)` 的总和。请勿包含 `shipping` 或 `tax`。 * 为了生成有意义的报告，通常必须提供 `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` 参数彼此独立。
`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`	否	10.01	商品的货币单位价格（以指定的 currency 参数为单位）。如果商品适用折扣，请将 `price` 设置为折扣后的单价，并在 `discount` 参数中指定单价折扣。
`quantity`	`number`	否	3	商品数量。如果未设置，`quantity` 将设置为 1。

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：view_item
数据层变量（名称 - 数据层变量名称）：

电子商务商品 - ecommerce.items
电子商务价值 - ecommerce.value
电子商务币种 - ecommerce.currency

事件参数（参数名称 - 值）：

items - {{Ecommerce Items}}
value - {{Ecommerce Value}}
currency - {{Ecommerce Currency}}

触发器：event 为 view_item

触发器配置：

触发器类型：自定义事件
事件名称：view_item
此触发器的触发条件：所有自定义事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

`view_item_list`

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

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 `view_item` 事件中不计入收入的价值指标 * 如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`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` 参数彼此独立。
`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`	否	10.01	商品的货币单位价格（以指定的 currency 参数为单位）。如果商品适用折扣，请将 `price` 设置为折扣后的单价，并在 `discount` 参数中指定单价折扣。
`quantity`	`number`	否	3	商品数量。如果未设置，`quantity` 将设置为 1。

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：view_item_list
数据层变量（名称 - 数据层变量名称）：

电子商务商品 - ecommerce.items
电子商务商品列表 ID - ecommerce.item_list_id
电子商务商品列表名称 - ecommerce.item_list_name

事件参数（参数名称 - 值）：

items - {{Ecommerce Items}}
item_list_id - {{Ecommerce Item List ID}}
item_list_name - {{Ecommerce Item List Name}}

触发器：event 为 view_item_list

触发器配置：

触发器类型：自定义事件
事件名称：view_item_list
此触发器的触发条件：所有自定义事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item_list",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
     {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.03,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

`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`	否	10.01	商品的货币单位价格（以指定的 currency 参数为单位）。如果商品适用折扣，请将 `price` 设置为折扣后的单价，并在 `discount` 参数中指定单价折扣。
`promotion_id`	`string`	否	P_12345	与商品相关的促销活动的 ID。如果设置此参数，系统会忽略事件级 `promotion_id`。如果未设置此参数，系统会使用事件级 `promotion_id`（如果存在）。
`promotion_name`	`string`	否	夏季促销	与商品相关的促销活动的名称。如果设置此参数，系统会忽略事件级 `promotion_name`。如果未设置此参数，系统会使用事件级 `promotion_name`（如果存在）。
`quantity`	`number`	否	3	商品数量。如果未设置，`quantity` 将设置为 1。

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

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：view_promotion
数据层变量（名称 - 数据层变量名称）：

电子商务广告素材名称 - ecommerce.creative_name
电子商务广告素材位置 - ecommerce.creative_slot
电子商务促销 ID - ecommerce.promotion_id
电子商务促销名称 - ecommerce.promotion_name
电子商务商品 - ecommerce.items

事件参数（参数名称 - 值）：

creative_name - {{Ecommerce Creative Name}}
creative_slot - {{Ecommerce Creative Slot}}
promotion_id - {{Ecommerce Promotion ID}}
promotion_name - {{Ecommerce Promotion Name}}
items - {{Ecommerce Items}}

触发器：event 为 view_promotion

触发器配置：

触发器类型：自定义事件
事件名称：view_promotion
此触发器的触发条件：所有自定义事件

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_promotion",
  ecommerce: {
    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",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

`working_lead`

此事件衡量的是用户与代表联系或代表与用户联系的时间。

参数

名称	类型	是否必须提供	示例值	说明
`currency`	`string`	是*	美元	事件的 `value` 所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 * 如果设置 `value`，则必须提供 `currency`，这样才能准确计算收入指标。
`value`	`number`	是*	30.03	与事件相关的货币价值。为了生成有意义的报告，通常必须提供 `value`。如果您将事件标记为关键事件，则建议您设置 `value`。如果设置 `value`，则必须提供 `currency`。
`lead_status`	`string`	否	发起的对话	潜在客户的状态。

示例

以下示例适用于跟踪代码管理器实现：

显示代码配置

代码配置：

代码类型：GA4 事件
事件名称：working_lead
事件参数（参数名称 - 值）：

currency - 美元
value - 30.03
lead_status - 发起的对话

在用户与代表联系或代表与用户联系时触发事件