add_payment_info
此事件表示用户已提交其付款信息。
参数
此事件没有任何参数。
add_to_cart
此事件表示商品已添加到购物车,可供购买。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
currency |
string |
否 | USD | 与事件相关的商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 |
items |
Array<Item> |
否 | 与事件相关的商品。 | |
value |
number |
否 | 29.98 | 与事件相关的货币价值。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
id |
string |
是* | P12345 |
商品的 ID。 *必须提供 |
name |
string |
是* | Android Warhol T 恤 |
商品的名称。 *必须提供 |
brand |
string |
否 | 商品所属品牌。 | |
category |
string |
否 | 服饰/T 恤 |
商品所属的类别。
使用 |
coupon |
string |
否 | SUMMER_DISCOUNT | 与商品相关联的优惠券代码。 |
list_name |
string |
否 | 搜索结果 | 商品所在列表的名称。 |
list_position |
number |
否 | 1 | 商品在列表或集合中的位置。 |
price |
number |
否 | 14.99 | 商品的价格。 |
quantity |
number |
否 | 2 | 商品的数量。 |
variant |
string |
否 | 黑色 | 商品的款式。 |
示例
gtag('event', 'add_to_cart', {
currency: 'USD',
items: [{
id: "P12345",
name: "Android Warhol T-Shirt",
brand: "Google",
category: "Apparel/T-Shirts",
coupon: "SUMMER_DISCOUNT",
list_name: "Search Results",
list_position: 1,
price: 14.99,
quantity: 2,
variant: "Black"
}],
value: 29.98
});
add_to_wishlist
此事件表示商品已添加到心愿单。使用此事件可找出您应用中的热门礼品。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
currency |
string |
否 | USD | 与事件相关的商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 |
items |
Array<Item> |
否 | 与事件相关的商品。 | |
value |
number |
否 | 22 | 与事件相关的货币价值。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
id |
string |
是* | P12345 |
商品的 ID。 *必须提供 |
name |
string |
是* | Android Warhol T 恤 |
商品的名称。 *必须提供 |
brand |
string |
否 | 商品所属品牌。 | |
category |
string |
否 | 服饰/T 恤 |
商品所属的类别。
使用 |
coupon |
string |
否 | SUMMER_DISCOUNT | 与商品相关联的优惠券代码。 |
list_name |
string |
否 | 搜索结果 | 商品所在列表的名称。 |
list_position |
number |
否 | 1 | 商品在列表或集合中的位置。 |
price |
number |
否 | 14.99 | 商品的价格。 |
quantity |
number |
否 | 2 | 商品的数量。 |
variant |
string |
否 | 黑色 | 商品的款式。 |
示例
gtag('event', 'add_to_wishlist', {
currency: 'USD',
items: [{
id: "P12345",
name: "Android Warhol T-Shirt",
brand: "Google",
category: "Apparel/T-Shirts",
coupon: "SUMMER_DISCOUNT",
list_name: "Search Results",
list_position: 1,
price: 14.99,
quantity: 2,
variant: "Black"
}],
value: 29.98
});
begin_checkout
此事件表示用户已开始结帐流程。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
coupon |
string |
否 | SUMMER_FUN | 购买时所用的优惠券代码。 |
currency |
string |
否 | USD | 与事件相关的商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 |
items |
Array<Item> |
否 | 与事件相关的商品。 | |
value |
number |
否 | 29.98 | 与事件相关的货币价值。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
id |
string |
是* | P12345 |
商品的 ID。 *必须提供 |
name |
string |
是* | Android Warhol T 恤 |
商品的名称。 *必须提供 |
brand |
string |
否 | 商品所属品牌。 | |
category |
string |
否 | 服饰/T 恤 |
商品所属的类别。
使用 |
coupon |
string |
否 | SUMMER_DISCOUNT | 与商品相关联的优惠券代码。 |
list_name |
string |
否 | 搜索结果 | 商品所在列表的名称。 |
list_position |
number |
否 | 1 | 商品在列表或集合中的位置。 |
price |
number |
否 | 14.99 | 商品的价格。 |
quantity |
number |
否 | 2 | 商品的数量。 |
variant |
string |
否 | 黑色 | 商品的款式。 |
示例
gtag("event", "begin_checkout", {
value: 29.98,
coupon: "SUMMER_DISCOUNT",
currency: "USD",
items: [
{
id: "P12345",
name: "Android Warhol T-Shirt",
list_name: "Search Results",
brand: "Google",
category: "Apparel/T-Shirts",
coupon: "SUMMER_DISCOUNT",
variant: "Black",
list_position: 1,
quantity: 2,
price: 14.99
}
]
});
checkout_progress
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
coupon |
string |
否 | SUMMER_DISCOUNT | 购买时所用的优惠券代码。 |
currency |
string (ISO 4217) |
否 | USD | 与事件相关的购买或商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 |
checkout_option |
string |
否 | Google Pay | 已选择的付款方式。 |
checkout_step |
number |
否 | 1 | 表示结帐流程中某个步骤的数字。 |
value |
number |
否 | 22 | 与事件相关的货币价值(以指定的 currency 参数为单位)。 |
items |
Array<Item> |
否 | 与事件相关的商品。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
id |
string |
是* | P12345 |
商品的 ID。 *必须提供 |
name |
string |
是* | Android Warhol T 恤 |
商品的名称。 *必须提供 |
brand |
string |
否 | 商品所属品牌。 | |
category |
string |
否 | 服饰/T 恤 |
商品所属的类别。
使用 |
coupon |
string |
否 | SUMMER_DISCOUNT | 与商品相关联的优惠券代码。 |
list_name |
string |
否 | 搜索结果 | 商品所在列表的名称。 |
list_position |
number |
否 | 1 | 商品在列表或集合中的位置。 |
price |
number |
否 | 14.99 | 商品的价格。 |
quantity |
number |
否 | 2 | 商品的数量。 |
variant |
string |
否 | 黑色 | 商品的款式。 |
示例
gtag("event", "checkout_progress", {
coupon: "SUMMER_DISCOUNT",
currency: "USD",
checkout_option: "Google Pay",
checkout_step: 1,
value: 29.98,
items: [
{
id: "P12345",
name: "Android Warhol T-Shirt",
brand: "Google",
category: "Apparel/T-Shirts",
coupon: "SUMMER_DISCOUNT",
list_name: "Search Results",
list_position: 1,
price: 14.99,
quantity: 2,
variant: "Black"
}
]
});
exception
当应用的正常执行流程中断时,系统会记录 exception 事件。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
description |
string |
否 | 未填写必填字段。 | 对所发生异常的说明。 |
fatal |
boolean |
否 | true |
异常是否严重。 |
示例
gtag('event', 'exception', {
description: 'Missing required field.',
fatal: true
});
generate_lead
在带来潜在客户时记录此事件,以便了解再互动广告系列的效果。
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
currency |
string |
否 | USD | 潜在客户所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 |
value |
string |
否 | 99.99 | 潜在客户的价值。 |
示例
gtag('event', 'generate_lead', {
currency: 'USD',
value: 99.99
});
login
发送此事件即表示用户已登录。
参数
名称 | 类型 | 是否必须提供 | 示例 | 说明 |
---|---|---|---|---|
method |
string |
否 | 登录时所用的方法。 |
示例
gtag('event', 'login', {
method: 'Google'
});
page_view
此事件表明用户查看了网页。
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
page_location |
string |
否 | https://example.com | 网页的网址。 |
page_path |
string |
否 | /about | 网页的路径。此值必须以 / 开头 |
page_title |
string |
否 | About | 网页的标题。 |
示例
gtag('event', 'page_view', {
page_location: 'https://example.com/about',
page_path: '/about',
page_title: 'About'
});
purchase
此事件表示用户已购买一件或多件商品。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
affiliation |
string |
否 | Google 商店 | 用于指定供应公司或实体店位置的商品关联商户。 |
coupon |
string |
否 | SUMMER_DISCOUNT | 购买时所用的优惠券代码。 |
currency |
string (ISO 4217) |
否 | USD | 与事件相关的购买或商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 |
shipping |
number |
否 | 5.99 | 交易对应的运费。 |
tax |
number |
否 | 2.43 | 交易对应的税费。 |
transaction_id |
string |
否 | T12345 | 交易的唯一标识符 |
value |
number |
否 | 22 | 与事件相关的货币价值(以指定的 currency 参数为单位)。 |
items |
Array<Item> |
否 | 与事件相关的商品。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
id |
string |
是* | P12345 |
商品的 ID。 *必须提供 |
name |
string |
是* | Android Warhol T 恤 |
商品的名称。 *必须提供 |
brand |
string |
否 | 商品所属品牌。 | |
category |
string |
否 | 服饰/T 恤 |
商品所属的类别。
使用 |
coupon |
string |
否 | SUMMER_DISCOUNT | 与商品相关联的优惠券代码。 |
list_name |
string |
否 | 搜索结果 | 商品所在列表的名称。 |
list_position |
number |
否 | 1 | 商品在列表或集合中的位置。 |
price |
number |
否 | 14.99 | 商品的价格。 |
quantity |
number |
否 | 2 | 商品的数量。 |
variant |
string |
否 | 黑色 | 商品的款式。 |
示例
gtag("event", "purchase", {
affiliation: "Google online store",
coupon: "SUMMER_DISCOUNT",
currency: "USD",
shipping: 5.55,
tax: 3.33,
transaction_id: "T_1",
value: 28.86,
items: [
{
id: "P12345",
name: "Android Warhol T-Shirt",
coupon: "P12345_coupon",
list_name: "Search Results",
brand: "Google",
category: "Apparel/T-Shirts",
variant: "Black",
list_position: 3,
quantity: 1,
price: 9.99
},
{
id: "P12346",
name: "Flame challenge TShirt",
coupon: "P12346_coupon",
list_name: "Search Results",
brand: "MyBrand",
category: "Apparel/T-Shirts",
variant: "Red",
list_position: 5,
quantity: 1,
price: 9.99
}
]
});
退款
此事件表示退款已发放。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
coupon |
string |
否 | SUMMER_FUN | 购买时所用的优惠券代码。 |
currency |
string (ISO 4217) |
否 | USD | 与事件相关的购买或商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 |
shipping |
number |
否 | 5.99 | 交易对应的运费。 |
tax |
number |
否 | 2.43 | 交易对应的税费。 |
transaction_id |
string |
否 | T12345 | 交易的唯一标识符 |
value |
number |
否 | 22 | 与事件相关的货币价值(以指定的 currency 参数为单位)。 |
items |
Array<Item> |
否 | 与事件相关的商品。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
id |
string |
是* | P12345 |
商品的 ID。 *必须提供 |
name |
string |
是* | Android Warhol T 恤 |
商品的名称。 *必须提供 |
brand |
string |
否 | 商品所属品牌。 | |
category |
string |
否 | 服饰/T 恤 |
商品所属的类别。
使用 |
coupon |
string |
否 | SUMMER_DISCOUNT | 与商品相关联的优惠券代码。 |
list_name |
string |
否 | 搜索结果 | 商品所在列表的名称。 |
list_position |
number |
否 | 1 | 商品在列表或集合中的位置。 |
price |
number |
否 | 14.99 | 商品的价格。 |
quantity |
number |
否 | 2 | 商品的数量。 |
variant |
string |
否 | 黑色 | 商品的款式。 |
示例
gtag('event', 'refund', {
coupon: "SUMMER_DISCOUNT",
currency: "USD",
shipping: 5.55,
tax: 3.33,
transaction_id: "T_12345",
value: 28.86,
items: [
{
id: "P12345",
coupon: "P12345_coupon",
name: "Android Warhol T-Shirt",
list_name: "Search Results",
brand: "Google",
category: "Apparel/T-Shirts",
variant: "Black",
list_position: 3,
quantity: 1,
price: 9.99
},
{
id: "P12346",
coupon: "P12346_coupon",
name: "Flame challenge TShirt",
list_name: "Search Results",
brand: "MyBrand",
category: "Apparel/T-Shirts",
variant: "Red",
list_position: 5,
quantity: 1,
price: 9.99
}
]
});
remove_from_cart
此事件表示商品已从购物车中移除。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
currency |
string |
否 | USD | 与事件相关的商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 |
items |
Array<Item> |
否 | 与事件相关的商品。 | |
value |
number |
否 | 29.98 | 与事件相关的货币价值。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
id |
string |
是* | P12345 |
商品的 ID。 *必须提供 |
name |
string |
是* | Android Warhol T 恤 |
商品的名称。 *必须提供 |
brand |
string |
否 | 商品所属品牌。 | |
category |
string |
否 | 服饰/T 恤 |
商品所属的类别。
使用 |
coupon |
string |
否 | SUMMER_DISCOUNT | 与商品相关联的优惠券代码。 |
list_name |
string |
否 | 搜索结果 | 商品所在列表的名称。 |
list_position |
number |
否 | 1 | 商品在列表或集合中的位置。 |
price |
number |
否 | 14.99 | 商品的价格。 |
quantity |
number |
否 | 2 | 商品的数量。 |
variant |
string |
否 | 黑色 | 商品的款式。 |
示例
gtag('event', 'remove_from_cart', {
currency: 'USD',
items: [{
id: "P12345",
name: "Android Warhol T-Shirt",
brand: "Google",
category: "Apparel/T-Shirts",
coupon: "SUMMER_DISCOUNT",
list_name: "Search Results",
list_position: 1,
price: 14.99,
quantity: 2,
variant: "Black"
}],
value: 29.98
});
screen_view
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
screen_name |
string |
否 | About | 屏幕名称。 |
示例
gtag('event', 'screen_view', {
screen_name: 'About'
});
search
使用此事件可为搜索操作提供背景信息。此事件有助于您找出应用中最热门的内容。
参数
名称 | 类型 | 是否必须提供 | 示例 | 说明 |
---|---|---|---|---|
search_term |
string |
是 | T 恤 | 搜索的字词。 |
示例
gtag('event', 'search', {
search_term: 't-shirts'
});
select_content
此事件表示用户选择了某个类型的某些内容。此事件有助于您找出应用中的热门内容和内容类别。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
content_type |
string |
否 | product | 所选内容的类型。 |
items |
Array<Item> |
否 |
与事件相关的商品。只应发送 items 或 promotions 中的一个。
|
|
promotions |
Array<Promotion> |
否 |
与事件相关的促销活动。只应发送 items 或 promotions 中的一个。
|
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
id |
string |
是* | P12345 |
商品的 ID。 *必须提供 |
name |
string |
是* | Android Warhol T 恤 |
商品的名称。 *必须提供 |
brand |
string |
否 | 商品所属品牌。 | |
category |
string |
否 | 服饰/T 恤 |
商品所属的类别。
使用 |
coupon |
string |
否 | SUMMER_DISCOUNT | 与商品相关联的优惠券代码。 |
list_name |
string |
否 | 搜索结果 | 商品所在列表的名称。 |
list_position |
number |
否 | 1 | 商品在列表或集合中的位置。 |
price |
number |
否 | 14.99 | 商品的价格。 |
quantity |
number |
否 | 2 | 商品的数量。 |
variant |
string |
否 | 黑色 | 商品的款式。 |
Promotion 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
id |
string |
是* | P_12345 |
促销活动的 ID。 *必须提供 |
name |
string |
是* | 夏季促销 |
促销活动的名称。 *必须提供 |
creative_name |
string |
否 | summer_banner_2 | 广告素材的名称。 |
creative_slot |
string |
否 | banner_slot_1 | 广告素材位置的名称。 |
示例
发送商品
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",
coupon: "SUMMER_SALE",
variant: "Black",
list_position: 1,
quantity: 2,
price: 2
}
]
});
发送促销活动
gtag('event', 'select_content', {
content_type: "product",
promotions: [
{
id: 'P_12345' ,
name: 'Summer Sale',
creative_name: 'summer_banner_2',
creative_slot: 'banner_slot_1'
}
]
});
set_checkout_option
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
checkout_step |
number |
否 | 1 | 表示结帐流程中某个步骤的数字。 |
checkout_option |
string |
否 | Google Pay | 结帐选项信息(例如已选择的付款方式)。 |
value |
number |
否 | 3 | 结帐选项的值。 |
示例
gtag('event', 'set_checkout_option', {
checkout_step: 1,
checkout_option: 'Google Pay',
value: 3
});
share
使用此事件可找出热门内容。
参数
名称 | 类型 | 是否必须提供 | 示例 | 说明 |
---|---|---|---|---|
method |
string |
否 | 共享内容的方法。 | |
content_type |
string |
否 | 图片 | 共享内容的类型。 |
content_id |
string |
否 | C_12345 | 共享内容的 ID。 |
示例
gtag("event", "share", {
content_type: 'image',
item_id: 'C_12345',
method: 'Twitter'
});
sign_up
此事件表示用户已注册帐号。使用此事件可了解登录用户和退出用户的不同行为。
参数
名称 | 类型 | 是否必须提供 | 示例 | 说明 |
---|---|---|---|---|
method |
string |
否 | 注册时所用的方法。 |
示例
gtag("event", "sign_up", {
method: 'Google'
});
timing_complete
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
name |
string |
否 | 加载 | 用于标识记录的变量的名称。 |
value |
number |
否 | 3549 | 要向 Google Analytics(分析)报告的所用时间,以毫秒为单位。 |
示例
gtag("event", "timing_complete", {
name: 'load',
value: 3549
});
view_item
此事件表示向用户展示了某些内容。使用此事件可了解用户查看了哪些最热门商品。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
items |
Array<Item> |
否 | 与事件相关的商品。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
id |
string |
是* | P12345 |
商品的 ID。 *必须提供 |
name |
string |
是* | Android Warhol T 恤 |
商品的名称。 *必须提供 |
brand |
string |
否 | 商品所属品牌。 | |
category |
string |
否 | 服饰/T 恤 |
商品所属的类别。
使用 |
coupon |
string |
否 | SUMMER_DISCOUNT | 与商品相关联的优惠券代码。 |
list_name |
string |
否 | 搜索结果 | 商品所在列表的名称。 |
list_position |
number |
否 | 1 | 商品在列表或集合中的位置。 |
price |
number |
否 | 14.99 | 商品的价格。 |
quantity |
number |
否 | 2 | 商品的数量。 |
variant |
string |
否 | 黑色 | 商品的款式。 |
示例
gtag('event', 'view_item', {
items: [{
id: "P12345",
name: "Android Warhol T-Shirt",
brand: "Google",
category: "Apparel/T-Shirts",
coupon: "SUMMER_DISCOUNT",
list_name: "Search Results",
list_position: 1,
price: 14.99,
quantity: 2,
variant: "Black"
}]
});
view_item_list
向用户展示某类商品的列表时记录此事件。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
items |
Array<Item> |
否 | 与事件相关的商品。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
id |
string |
是* | P12345 |
商品的 ID。 *必须提供 |
name |
string |
是* | Android Warhol T 恤 |
商品的名称。 *必须提供 |
brand |
string |
否 | 商品所属品牌。 | |
category |
string |
否 | 服饰/T 恤 |
商品所属的类别。
使用 |
coupon |
string |
否 | SUMMER_DISCOUNT | 与商品相关联的优惠券代码。 |
list_name |
string |
否 | 搜索结果 | 商品所在列表的名称。 |
list_position |
number |
否 | 1 | 商品在列表或集合中的位置。 |
price |
number |
否 | 14.99 | 商品的价格。 |
quantity |
number |
否 | 2 | 商品的数量。 |
variant |
string |
否 | 黑色 | 商品的款式。 |
示例
gtag('event', 'view_item_list', {
items: [{
id: "P12345",
name: "Android Warhol T-Shirt",
brand: "Google",
category: "Apparel/T-Shirts",
coupon: "SUMMER_DISCOUNT",
list_name: "Search Results",
list_position: 1,
price: 14.99,
quantity: 2,
variant: "Black"
}]
});
view_promotion
此事件表示从列表查看了促销活动。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
promotions |
Array<Promotion> |
否 | 与事件相关的促销活动。 |
Promotion 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
id |
string |
是* | P_12345 |
促销活动的 ID。 *必须提供 |
name |
string |
是* | 夏季促销 |
促销活动的名称。 *必须提供 |
creative_name |
string |
否 | summer_banner_2 | 广告素材的名称。 |
creative_slot |
string |
否 | banner_slot_1 | 广告素材位置的名称。 |
示例
gtag('event', 'view_promotion', {
promotions: [{
id: 'P_12345' ,
name: 'Summer Sale',
creative_name: 'summer_banner_2',
creative_slot: 'banner_slot_1'
}]
});
view_search_results
向用户展示搜索结果时记录此事件。
参数
名称 | 类型 | 是否必须提供 | 示例 | 说明 |
---|---|---|---|---|
search_term |
string |
否 | 服饰 | 搜索时所用的字词。 |
items |
Array<Item> |
否 | 与事件相关的商品。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
item_id |
string |
是* | SKU_12345 |
商品 ID(针对特定上下文)。
*必须为商品数据或展示数据提供 |
item_name |
string |
是* | 牛仔打底裤 |
商品名称(针对特定上下文)。
*必须为商品数据或展示数据提供 |
quantity |
number |
否 | 1 |
商品数量。 |
promotion_id |
string |
是* | P_12345 |
商品促销活动的 ID。必须提供 promotion_id 或 promotion name 中的一个。
|
promotion_name |
string |
是* | 夏季促销 |
商品促销活动的名称。必须提供 promotion_id 或 promotion name 中的一个。
|
affiliation |
string |
否 | Google 商店 | 用于指定供应公司或实体店位置的商品关联商户。 |
coupon |
string |
否 | SUMMER_FUN | 购买时所用的优惠券代码。 |
creative_name |
string |
否 | summer_banner2 | 在促销位置采用的广告素材的名称。 |
creative_slot |
string |
否 | featured_app_1 | 广告素材位置的名称。 |
discount |
number |
否 | 2.22 | 与购买内容相关的折扣的货币价值。 |
index |
number |
否 | 5 | 列表中商品的索引。 |
item_brand |
string |
否 | Gucci | 商品品牌 |
item_category |
string |
否 | 裤子 |
商品类别(针对特定上下文)。如果商品属于多个类别,还可以使用从 item_category2 到 item_category5 的名称。
|
item_list_name |
string |
否 | 相关商品 | 商品向用户展示时所在列表的名称。 |
item_list_id |
string |
否 | related_products | 商品向用户展示时所在列表的 ID。 |
item_variant |
string |
否 | 黑色 | 商品的款式。 |
location_id |
string |
否 | L_12345 | 与事件相关的地理位置。如果可能,请设置为与相关商品对应的 Google 地点 ID,也可替换为自定义的地理位置 ID 字符串。 |
tax |
number |
否 | 1.11 | 交易对应的税费。 |
price |
number |
否 | 9.99 | 商品的货币价格(以指定的 currency 参数为单位)。 |
currency |
string |
否 | USD | 货币(采用由 3 个字母表示的 ISO 4217 格式)。 |
示例
gtag('event', 'view_search_results', {
search_term: 'Clothing'
});