本页介绍了如何使用 gtag.js 收集增强型电子商务数据。如果您使用 gtag.js 配置了 Google Analytics（分析），并且在 Google Analytics（分析）中启用了增强型电子商务功能，则可以使用 gtag.js 将展示数据、产品数据、推广活动数据和操作数据发送给 Google Analytics（分析）。
增强型电子商务数据的类型和操作
您可以发送多种电子商务数据：
展示数据
表示被查看的产品的相关信息。此类数据封装为 impressionFieldObject，其中包含以下值：
| 键 | 值类型 | 是否必须提供 | 说明 |
|---|---|---|---|
id |
text | *是 |
产品 ID 或 SKU（例如 P67890）。
* 对于 |
name |
text | *是 |
产品名称（例如 Android T 恤）。
* 对于 |
list |
text | 否 | 产品所在的列表或集合（例如搜索结果） |
list_name |
text | 否 | 产品所在的列表或集合（例如搜索结果） |
brand |
text | 否 | 与产品关联的品牌（例如 Google）。 |
category |
text | 否 |
产品所属的类别（例如服装）。可以使用 / 作为分隔符来指定最多 5 个层级（例如服装/男装/T 恤）。
|
variant |
text | 否 | 产品的细分款式（例如黑色）。 |
position |
integer | 否 | 产品在列表或集合中的位置（例如 2）。 |
list_position |
integer | 否 | 产品在列表或集合中的位置（例如 2）。 |
price |
number | 否 | 产品的价格（例如 29.20）。 |
产品数据
产品数据表示被查看（或添加到购物车等）的具体产品。此类数据封装为 productFieldObject，其中包含以下值：
| 键 | 值类型 | 是否必须提供 | 说明 |
|---|---|---|---|
id |
text | *是 |
产品 ID 或 SKU（例如 P67890）。
* 对于 id 和 |
name |
text | *是 |
产品名称（例如 Android T 恤）。
* 对于 id 和 |
brand |
text | 否 | 与产品关联的品牌（例如 Google）。 |
category |
text | 否 | 产品所属的类别（例如服装）。可以使用 / 作为分隔符来指定最多 5 个层级（例如服装/男装/T 恤）。 |
variant |
text | 否 | 产品的细分款式（例如黑色）。 |
price |
number | 否 | 产品的价格（例如 29.20）。 |
quantity |
integer | 否 | 产品的数量（例如 2）。 |
coupon |
text | 否 | 与产品关联的优惠券代码（例如 SUMMER_SALE13） |
position |
integer | 否 | 产品在列表或集合中的位置（例如 2）。 |
list_position |
integer | 否 | 产品在列表或集合中的位置（例如 2）。 |
推广活动数据
表示被查看的推广活动的相关信息。此类数据封装为 promoFieldObject，其中包含以下值：
| 键 | 值类型 | 是否必须提供 | 说明 |
|---|---|---|---|
id |
text | *是 |
推广活动的 ID（例如 PROMO_1234）。
* 对于 |
name |
text | *是 |
推广活动的名称（例如“夏季促销”）。
* 对于 |
creative |
text | 否 | 与推广活动关联的广告素材（例如 summer_banner2）。 |
creative_name |
text | 否 | 广告素材的名称（例如 summer_banner2）。 |
position |
text | 否 | 广告素材的位置（例如 banner_slot_1）。 |
creative_slot |
text | 否 | 广告素材投放到的广告位的名称（例如 banner_slot_1）。 |
操作数据
表示发生的电子商务相关操作的信息。此类数据封装为 actionFieldObject，其中包含以下值：
| 键 | 值类型 | 是否必须提供 | 说明 |
|---|---|---|---|
id |
text | *是 |
交易 ID（例如 T1234）。
* 如果操作类型是 |
affiliation |
text | 否 | 发生此交易的商店或关联商户（例如 Google 商店）。 |
revenue |
number | 否 |
与这笔交易关联的总收入或总计金额（例如 11.99）。此值可能包含运费、税费或其他要计入 revenue 的总收入调整值。 |
| 值 | number | 否 | 与事件相关的价值（即收入） |
tax |
number | 否 | 与这笔交易相关的总税额。 |
shipping |
number | 否 | 与这笔交易相关的运费。 |
coupon |
text | 否 | 在这笔交易中兑换的优惠券。 |
list |
text | 否 | 关联产品所在的列表。可选。 |
items |
array | 否 | 包含关联产品的数组。 |
step |
integer | 否 | 一个数字，表示结账流程中的某个步骤。对于“checkout”操作，可自由选择是否提供此值。 |
checkout_step |
integer | 否 | 一个数字，表示结账流程中的某个步骤。 |
option |
text | 否 |
checkout 和 checkout_option 操作的附加字段，用于描述结账页上的选项信息，例如所选的付款方式。
|
checkout_option |
text | 否 | 结账选项（即所选的付款方式）。 |
| 键 | 值类型 | 是否必须提供 | 说明 |
|---|---|---|---|
coupon |
string | 否 | 可购商品的优惠券代码。 |
产品和推广活动操作
“操作”指定了应当如何解读您发送到 Google Analytics（分析）的产品和推广活动数据。
| 操作 | 事件 | 说明 |
|---|---|---|
click |
点击某个产品，或点击一个或多个产品的产品链接。 | |
detail |
查看产品详情。 | |
add |
将一个或多个产品添加到购物车。 | |
remove |
从购物车中移除一个或多个产品。 | |
checkout |
开始一个或多个产品的结账流程。 | |
checkout_option |
发送指定结账步骤的选项值。 | |
purchase |
购买一个或多个产品。 | |
refund |
为一个或多个产品退款。 | |
promo_click |
点击某个内部推广活动。 | |
add_to_cart |
用户将一个或多个产品添加到购物车。 | |
begin_checkout |
用户开始一个或多个产品的结账流程。 | |
checkout_progress |
用户在第一个结账步骤之后完成结账步骤。 | |
purchase |
用户完成购买。 | |
refund |
用户收到一个或多个产品的退款。 | |
remove_from_cart |
用户从购物车中移除一个或多个产品。 | |
select_content |
用户点击某个产品或产品链接。 | |
set_checkout_option |
用户正在完成的结账步骤。 | |
view_item |
用户查看某个产品的详细信息。 | |
view_item_list |
用户查看一个或多个产品的列表。 | |
view_promotion |
用户点击某个内部推广活动。 | |
view_refund |
用户查看一个或多个产品的退款。 |
示例
衡量商品获得的展示情况
如需衡量商品获得的展示情况，请发送 view_item_list，并提供相应的商品信息：
gtag('event', 'view_item_list', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": 2
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": 3
}
]
});
衡量商品获得的点击情况
如需衡量商品获得的点击情况，请发送 select_content 事件，将 product 指定为 content_type，并提供相应的商品信息：
gtag('event', 'select_content', {
"content_type": "product",
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": 2
}
]
});
衡量商品详情获得的浏览情况
点击商品详情后，用户可能会查看商品详情页面。如需衡量商品详情获得的浏览情况，请发送 view_item 事件，并提供相应的商品详情：
gtag('event', 'view_item', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
衡量在购物车中添加或移除商品的操作
如需衡量将商品添加到购物车的操作，请发送包含相应商品信息的 add_to_cart 事件：
gtag('event', 'add_to_cart', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
如需衡量从购物车中移除商品的操作，请发送包含相应商品信息的 remove_from_cart 事件：
gtag('event', 'remove_from_cart', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
]
});
衡量结账情况
要衡量结账流程中的每个步骤，请按以下步骤操作：
- 添加衡量代码，以衡量结账流程中的每一步。
- 如果适用，添加衡量代码以记录结账选项。
1. 衡量结账步骤
如需衡量第一个结账步骤，请发送一个包含结账商品的 begin_checkout 事件：
gtag('event', 'begin_checkout', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
],
"coupon": ""
});
如需衡量各个后续结账步骤，请发送 checkout_progress 事件，并提供相应的结账商品信息：
gtag('event', 'checkout_progress', {
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
}
],
"coupon": "SUMMER_DISCOUNT"
});
2. 衡量结账选项
如需衡量结账选项，请发送 set_checkout_option 事件，并提供相应的结账选项：
gtag('event', 'set_checkout_option', {
"checkout_step": 1,
"checkout_option": "shipping method",
"value": 3
});
衡量推广活动的展示情况
如需衡量推广活动的展示情况，请发送 view_promotion 事件，并提供相应的推广活动信息：
gtag('event', 'view_promotion', {
"promotions": [
{
"id": "abc123",
"name": "summer_promo"
},
{
"id": "xyz987",
"name": "spring savings"
}
]
});
衡量推广活动的点击情况
如需衡量推广活动的点击情况，请发送 select_content 事件，并提供相应的推广活动信息：
gtag('event', 'select_content', {
"promotions": [
{
"id": "abc123",
"name": "summer_promo"
}
]
});
衡量购买情况
如需衡量交易情况，请发送 purchase 事件，并提供相应交易所涉及的商品：
gtag('event', 'purchase', {
"transaction_id": "24.031608523954162",
"affiliation": "Google online store",
"value": 23.07,
"currency": "USD",
"tax": 1.24,
"shipping": 0,
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": '3.0'
}
]
});
衡量退款情况
如需衡量交易的全额退款，请发送包含交易 ID 的 refund 事件：
gtag('event', 'refund', { "transaction_id": "T12345" })
如需衡量部分退款的情况，请发送 refund 事件，并提供相应的交易 ID 和待退款商品：
gtag('event', 'refund', {
"transaction_id": "79.18502354114992",
"affiliation": "Google online store",
"value": 23.07,
"currency": "USD",
"tax": 1.24,
"shipping": 0,
"items": [
{
"id": "P12345",
"name": "Android Warhol T-Shirt",
"list_name": "Search Results",
"brand": "Google",
"category": "Apparel/T-Shirts",
"variant": "Black",
"list_position": 1,
"quantity": 2,
"price": '2.0'
},
{
"id": "P67890",
"name": "Flame challenge TShirt",
"list_name": "Search Results",
"brand": "MyBrand",
"category": "Apparel/T-Shirts",
"variant": "Red",
"list_position": 2,
"quantity": 1,
"price": '3.0'
}
]
});