Google Analytics（分析）4 事件

add_payment_info

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

参数

名称	类型	是否必须提供	示例值	说明
currency	string	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 如果设置此参数，系统会忽略商品级 currency。 如果未设置此参数，系统会使用 items 中第一件商品所用的币种。 *如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value	number	是*	7.77	与事件相关的货币价值。 *如需生成有意义的报告，通常必须提供 value。 如果您将事件标记为转化，则建议您设置 value。 *如果设置 value，则必须提供 currency。
coupon	string	否	SUMMER_FUN	与事件相关的优惠券名称/代码。 事件级和商品级 coupon 参数彼此独立。
payment_type	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", "add_payment_info", {
  currency: "USD",
  value: 7.77,
  coupon: "SUMMER_FUN",
  payment_type: "Credit Card",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

add_shipping_info

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

参数

名称	类型	是否必须提供	示例值	说明
currency	string	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 如果设置此参数，系统会忽略商品级 currency。 如果未设置此参数，系统会使用 items 中第一件商品所用的币种。 *如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value	number	是*	7.77	与事件相关的货币价值。 *如需生成有意义的报告，通常必须提供 value。 如果您将事件标记为转化，则建议您设置 value。 *如果设置 value，则必须提供 currency。
coupon	string	否	SUMMER_FUN	与事件相关的优惠券名称/代码。 事件级和商品级 coupon 参数彼此独立。
shipping_tier	string	否	陆运	用户为所购商品选择的配送级别（例如 Ground、Air 和 Next-day）。
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", "add_shipping_info", {
  currency: "USD",
  value: 7.77,
  coupon: "SUMMER_FUN",
  shipping_tier: "Ground",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

add_to_cart

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

参数

名称	类型	是否必须提供	示例值	说明
currency	string	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 如果设置此参数，系统会忽略商品级 currency。 如果未设置此参数，系统会使用 items 中第一件商品所用的币种。 *如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value	number	是*	7.77	与事件相关的货币价值。 *如需生成有意义的报告，通常必须提供 value。 如果您将事件标记为转化，则建议您设置 value。 *如果设置 value，则必须提供 currency。
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", "add_to_cart", {
  currency: "USD",
  value: 7.77,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

add_to_wishlist

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

参数

名称	类型	是否必须提供	示例值	说明
currency	string	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 如果设置此参数，系统会忽略商品级 currency。 如果未设置此参数，系统会使用 items 中第一件商品所用的币种。 *如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value	number	是*	7.77	与事件相关的货币价值。 *如需生成有意义的报告，通常必须提供 value。 如果您将事件标记为转化，则建议您设置 value。 *如果设置 value，则必须提供 currency。
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", "add_to_wishlist", {
  currency: "USD",
  value: 7.77,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ],
});

begin_checkout

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

参数

名称	类型	是否必须提供	示例值	说明
currency	string	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 如果设置此参数，系统会忽略商品级 currency。 如果未设置此参数，系统会使用 items 中第一件商品所用的币种。 *如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value	number	是*	7.77	与事件相关的货币价值。 *如需生成有意义的报告，通常必须提供 value。 如果您将事件标记为转化，则建议您设置 value。 *如果设置 value，则必须提供 currency。
coupon	string	否	SUMMER_FUN	与事件相关的优惠券名称/代码。 事件级和商品级 coupon 参数彼此独立。
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", "begin_checkout", {
  currency: "USD",
  value: 7.77,
  coupon: "SUMMER_FUN",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

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 格式）。 如果设置此参数，系统会忽略商品级 currency。 如果未设置此参数，系统会使用 items 中第一件商品所用的币种。 *如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value	number	是*	7.77	与事件相关的货币价值。 *如需生成有意义的报告，通常必须提供 value。 如果您将事件标记为转化，则建议您设置 value。 *如果设置 value，则必须提供 currency。

示例

gtag("event", "generate_lead", {
  currency: "USD",
  value: 99.99
});

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

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

参数

名称	类型	是否必须提供	示例值	说明
currency	string	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 如果设置此参数，系统会忽略商品级 currency。 如果未设置此参数，系统会使用 items 中第一件商品所用的币种。 *如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
transaction_id	string	是	T_12345	交易的唯一标识符。
value	number	是*	12.21	与事件相关的货币价值。 *如需生成有意义的报告和填充“购买者”预测性受众群体，则必须提供 value。 *如果设置 value，则必须提供 currency。
affiliation	string	否	Google 商店	用于指定供应公司或实体店位置的商品关联商户。 事件级和商品级 affiliation 参数彼此独立。
coupon	string	否	SUMMER_FUN	与事件相关的优惠券名称/代码。 事件级和商品级 coupon 参数彼此独立。
shipping	number	否	3.33	与交易相关的运费。
tax	number	否	1.11	与交易相关的税费。
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", "purchase", {
  currency: "USD",
  transaction_id: "T_12345",
  value: 21.09,
  affiliation: "Google Store",
  coupon: "SUMMER_FUN",
  shipping: 3.33,
  tax: 2.22,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    },
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 7,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "black",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ],
});

退款

此事件表示退款已发放。

参数

名称	类型	是否必须提供	示例值	说明
currency	string	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 如果设置此参数，系统会忽略商品级 currency。 如果未设置此参数，系统会使用 items 中第一件商品所用的币种。 *如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
transaction_id	string	是	T_12345	交易的唯一标识符。
value	number	是*	7.77	与事件相关的货币价值。 *如需生成有意义的报告，通常必须提供 value。 如果您将事件标记为转化，则建议您设置 value。 *如果设置 value，则必须提供 currency。
affiliation	string	否	Google 商店	用于指定供应公司或实体店位置的商品关联商户。 事件级和商品级 affiliation 参数彼此独立。
coupon	string	否	SUMMER_FUN	与事件相关的优惠券名称/代码。 事件级和商品级 coupon 参数彼此独立。
shipping	number	否	3.33	与交易相关的运费。
tax	number	否	1.11	与交易相关的税费。
items	Array<Item>	否*		与事件相关的商品。 *对于部分退款，必须提供 items，而对于全额退款，则可忽略此参数。

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", "refund", {
  currency: "USD",
  transaction_id: "T_12345",
  value: 12.21,
  affiliation: "Google Store",
  coupon: "SUMMER_FUN",
  shipping: 3.33,
  tax: 1.11
});

部分退款

gtag("event", "refund", {
  currency: "USD",
  transaction_id: "T_12345",
  value: 12.21,
  affiliation: "Google Store",
  coupon: "SUMMER_FUN",
  shipping: 3.33,
  tax: 1.11,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

remove_from_cart

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

参数

名称	类型	是否必须提供	示例值	说明
currency	string	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 如果设置此参数，系统会忽略商品级 currency。 如果未设置此参数，系统会使用 items 中第一件商品所用的币种。 *如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value	number	是*	7.77	与事件相关的货币价值。 *如需生成有意义的报告，通常必须提供 value。 如果您将事件标记为转化，则建议您设置 value。 *如果设置 value，则必须提供 currency。
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", "remove_from_cart", {
  currency: "USD",
  value: 7.77,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

search

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

参数

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

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

参数

名称	类型	是否必须提供	示例值	说明
item_list_id	string	否	related_products	商品向用户展示时所在列表的 ID。 如果在商品级别进行设置，系统会忽略此参数。
item_list_name	string	否	相关商品	商品向用户展示时所在列表的名称。 如果在商品级别进行设置，系统会忽略此参数。
items	Array<Item>	是*		与事件相关的商品。 *items 数组应包含一个表示所选商品的元素。如果提供了多个元素，则仅使用 items 中的第一个元素。

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", "select_item", {
  item_list_id: "related_products",
  item_list_name: "Related products",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

select_promotion

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

参数

名称	类型	是否必须提供	示例值	说明
creative_name	string	否	summer_banner2	促销广告素材的名称。 如果在商品级别进行设置，系统会忽略此参数。
creative_slot	string	否	featured_app_1	与事件相关的促销广告素材投放到的广告位的名称。 如果在商品级别进行设置，系统会忽略此参数。
location_id	string	否	L_12345	地理位置的 ID。 如果在商品级别进行设置，系统会忽略此参数。
promotion_id	string	否	P_12345	与事件相关的促销活动的 ID。 如果在商品级别进行设置，系统会忽略此参数。
promotion_name	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", "select_promotion", {
  creative_name: "Summer Banner",
  creative_slot: "featured_app_1",
  location_id: "L_12345",
  promotion_id: "P_12345",
  promotion_name: "Summer Sale",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      creative_name: "summer_banner2",
      creative_slot: "featured_app_1",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 1
    }
  ],
});

share

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

参数

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

示例

gtag("event", "share", {
  method: "Twitter",
  content_type: "image",
  item_id: "C_12345",
});

sign_up

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

参数

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

示例

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

spend_virtual_currency

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

参数

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

示例

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

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 格式）。 如果设置此参数，系统会忽略商品级 currency。 如果未设置此参数，系统会使用 items 中第一件商品所用的币种。 *如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value	number	是*	7.77	与事件相关的货币价值。 *如需生成有意义的报告，通常必须提供 value。 如果您将事件标记为转化，则建议您设置 value。 *如果设置 value，则必须提供 currency。
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_cart", {
  currency: "USD",
  value: 7.77,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

view_item

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

参数

名称	类型	是否必须提供	示例值	说明
currency	string	是*	USD	与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。 如果设置此参数，系统会忽略商品级 currency。 如果未设置此参数，系统会使用 items 中第一件商品所用的币种。 *如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value	number	是*	7.77	与事件相关的货币价值。 *如需生成有意义的报告，通常必须提供 value。 如果您将事件标记为转化，则建议您设置 value。 *如果设置 value，则必须提供 currency。
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_item", {
  currency: "USD",
  value: 7.77,
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

view_item_list

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

参数

名称	类型	是否必须提供	示例值	说明
item_list_id	string	否	related_products	商品向用户展示时所在列表的 ID。 如果在商品级别进行设置，系统会忽略此参数。
item_list_name	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_item_list", {
  item_list_id: "related_products",
  item_list_name: "Related products",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      quantity: 1
    }
  ]
});

view_promotion

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

参数

名称	类型	是否必须提供	示例值	说明
creative_name	string	否	summer_banner2	促销广告素材的名称。 如果在商品级别进行设置，系统会忽略此参数。
creative_slot	string	否	featured_app_1	与事件相关的促销广告素材投放到的广告位的名称。 如果在商品级别进行设置，系统会忽略此参数。
location_id	string	否	L_12345	地理位置的 ID。 如果在商品级别进行设置，系统会忽略此参数。
promotion_id	string	否	P_12345	与事件相关的促销活动的 ID。 如果在商品级别进行设置，系统会忽略此参数。
promotion_name	string	否	夏季促销	与事件相关的促销活动的名称。 如果在商品级别进行设置，系统会忽略此参数。
items	Array<Item>	是*		与事件相关的商品。 *items 数组应包含一个表示促销活动相关商品的元素。如果提供了多个元素，则仅使用 items 中的第一个元素。

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_promotion", {
  creative_name: "Summer Banner",
  creative_slot: "featured_app_1",
  location_id: "L_12345",
  promotion_id: "P_12345",
  promotion_name: "Summer Sale",
  items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Store",
      coupon: "SUMMER_FUN",
      creative_name: "summer_banner2",
      creative_slot: "featured_app_1",
      currency: "USD",
      discount: 2.22,
      index: 5,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "L_12345",
      price: 9.99,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 1
    }
  ]
});