Google Analytics 4 布署电子商务（gtag方法）

更新时间：2025年6月18号

本文介绍如何通过gtag方法布署GA4电商跟踪，如果你是使用GTM，这篇内容不适合你，请看：详解Google Tag Manager布署GA4电商跟踪指南

GA4电商布署方式

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

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

GA4电商事件概览

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

每一步（也称为事件），都需要前端通过gtag去发送特定结构的数据，GA4报告就会有数据。

下面以为view_item_list作为例子讲解前端的发送时机，数据结构。

示例：view_item_list布署

view_item_list是产品展示的意思，页面打开，产品展示出来，前端就通过gtag发送电商数据。

gtag页面发送示例

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

gtag('event', 'view_item_list', {
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    index: 5,
    item_list_name: 'Related Products',
    item_list_id: 'related_products',
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  item_list_name: 'Related products',
  item_list_id: 'related_products'
});

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

items参数解析

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

这一步有几个注意点：

• GA4里的items里是产品数组，所有的产品信息都在里面
• item里面的item_id和item_name是必须字段，其他都是可选。
• 产品不同位置是通过item_list_id和item_list_name去区分，一般是必须参数，才可以知道展示的位置

整站gtag布署电商示例

普通产品

• view_item_list ：产品展示
  
• view_item：查看产品
  
• select_item：点击产品

view_item_list ：产品展示

gtag('event', 'view_item_list', {
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    index: 5,
    item_list_name: 'Related Products',
    item_list_id: 'related_products',
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  item_list_name: 'Related products',
  item_list_id: 'related_products'
});

注意：item_list_name 或 item_list_id 的值必須保持固定。对于给定的列表，这些值始终是相同的。

view_item：查看产品

gtag('event', 'view_item', {
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  value: 9.99
});

select_item：点击产品

gtag('event', 'select_item', {
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    index: 5,
    item_list_name: 'Related Products',
    item_list_id: 'related_products',
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  item_list_name: 'Related products',
  item_list_id: 'related_products'
});

促销产品

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

view_promotion：促销产品展示

gtag('event', 'view_promotion', {
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    promotion_id: 'P_12345',
    promotion_name: 'Summer Sale',
    creative_slot: 'featured_app_1',
    location_id: 'L_12345',
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'Black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  location_id: 'L_12345'
});

select_promotion：点击促销产品

gtag('event', 'select_promotion', {
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    promotion_id: 'P_12345',
    promotion_name: 'Summer Sale',
    creative_name: 'Summer Banner',
    creative_slot: 'featured_app_1',
    location_id: 'L_12345',
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'Black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  location_id: 'L_12345'
});

购物车

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

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

add_to_cart：将产品添加到购物车

gtag('event', 'add_to_cart', {
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  value: 7.77
});

remove_from_cart：将产品从购物车中移除

gtag('event', 'remove_from_cart', {
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  value: 7.77
});

结算流程

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

currency和value是必须字段，购买成功和退款中transaction_id是必须字段。

begin_checkout：开始结算

gtag('event', 'begin_checkout', {
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  value: 7.77
});

add_payment_info：添加支付信息

gtag('event', 'add_payment_info', {
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  payment_type: 'Credit Card',
  value: 9.99
});

add_shipping_info：添加地址信息

gtag('event', 'add_shipping_info', {
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'Black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  shipping_tier: 'Ground',
  value: 7.77
});

purchase：购买成功

gtag('event', 'purchase', {
  affiliation: 'Google Store',
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }, {
    item_id: 'SKU_12346',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'gray',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  transaction_id: 'T_12345',
  shipping: 3.33,
  value: 21.09,
  tax: 2.22
})

refund：退款

退款分为全額退款和部分退款

全额退款

gtag('event', 'refund', {
  affiliation: 'Google Store',
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  transaction_id: 'T_12345',
  shipping: 3.33,
  value: 12.21,
  tax: 1.11
});

部分退款

gtag('event', 'refund', {
  affiliation: 'Google Store',
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD',
    quantity: 1
  }],
  transaction_id: 'T_12345',
  shipping: 3.33,
  value: 12.21,
  tax: 1.11
});

注意点

1. 同个页面有多个电商事件类型的时候，尽量同一次发送出去，也就是一个发送多个产品，如一个页面有5个产品展示，在一个gtag就发送出去
2. 金额不同，如price发送的是35，但报告显示的是35.04，这是因为货币会先换算为美元，再换算为你设置的币种。
3. DebugView里的价格显示错误：如果你用DebugView去调试电商跟踪，那么你可能会看到价格显示一样，实际是250，但显示250000000，这不是bug，这是为了提升数据存储效率与计算性能，GA4在内部会将部分浮点数（如价格、金额）转换为整数形式进行存储与处理，不影响GA4里的数据
4. 事件有数据，但电商里没数据，一般是是数据结构不对导致，如revenue是0，通常是货币类型为空导致，view_item是0，通常是items里的数据结构不对导致