本页介绍了如何使用 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'
}
]
});