详解Google Tag Manager布署GA4电商跟踪指南

更新时间：2025年2月11号

本文介绍如何通过 Google Tag Manager（GTM） 布署GA4电商跟踪，覆盖产品展示、点击、购物车、结算和支付全生命周期。

GA4电商布署方式

根据网站类型和安装方式，GA4电商布署主要有三种：

• SAAS系统插件：适合无源码权限的建站平台，只能通过系统插件实现
• gtag方式布署：如果没有使用GTM安装GA4，直接布署GA4的方式，可以参考：Google Analytics 4布署电子商务（gtag方法）
• GTM布署方式（推荐）：如果使用GTM安装GA4，本篇重点介绍此方法

如果你的情形是前两者，那么这篇文章不适合你。

GA4电商事件概览

GA4电商事件覆盖了产品展示 →用户浏览 →点击→查看→ 选择 → 加入购物车 → 结账 → 支付 → 退款 的整个生命周期。

每一步（也称为事件），都需要前端通过dataLayer去发送特定结构的数据，然后再GTM里配置将数据发送到GA4。

下面以为view_item_list作为例子讲解前端的发送时机，数据结构和GTM配置过程。

示例：view_item_list布署

view_item_list是产品展示的意思，页面打开，产品展示出来，前端就发送。

dataLayer 页面发送示例

前端通过dataLayer发送如下数据结构：

// Measure product views / impressions
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item_list",
  ecommerce: {
    items: [
     {
       item_name: "Triblend Android T-Shirt",       // Name or ID is required.
       item_id: "12345",
       price: 15.25,
       item_brand: "Google",
       item_category: "Apparel",
       item_category2: "Mens",
       item_category3: "Shirts",
       item_category4: "Tshirts",
       item_variant: "Gray",
       item_list_name: "Search Results",
       item_list_id: "SR123",
       index: 1,
       quantity: 1
     },
     {
       item_name: "Donut Friday Scented T-Shirt",
       item_id: "67890",
       price: 33.75,
       item_brand: "Google",
       item_category: "Apparel",
       item_category2: "Mens",
       item_category3: "Shirts",
       item_category4: "Tshirts",
       item_variant: "Black",
       item_list_name: "Search Results",
       item_list_id: "SR123",
       index: 2,
       quantity: 1
     }]
  }
});

items表示产品，里面可以包含多个产品，建议是一次发送多个产品，不要每个产品单独发送。

items参数解析

items里有很多的参数，详细如下：

这一步有几个注意点：

• dataLayer.push({ ecommerce: null })是用于清除对象，清除该对象有助于防止网页上的多个电子商务事件相互影响，如果你的电商数据发送很多很频繁，建议使用。
• GA4里的items里是产品数组，所有的产品信息都在里面
• item里面的item_id和item_name是必须字段，其他都是可选。
• 产品不同位置是通过item_list_id和item_list_name去区分，一般是必须参数，才可以知道展示的位置

GTM配置流程

接下来讲解GTM里面如何配置，首先看触发器：

设置触发器

将dataLayer里面的event设置为触发器，在GTM中点击「触发器」——「新建」——「选择一个触发器类型以开始设置…」——「自定义事件」，命名为view_item_list，然后做如下配置：

dataLayer里event的值是什么，这里的事件名称就填什么。

设置代码

最后就是在GTM中配置代码，在GTM中点击「代码」——「新建」——「选择一个代码类型以开始设置…」——「Google Analytics（分析）：GA4 事件」，命名为view_item_list，然后做如下配置：

整站布署电商示例配置

产品展示与点击

view_item_list ：产品展示

注意：item_list_name 或 item_list_id 的值必须保持稳定。对于给定列表，这些值应始终相同，它是用于产品归因，它也可以位于item外面。

在Google Analytics 4电商里item_id和item_name是必要字段，其他是可选字段。

view_item：查看产品

select_item：点击产品

促销产品展示

• view_promotion：展示促销产品
• select_promotion：点击促销产品

可以用于跟踪站内活动归因，可以知道加车，结算，订单来自哪个站内活动，但GA4报告上该功能在还没完全实现。

view_promotion：展示促销产品

select_promotion：点击促销产品

购物车

• add_to_cart：将产品添加到购物车
• remove_from_cart：将产品从购物车移除

购物车中currency和value是必须字段。

add_to_cart：将产品添加到购物车

remove_from_cart：将产品从购物车移除

结算流程

• begin_checkout：开始结算
• add_payment_info：添加支付信息
• add_shipping_info：添加地址信息
• purchase：购买成功
• refund：退款

currency和value是必须字段，就value的时候一定要设置currency，购买成功和退款中transaction_id是必须字段。

begin_checkout：开始结算

add_payment_info：添加支付信息

add_shipping_info：添加地址信息

purchase：购买成功

refund：退款

退款分为全额退款和部分退款

全额退款

部分退款

注意点

1. 同个页面有多个电商事件类型的时候，尽量同一次发送出去，也就是一个发送多个产品，如一个页面有5个产品展示，在一个dataLayer.push就发送出去
2. 数据层数据代码中每一个都有dataLayer.push({ ecommerce: null })，这个的作用是清除对象，确保数据不会混乱。
3. GA4目前还不支持类似UA的站内（产品）归因，会导致checkout和purchase划分为no set。
4. 金额不同，如price发送的是35，但报告显示的是35.04，这是因为货币会先换算为美元，再换算为你设置的币种。
5. DebugView里的价格显示错误：如果你用DebugView去调试电商跟踪，那么你可能会看到价格显示一样，实际是250，但显示250000000，这不是bug，这是为了提升数据存储效率与计算性能，GA4在内部会将部分浮点数（如价格、金额）转换为整数形式进行存储与处理，不影响GA4里的数据
6. 事件有数据，但电商里没数据，一般是是数据结构不对导致，如revenue是0，通常是货币类型为空导致，view_item是0，通常是items里的数据结构不对导致

下载GTM电商配置文件

点击下载电商配置文件

具体用法如下：

1. 下载后将其加压，可以看到配置文件是JSON格式，导入方式请看：容器的导出和导入：将GTM配置复制到另一个容器
2. 将变量Measurement ID替换为你实际的

参考资料

• https://developers.google.com/analytics/devguides/collection/ga4/ecommerce