事件

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。 *必须提供 `id` 或 `name` 中的一个。
`name`	`string`	是*	Android Warhol T 恤	商品的名称。 *必须提供 `id` 或 `name` 中的一个。
`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。 *必须提供 `id` 或 `name` 中的一个。
`name`	`string`	是*	Android Warhol T 恤	商品的名称。 *必须提供 `id` 或 `name` 中的一个。
`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",
  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。 *必须提供 `id` 或 `name` 中的一个。
`name`	`string`	是*	Android Warhol T 恤	商品的名称。 *必须提供 `id` 或 `name` 中的一个。
`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。 *必须提供 `id` 或 `name` 中的一个。
`name`	`string`	是*	Android Warhol T 恤	商品的名称。 *必须提供 `id` 或 `name` 中的一个。
`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"
    }
  ]
});

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	升级的角色。

发送此事件即表示用户已登录。

参数

名称	类型	是否必须提供	示例值	说明
`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"
});

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。 *必须提供 `id` 或 `name` 中的一个。
`name`	`string`	是*	Android Warhol T 恤	商品的名称。 *必须提供 `id` 或 `name` 中的一个。
`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。 *必须提供 `id` 或 `name` 中的一个。
`name`	`string`	是*	Android Warhol T 恤	商品的名称。 *必须提供 `id` 或 `name` 中的一个。
`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_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。 *必须提供 `id` 或 `name` 中的一个。
`name`	`string`	是*	Android Warhol T 恤	商品的名称。 *必须提供 `id` 或 `name` 中的一个。
`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

使用此事件可为搜索操作提供背景信息。此事件有助于您找出应用中最热门的内容。

参数

名称	类型	是否必须提供	示例值	说明
`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。 *必须提供 `id` 或 `name` 中的一个。
`name`	`string`	是*	Android Warhol T 恤	商品的名称。 *必须提供 `id` 或 `name` 中的一个。
`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。 *必须提供 `id` 或 `name` 中的一个。
`name`	`string`	是*	夏季促销	促销活动的名称。 *必须提供 `id` 或 `name` 中的一个。
`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
});

在用户分享了内容时使用此事件。

参数

名称	类型	是否必须提供	示例值	说明
`method`	`string`	否	Twitter	共享内容的方法。
`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`	否	Google	注册时所用的方法。

示例

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。 *必须提供 `id` 或 `name` 中的一个。
`name`	`string`	是*	Android Warhol T 恤	商品的名称。 *必须提供 `id` 或 `name` 中的一个。
`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。 *必须提供 `id` 或 `name` 中的一个。
`name`	`string`	是*	Android Warhol T 恤	商品的名称。 *必须提供 `id` 或 `name` 中的一个。
`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。 *必须提供 `id` 或 `name` 中的一个。
`name`	`string`	是*	夏季促销	促销活动的名称。 *必须提供 `id` 或 `name` 中的一个。
`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_id` 或 `item_name` 中的一个。
`item_name`	`string`	是*	Stan 和 Friends Tee	商品的名称。 *必须提供 `item_id` 或 `item_name` 中的一个。
`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`	否	Google	商品所属品牌。
`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"
});