add_payment_info
此事件表示用户已提交其付款信息。
参数
此事件没有任何参数。
add_shipping_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",
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"
}]
});
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"
}
]
});
earn_virtual_currency
此事件衡量的是奖励虚拟货币这一操作。一同记录此事件与 spend_virtual_currency 事件,以便更好地了解您的虚拟经济情况。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
virtual_currency_name |
string |
否 | 宝石 | 虚拟货币的名称。 |
value |
number |
否 | 5 | 虚拟货币的价值。 |
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
});
join_group
在用户加入群组(例如公会、团队或家庭)时记录此事件。使用此事件可分析特定群组或社交功能的受欢迎程度。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
group_id |
string |
否 | G_12345 | 群组的 ID。 |
level_up
此事件表示玩家升级了。使用此事件可衡量用户群的等级分布情况,以及找出难以通过的关卡。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
level |
number |
否 | 5 | 角色的等级。 |
character |
string |
否 | 玩家 1 | 升级的角色。 |
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"
});
post_score
在用户发布得分时发送此事件。使用此事件可了解用户在您游戏中的表现,并将最高得分与受众群体或行为关联起来。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
score |
number |
是 | 10000 | 要发布的得分。 |
level |
number |
否 | 5 | 得分对应的关卡。 |
character |
string |
否 | 玩家 1 | 获得相应得分的角色。 |
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'
}
]
});
select_item
此事件表示从列表中选择了商品。
参数
select_promotion
此事件表示从列表中选择了促销活动。
参数
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 |
否 | 图片 | 共享内容的类型。 |
item_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"
});
spend_virtual_currency
此事件衡量的是应用内虚拟商品的销售情况,有助于您确定哪些虚拟商品最受欢迎。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
value |
number |
是 | 5 | 虚拟货币的价值。 |
virtual_currency_name |
string |
是 | 宝石 | 虚拟货币的名称。 |
item_name |
string |
否 | 启动积分加倍活动 | 使用虚拟货币的商品的名称。 |
timing_complete
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
name |
string |
否 | 加载 | 用于标识记录的变量的名称。 |
value |
number |
否 | 3549 | 要向 Google Analytics(分析)报告的所用时间,以毫秒为单位。 |
示例
gtag("event", "timing_complete", {
name: "load",
value: 3549
});
tutorial_begin
此事件表示新手入门流程已开始。在包含 tutorial_complete 的漏斗中使用此事件可了解有多少用户完成了教程。
参数
tutorial_complete
此事件表示用户已完成新手入门流程。在包含 tutorial_begin 的漏斗中使用此事件可了解有多少用户完成了教程。
参数
unlock_achievement
在用户解锁成就时记录此事件。此事件有助于您了解用户在您游戏中的体验。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
achievement_id |
string |
是 | A_12345 | 已解锁成就的 ID。 |
view_cart
此事件表示用户查看了购物车。
参数
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 |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
affiliation |
string |
否 | Google 商店 |
用于指定供应公司或实体店位置的商品关联商户。 事件级和商品级 affiliation 参数彼此独立。
|
coupon |
string |
否 | SUMMER_FUN | 与商品相关的优惠券名称/代码。 事件级和商品级 coupon 参数彼此独立。
|
currency |
string |
否 | USD |
币种(采用由 3 个字母表示的 ISO 4217 格式)。 如果设置此参数,系统会忽略事件级 currency 。不支持为每个事件设置多种币种。应为每件商品设置同一币种。 |
creative_name |
string |
否 | summer_banner2 | 促销广告素材的名称。 如果设置此参数,系统会忽略事件级 creative_name 。
如果未设置此参数,系统会使用事件级 creative_name (如果存在)。 |
creative_slot |
string |
否 | featured_app_1 | 与商品相关的促销广告素材投放到的广告位的名称。 如果设置此参数,系统会忽略事件级 creative_slot 。
如果未设置此参数,系统会使用事件级 creative_slot (如果存在)。 |
discount |
number |
否 | 2.22 | 与商品相关的折扣货币价值。 |
index |
number |
否 | 5 | 列表中商品的索引/商品在列表中的位置。 |
item_brand |
string |
否 | 商品所属品牌。 | |
item_category |
string |
否 | 服饰 | 商品所属类别。如果将其用作类别层次结构或类目的一部分,则为第一个类别。 |
item_category2 |
string |
否 | 成人 | 商品的第二类层次结构或其他类目。 |
item_category3 |
string |
否 | 衬衫 | 商品的第三类层次结构或其他类目。 |
item_category4 |
string |
否 | 圆领 | 商品的第四类层次结构或其他类目。 |
item_category5 |
string |
否 | 短袖 | 商品的第五类层次结构或其他类目。 |
item_list_id |
string |
否 | related_products | 商品向用户展示时所在列表的 ID。 如果设置此参数,系统会忽略事件级 item_list_id 。
如果未设置此参数,系统会使用事件级 item_list_id (如果存在)。
|
item_list_name |
string |
否 | 相关商品 | 商品向用户展示时所在列表的名称。 如果设置此参数,系统会忽略事件级 item_list_name 。
如果未设置此参数,系统会使用事件级 item_list_name (如果存在)。
|
item_variant |
string |
否 | 绿色 | 用于提供其他商品详情/选项的商品款式/规格、唯一代码或说明。 |
location_id |
string |
否 | L_12345 |
与商品相关的地理位置。建议使用与相关商品对应的 Google 地点 ID,也可使用自定义地理位置 ID。 如果设置此参数,系统会忽略事件级 location_id 。
如果未设置此参数,系统会使用事件级 location_id (如果存在)。 |
price |
number |
否 | 9.99 | 商品的货币价格(以指定的 currency 参数为单位)。 |
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 1 |
商品数量。 |
示例
gtag("event", "view_search_results", {
search_term: "Clothing"
});