事件

add_payment_info

此事件表示用户已提交其付款信息。

参数

此事件没有任何参数。

add_to_cart

此事件表示商品已添加到购物车,可供购买。

参数

名称 类型 是否必须提供 示例值 说明
currency string USD 与事件相关的商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。
items Array<Item> 与事件相关的商品。
value number 29.98 与事件相关的货币价值。

Item 参数

名称 类型 是否必须提供 示例值 说明
id string 是* P12345

商品的 ID。

*必须提供 idname 中的一个。

name string 是* Android Warhol T 恤

商品的名称。

*必须提供 idname 中的一个。

brand string Google 商品所属品牌。
category string 服饰/T 恤

商品所属的类别。

使用 / 作为分隔符可指定最多 5 个层级。

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。

*必须提供 idname 中的一个。

name string 是* Android Warhol T 恤

商品的名称。

*必须提供 idname 中的一个。

brand string Google 商品所属品牌。
category string 服饰/T 恤

商品所属的类别。

使用 / 作为分隔符可指定最多 5 个层级。

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。

*必须提供 idname 中的一个。

name string 是* Android Warhol T 恤

商品的名称。

*必须提供 idname 中的一个。

brand string Google 商品所属品牌。
category string 服饰/T 恤

商品所属的类别。

使用 / 作为分隔符可指定最多 5 个层级。

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。

*必须提供 idname 中的一个。

name string 是* Android Warhol T 恤

商品的名称。

*必须提供 idname 中的一个。

brand string Google 商品所属品牌。
category string 服饰/T 恤

商品所属的类别。

使用 / 作为分隔符可指定最多 5 个层级。

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 Google 登录时所用的方法。

示例

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。

*必须提供 idname 中的一个。

name string 是* Android Warhol T 恤

商品的名称。

*必须提供 idname 中的一个。

brand string Google 商品所属品牌。
category string 服饰/T 恤

商品所属的类别。

使用 / 作为分隔符可指定最多 5 个层级。

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。

*必须提供 idname 中的一个。

name string 是* Android Warhol T 恤

商品的名称。

*必须提供 idname 中的一个。

brand string Google 商品所属品牌。
category string 服饰/T 恤

商品所属的类别。

使用 / 作为分隔符可指定最多 5 个层级。

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_1",
  value: 9.99 + 9.99 + 3.33 + 5.55,
  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。

*必须提供 idname 中的一个。

name string 是* Android Warhol T 恤

商品的名称。

*必须提供 idname 中的一个。

brand string Google 商品所属品牌。
category string 服饰/T 恤

商品所属的类别。

使用 / 作为分隔符可指定最多 5 个层级。

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_term string T 恤 搜索的字词。

示例

gtag('event', 'search', {
  search_term: 't-shirts'
});

select_content

此事件表示用户选择了某个类型的某些内容。此事件有助于您找出应用中的热门内容和内容类别。

参数

名称 类型 是否必须提供 示例值 说明
content_type string product 所选内容的类型。
items Array<Item> 与事件相关的商品。只应发送 itemspromotions 中的一个。
promotions Array<Promotion> 与事件相关的促销活动。只应发送 itemspromotions 中的一个。

Item 参数

名称 类型 是否必须提供 示例值 说明
id string 是* P12345

商品的 ID。

*必须提供 idname 中的一个。

name string 是* Android Warhol T 恤

商品的名称。

*必须提供 idname 中的一个。

brand string Google 商品所属品牌。
category string 服饰/T 恤

商品所属的类别。

使用 / 作为分隔符可指定最多 5 个层级。

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。

*必须提供 idname 中的一个。

name string 是* 夏季促销

促销活动的名称。

*必须提供 idname 中的一个。

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 Twitter 共享内容的方法。
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 Google 注册时所用的方法。

示例

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。

*必须提供 idname 中的一个。

name string 是* Android Warhol T 恤

商品的名称。

*必须提供 idname 中的一个。

brand string Google 商品所属品牌。
category string 服饰/T 恤

商品所属的类别。

使用 / 作为分隔符可指定最多 5 个层级。

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。

*必须提供 idname 中的一个。

name string 是* Android Warhol T 恤

商品的名称。

*必须提供 idname 中的一个。

brand string Google 商品所属品牌。
category string 服饰/T 恤

商品所属的类别。

使用 / 作为分隔符可指定最多 5 个层级。

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。

*必须提供 idname 中的一个。

name string 是* 夏季促销

促销活动的名称。

*必须提供 idname 中的一个。

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_iditem_name 中的一个。

item_name string 是* 牛仔打底裤

商品名称(针对特定上下文)。

*必须为商品数据或展示数据提供 item_iditem_name 中的一个。

promotion_id string 是* P_12345 商品促销活动的 ID。必须提供 promotion_idpromotion name 中的一个。
promotion_name string 是* 夏季促销 商品促销活动的名称。必须提供 promotion_idpromotion 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_category2item_category5 的名称。
item_list_name string 相关商品 商品向用户展示时所在列表的名称
item_list_id string IL_12345 商品向用户展示时所在列表的 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'
});