“应用+网站”事件

add_payment_info

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

参数

名称 类型 是否必须提供 示例值 说明
coupon string SUMMER_FUN 购买时所用的优惠券代码。
currency string (ISO 4217) USD 与事件相关的购买或商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。
items Array<Item> 与事件相关的商品。
payment_type string 信用卡 选定的付款方式。
value number 7.77 与事件相关的货币价值。

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', 'add_payment_info', {
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  payment_type: 'Credit Card',
  value: 9.99
});

add_shipping_info

此事件表示用户已提交其运费信息。

参数

名称 类型 是否必须提供 示例值 说明
coupon string SUMMER_FUN 购买时所用的优惠券代码。
currency string (ISO 4217) USD 与事件相关的购买或商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。
items Array<Item> 与事件相关的商品。
shipping_tier string 陆运 为交付已购商品而选择的配送级别(例如 GroundAirNext-day)。
value number 7.77 与事件相关的货币价值。

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', 'add_shipping_info', {
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: "Google Store",
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'Black',
    price: 9.99,
    currency: 'USD'
  }],
  shipping_tier: 'Ground',
  value: 7.77
});

add_to_cart

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

参数

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

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', 'add_to_cart', {
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  value: 7.77
});

add_to_wishlist

此事件表示商品已添加到心愿单。使用此事件可找出您应用中的热门礼品。

参数

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

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', 'add_to_wishlist', {
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  value: 9.99
});

begin_checkout

此事件表示用户已开始结帐流程。

参数

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

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', 'begin_checkout', {
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  value: 7.77
});

earn_virtual_currency

此事件衡量的是奖励虚拟货币这一操作。一同记录此事件与 spend_virtual_currency 事件,以便更好地了解您的虚拟经济情况。

参数

名称 类型 是否必须提供 示例 说明
virtual_currency_name string 宝石 虚拟货币的名称。
value number 5 虚拟货币的价值。

示例

gtag('event', 'earn_virtual_currency', {
  virtual_currency_name: 'Gems',
  value: 5
});

generate_lead

在带来潜在客户时记录此事件,以便了解再互动广告系列的效果。

参数

名称 类型 是否必须提供 示例 说明
currency string USD 潜在客户所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。
value number 99.99 潜在客户的价值。
transaction_id string T_12345 交易的 ID。

示例

gtag('event', 'generate_lead', {
  currency: 'USD',
  value: 99.99,
  transaction_id: 'T_12345'
});

join_group

在用户加入群组(例如公会、团队或家庭)时记录此事件。使用此事件可分析特定群组或社交功能的受欢迎程度。

参数

名称 类型 是否必须提供 示例 说明
group_id string G_12345 群组的 ID。

示例

gtag('event', 'join_group', {
  group_id: 'G_12345'
});

level_end

此事件表示玩家已经完成了某个关卡。

参数

名称 类型 是否必须提供 示例 说明
level_name string 通关之旅即将开始… 关卡的名称。
success boolean true 如果成功通关,则设为 true

示例

gtag('event', 'level_end', {
  level_name: 'The journey begins...',
  success: true,
});

level_start

此事件表示玩家已开始挑战某个关卡。

参数

名称 类型 是否必须提供 示例 说明
level_name string 通关之旅即将开始… 关卡的名称。

示例

gtag('event', 'level_start', {
  level_name: 'The journey begins...'
});

level_up

此事件表示玩家升级了。使用此事件可衡量用户群的等级分布情况,以及找出难以通过的关卡。

参数

名称 类型 是否必须提供 示例 说明
level number 5 角色的等级。
character string 玩家 1 升级的角色。

示例

gtag('event', 'level_up', {
  level: 5,
  character: 'Player 1'
});

login

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

参数

名称 类型 是否必须提供 示例 说明
method string Google 登录时所用的方法。

示例

gtag('event', 'login', {
  method: 'Google'
});

post_score

在用户发布得分时发送此事件。使用此事件可了解用户在您游戏中的表现,并将最高得分与受众群体或行为关联起来。

参数

名称 类型 是否必须提供 示例 说明
score number 10000 要发布的得分。
level number 5 得分对应的关卡。
character string 玩家 1 获得相应得分的角色。

示例

gtag('event', 'post_score', {
  score: 10000,
  level: 5,
  character: 'Player 1'
});

purchase

此事件表示用户已购买一件或多件商品。

参数

名称 类型 是否必须提供 示例 说明
affiliation string Google 商店 用于指定供应公司或实体店位置的商品关联商户。
coupon string SUMMER_FUN 购买时所用的优惠券代码。
currency string (ISO 4217) USD 与事件相关的购买或商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。
items Array<Item> 与事件相关的商品。
transaction_id string T_12345 交易的唯一标识符
shipping number 3.33 交易对应的运费。
tax number 1.11 交易对应的税费。
value number 12.21 与事件相关的货币价值(以指定的 currency 参数为单位)。

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', 'purchase', {
  affiliation: 'Google Store',
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  transaction_id: 'T_12345',
  shipping: 3.33,
  value: 12.21,
  tax: 1.11
})

退款

此事件表示退款已发放。

参数

名称 类型 是否必须提供 示例 说明
affiliation string Google 商店 用于指定供应公司或实体店位置的商品关联商户。
coupon string SUMMER_FUN 购买时所用的优惠券代码。
currency string (ISO 4217) USD 与事件相关的购买或商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。
items Array<Item> 与事件相关的商品。
transaction_id string T_12345 交易的唯一标识符。
shipping number 3.33 交易对应的运费。
tax number 1.11 交易对应的税费。
value number 12.21 与事件相关的货币价值(以指定的 currency 参数为单位)。

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', 'refund', {
  affiliation: 'Google Store',
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  transaction_id: 'T_12345',
  shipping: 3.33,
  value: 12.21,
  tax: 1.11
});

remove_from_cart

此事件表示商品已从购物车中移除。

参数

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

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', 'remove_from_cart', {
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  value: 7.77
});

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

参数

名称 类型 是否必须提供 示例 说明
search_term string T 恤 搜索的字词。

示例

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

select_content

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

参数

名称 类型 是否必须提供 示例值 说明
content_type string product 所选内容的类型。
item_id string I_12345 所选商品的标识符。

示例

gtag('event', 'select_content', {
  content_type: 'product',
  item_id: 'I_12345'
});

select_item

此事件表示从列表中选择了商品。

参数

名称 类型 是否必须提供 示例值 说明
items Array<Item> 与事件相关的商品。
item_list_name string 相关商品 商品向用户展示时所在列表的名称。
item_list_id string IL_12345 商品向用户展示时所在列表的 ID。

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', 'select_item', {
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    index: 5,
    item_list_name: "Related Products",
    item_list_id: "IL_12345",
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  item_list_name: 'Related products',
  item_list_id: 'related_products'
});

select_promotion

此事件表示从列表中选择了促销活动。

参数

名称 类型 是否必须提供 示例值 说明
items Array<Item> 与事件相关的商品。
promotion_id string P_12345 商品促销活动的 ID。
promotion_name string 夏季促销 商品促销活动的名称。

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', 'select_promotion', {
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    creative_slot: "featured_app_1",
    location_id: "L_12345",
    affiliation: "Google Store",
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'Black',
    price: 9.99,
    currency: 'USD'
  }],
  promotion_id: "P_12345",
  promotion_name: "Summer Sale"
});

share

使用此事件可找出热门内容。

参数

名称 类型 是否必须提供 示例 说明
method string Twitter 共享内容的方法。
content_type string 图片 共享内容的类型。
content_id string C_12345 共享内容的 ID。

示例

gtag('event', 'share', {
  method: 'Twitter',
  content_type: 'image',
  content_id: 'C_12345',
});

sign_up

此事件表示用户已注册帐号。使用此事件可了解登录用户和退出用户的不同行为。

参数

名称 类型 是否必须提供 示例 说明
method string Google 注册时所用的方法。

示例

gtag('event', 'sign_up', {
  method: 'Google'
});

spend_virtual_currency

此事件衡量的是应用内虚拟商品的销售情况,有助于您确定哪些虚拟商品最受欢迎。

参数

名称 类型 是否必须提供 示例 说明
item_name string 启动积分加倍活动 使用虚拟货币的商品的名称。
virtual_currency_name string 宝石 虚拟货币的名称。
value number 5 虚拟货币的价值。

示例

gtag('event', 'spend_virtual_currency', {
  item_name: 'Starter Boost',
  virtual_currency_name: 'Gems',
  value: 5
});

tutorial_begin

此事件表示新手入门流程已开始。在包含 tutorial_complete 的漏斗中使用此事件可了解有多少用户完成了教程。

参数

此事件没有任何参数。

示例

gtag('event', 'tutorial_begin');

tutorial_complete

此事件表示用户已完成新手入门流程。在包含 tutorial_begin 的漏斗中使用此事件可了解有多少用户完成了教程。

参数

未针对此事件推荐任何参数。

示例

gtag('event', 'tutorial_complete');

unlock_achievement

在用户解锁成就时记录此事件。此事件有助于您了解用户在您游戏中的体验。

参数

名称 类型 是否必须提供 示例 说明
achievement_id string A_12345 已解锁成就的 ID。

示例

gtag('event', 'unlock_achievement', {
  achievement_id: 'A_12345'
});

view_cart

此事件表示用户查看了购物车。

参数

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

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_cart', {
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  value: 7.77
});

view_item

此事件表示向用户展示了某些内容。使用此事件可了解用户查看了哪些最热门商品。

参数

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

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_item', {
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  value: 9.99
});

view_item_list

向用户展示某类商品的列表时记录此事件。

参数

名称 类型 是否必须提供 示例 说明
items Array<Item> 与事件相关的商品。
item_list_name string 相关商品 商品向用户展示时所在列表的名称。
item_list_id string IL_12345 商品向用户展示时所在列表的 ID。

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_item_list', {
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    index: 5,
    item_list_name: "Related Products",
    item_list_id: "IL_12345",
    affiliation: 'Google Store',
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'black',
    price: 9.99,
    currency: 'USD'
  }],
  item_list_name: 'Related products',
  item_list_id: 'related_products'
});

view_promotion

此事件表示从列表查看了促销活动。

参数

名称 类型 是否必须提供 示例值 说明
items Array<Item> 与事件相关的商品。
promotion_id string P_12345 商品促销活动的 ID。
promotion_name string 夏季促销 商品促销活动的名称。

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_promotion', {
  coupon: 'SUMMER_FUN',
  currency: 'USD',
  items: [{
    item_id: 'SKU_12345',
    item_name: 'jeggings',
    coupon: 'SUMMER_FUN',
    discount: 2.22,
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    creative_slot: "featured_app_1",
    location_id: "L_12345",
    affiliation: "Google Store",
    item_brand: 'Gucci',
    item_category: 'pants',
    item_variant: 'Black',
    price: 9.99,
    currency: 'USD'
  }],
  promotion_id: "P_12345",
  promotion_name: "Summer Sale"
});