衡量电子商务

您可以设置电子商务事件来收集有关用户购物行为的信息。借助这些事件，您不仅能够量化最热门的产品，还能了解促销活动和产品展示位置对收入的影响。

本文介绍了各个电子商务事件以及何时设置相应事件。如需获取有关如何设置电子商务事件的分步示例，请参阅设置购买事件。

能占用您 3 分钟的时间吗？烦请填写简短的在线调查问卷，帮助我们改进 GA4 电子商务文档。

Google 代码 跟踪代码管理器

准备工作

向网站添加 GA4 配置代码

确保您已将“Google Analytics（分析）：GA4 配置”代码添加到您的网站，并且可以使用 Google Analytics（分析）和网站源代码。

使用 GA4 事件代码衡量电子商务事件

要向 GA4 媒体资源发送电子商务事件和参数，请执行以下操作：

1. 打开 Google 跟踪代码管理器
2. 在您的工作区中，打开代码菜单。
3. 创建一个新代码。点击代码配置框，然后选择 Google Analytics（分析）：GA4 事件代码。
4. 对于事件名称，使用内置变量 {{Event}}。这将使用通过 gtag.js API 发送的 GA4 电子商务事件名称。
5. 在更多设置 > 电子商务下，选中发送电子商务数据。
6. 对于数据源，选择数据层。
7. 针对 GA4 事件设置触发器，例如当用户点击结账按钮时。查看所有可用的触发器类型。
8. 为代码命名并保存。

建议

• 启用调试模式，以便实时查看事件以及更轻松地排查问题
• 如果要随电子商务事件发送自定义参数，请参阅自定义维度和指标限制
• 在发送 value（收入）数据时设置 currency，以确保正确计算收入指标
• 对您拥有相关数据的所有电子商务参数进行设置，无论相应参数是否为可选参数都是如此
• 请参考示例电子商务网站，通过示例了解如何为网站添加代码

实现

典型的电子商务实现可衡量以下所有操作：

• 从列表中选择商品
• 查看商品详情
• 向购物车添加商品/从购物车移除商品
• 启动结账流程
• 购买或退款
• 使用促销优惠

这些操作的核心是您所销售的产品和服务。您可以用可添加到电子商务事件的 items 数组来代表产品和服务。除了预设参数外，您还可以在 items 数组中添加最多 27 个自定义参数。

以下示例演示了如何创建本指南中引用的 items 集合。items 数组最多可包含 200 个元素。

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: 9.99,
      quantity: 1
    },
    {
      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: 20.99,
      quantity: 1
    }
]

从 UA 电子商务实现迁移

如果您已经针对 Universal Analytics 实现了电子商务，可以采用以下任一方式来迁移到 Google Analytics（分析）4：

• 使用 UA 电子商务实现填充 GA4 电子商务事件
• 用 GA4 电子商务事件替代 UA 电子商务实现

如需了解如何将电子商务实现从 Universal Analytics 转换为 Google Analytics（分析）4，请参阅适用于 Google 跟踪代码管理器的 GA4 电子商务迁移指南。

清除电子商务对象

建议您先使用以下命令清除电子商务对象，然后再将电子商务事件推送到数据层。清除该对象有助于防止网页上的多个电子商务事件相互影响。

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.

从列表中选择商品

当用户看到结果列表时，发送 view_item_list 事件，并加入包含所显示商品的 items 数组参数。如需详细了解要发送的参数，请参阅事件参考文档。

注意：发送电子商务数据选项可以用作以下标签配置的替代方案。

显示代码配置

代码配置：

• 代码类型：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: 9.99,
      quantity: 1
    },
    {
      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: 20.99,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 1
    }]
  }
});

当用户从列表中选择商品时，发送 select_item 事件，并在 items 数组参数中指定所选商品。如需详细了解要发送的参数，请参阅事件参考文档。

注意：发送电子商务数据选项可以用作以下标签配置的替代方案。

显示代码配置

代码配置：

• 代码类型：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: 9.99,
      quantity: 1
    }
    ]
  }
});

查看商品详情

要衡量商品详情的查看次数，请在每次用户查看商品详情页面时发送 view_item 事件。如需详细了解要发送的参数，请参阅事件参考文档。

注意：发送电子商务数据选项可以用作以下标签配置的替代方案。

显示代码配置

代码配置：

• 代码类型：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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

向购物车添加商品/从购物车移除商品

通过发送 add_to_cart 事件并在 items 数组中指定相关商品，衡量用户向购物车添加商品的情况。如需详细了解要发送的参数，请参阅事件参考文档。

注意：发送电子商务数据选项可以用作以下标签配置的替代方案。

显示代码配置

代码配置：

• 代码类型：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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

此外，您还可以通过发送 add_to_wishlist 事件并在 items 数组中指定相关商品，衡量用户将商品添加到心愿单的情况。如需详细了解要发送的参数，请参阅事件参考文档。

注意：发送电子商务数据选项可以用作以下标签配置的替代方案。

显示代码配置

代码配置：

• 代码类型：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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

如果用户随后查看购物车，则发送 view_cart 事件并在其中包含购物车中的所有商品。如需详细了解要发送的参数，请参阅事件参考文档。

注意：发送电子商务数据选项可以用作以下标签配置的替代方案。

显示代码配置

代码配置：

• 代码类型：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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

要衡量用户从购物车中移除商品的情况，可发送 remove_from_cart 事件。如需详细了解要发送的参数，请参阅事件参考文档。

注意：发送电子商务数据选项可以用作以下标签配置的替代方案。

显示代码配置

代码配置：

• 代码类型：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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

启动结账流程

通过发送 begin_checkout 事件并通过相关字段指定一件或多件商品，衡量用户开始结账流程第一步的情况。您还可以在此阶段为整个订单添加优惠券（通过将优惠券添加到该事件中），或为特定商品应用优惠券（通过将优惠券添加到 items 数组中的特定元素）。如需详细了解要发送的参数，请参阅事件参考文档。

注意：发送电子商务数据选项可以用作以下标签配置的替代方案。

显示代码配置

代码配置：

• 代码类型：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: 7.77,
    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: 9.99,
      quantity: 1
    }
    ]
  }
});

当用户继续执行结账流程的下一步并添加配送信息时，发送 add_shipping_info 事件。使用参数 shipping_tier 指定用户的送货选项，例如“Ground”“Air”或“Next-day”。如需详细了解要发送的参数，请参阅事件参考文档。

注意：发送电子商务数据选项可以用作以下标签配置的替代方案。

显示代码配置

代码配置：

• 代码类型：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: 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",
      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_payment_info 事件。如果可以，应在此事件中添加 payment_type 以表示用户所选的付款方式。如需详细了解要发送的参数，请参阅事件参考文档。

注意：发送电子商务数据选项可以用作以下标签配置的替代方案。

显示代码配置

代码配置：

• 代码类型：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: 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",
      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
    }
    ]
  }
});

购买或退款

通过发送 purchase 事件并通过相关字段指定一件或多件商品，衡量购买情况。如需详细了解要发送的参数，请参阅事件参考文档。

注意：发送电子商务数据选项可以用作以下标签配置的替代方案。

显示代码配置

代码配置：

• 代码类型：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",
      value: 25.42,
      tax: 4.90,
      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: 9.99,
        quantity: 1
      },
      {
        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: 20.99,
        promotion_id: "P_12345",
        promotion_name: "Summer Sale",
        quantity: 1
      }]
  }
});

注意：purchase 事件取代了 ecommerce_purchase，并且与 in_app_purchase 事件不同，后者会自动报告。

通过发送 refund 事件并指定相关 transaction_id 且通过 item_id 和 quantity 指定一件或多件商品，衡量退款情况。我们建议您在 refund 事件中添加商品信息，以便在 Google Analytics（分析）中查看商品级退款指标。

如需详细了解要发送的参数，请参阅事件参考文档。

注意：发送电子商务数据选项可以用作以下标签配置的替代方案。

显示代码配置

代码配置：

• 代码类型：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: 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",
      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 事件取代了 ecommerce_refund。

使用促销优惠

电子商务功能支持对内部促销信息（例如用于宣传促销活动的横幅）的展示和点击情况进行衡量。

促销信息的展示情况通常通过初始屏幕浏览进行衡量，方法是发送 view_promotion 事件并使用 items 参数来指定促销商品。如需详细了解要发送的参数，请参阅事件参考文档。

注意：发送电子商务数据选项可以用作以下标签配置的替代方案。

显示代码配置

代码配置：

• 代码类型：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: 9.99,
      quantity: 1
    }
    ]
  }
});

为了指明用户点击了促销信息，请发送 select_promotion 事件并在 items 参数中指定相应商品。如需详细了解要发送的参数，请参阅事件参考文档。

注意：发送电子商务数据选项可以用作以下标签配置的替代方案。

显示代码配置

代码配置：

• 代码类型：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: 9.99,
      quantity: 1
    }
    ]
  }
});

使用自定义 JavaScript 变量

如果您的网站不支持数据层，则可以使用自定义 JavaScript 变量来调用会返回电子商务数据对象的函数。此对象应使用本指南前面部分介绍的数据层语法，例如：

// A Custom JavaScript Variable that returns an ecommerceData object
// that follows the data layer syntax.
function getEcommerceData() {
  var ecommerceProductData = [
    {
      item_name: "Stan and Friends Tee",
      item_id: "SKU_12345",  // ID is required.
      // Rest of the product data should follow the data layer syntax.
    },
    // Multiple products may be included.
  ];
  return ecommerceProductData;
}

如果您选择使用自定义 JavaScript 变量，则其使用方法与数据层相同，您可以提供 'items' 参数中的值作为代码配置中的事件参数。

代码配置：

• 代码类型：GA4 事件
• 事件名称：any
• 从以下变量中读取数据：{{gaEcommerceData}}
• 触发器：event 为 gtm.dom

gaEcommerceData 变量设置

• 变量类型：自定义 JavaScript
• 函数本体：请使用上文中的示例

注意：示例代码配置使用 DOM 已准备就绪 (gtm.dom) 来触发 Google Analytics（分析）4 事件代码。如果您想要在发送事件之前在某个网页上加载所有元素，则应使用“DOM 已准备就绪”，以便从文档对象模型 (DOM) 中检索值。例如，您应针对 view_item_list 事件使用“DOM 已准备就绪”，这样用户查看的商品便会在发送事件之前加载。