推荐事件

Google Analytics 会自动发送某些类型的事件。此页面介绍了您可以配置的可选的其他事件，以便衡量更多行为，并为您的业务生成更实用的报告。这些额外的事件需要花费更多精力进行配置，然后才能使用，因此 Google Analytics 4 无法自动发送这些事件。如需查看有关如何为网站或应用配置推荐事件和自定义事件的分步说明，请参阅设置事件。

如需查看您可以使用的每个事件的详细信息，请选择您的代码管理平台：

add_payment_info

此事件表示用户在电子商务结账流程中提交了自己的付款信息。

参数

名称 类型 是否必须提供 示例值 说明
currency string 是* USD 与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。

view_item 事件的价值指标不计入收入

* 如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value number 是* 30.03 与事件相关的货币价值。

* 将 value 设置为 items 中所有商品的 (price * quantity) 之和。请勿包含 shipping 或 tax。
* 为了生成有意义的报告，通常必须提供 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 参数彼此独立。
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 否 ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID） 与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。
注意：`location id` 仅适用于商品级范围。
price number 否 10.01 商品的货币单价（以指定的 currency 参数为单位）。
如果商品有折扣，请将 price 设置为折扣后的单价，并在 discount 参数中指定单价折扣。
quantity number 否 3

商品数量。

如果未设置，quantity 将设置为 1。
除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

示例

add_shipping_info

此事件表示用户在电子商务结账流程中提交了自己的配送信息。

参数

名称 类型 是否必须提供 示例值 说明
currency string 是* USD 与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。

view_item 事件的价值指标不计入收入

* 如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value number 是* 30.03 与事件相关的货币价值。

* 将 value 设置为 items 中所有商品的 (price * quantity) 之和。请勿包含 shipping 或 tax。
* 为了生成有意义的报告，通常必须提供 value。如果您将事件标记为关键事件，则建议您设置 value。
* 如果设置 value，则必须提供 currency。
coupon string 否 SUMMER_FUN 与事件相关的优惠券名称/代码。

事件级和商品级 coupon 参数彼此独立。
shipping_tier string 否 Ground 用户为所购商品选择的配送级别（例如 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 参数彼此独立。
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 否 ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID） 与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。
注意：`location id` 仅适用于商品级范围。
price number 否 10.01 商品的货币单价（以指定的 currency 参数为单位）。
如果商品有折扣，请将 price 设置为折扣后的单价，并在 discount 参数中指定单价折扣。
quantity number 否 3

商品数量。

如果未设置，quantity 将设置为 1。
除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

示例

add_to_cart

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

参数

名称 类型 是否必须提供 示例值 说明
currency string 是* USD 与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。

view_item 事件的价值指标不计入收入

* 如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value number 是* 30.03 与事件相关的货币价值。

* 将 value 设置为 items 中所有商品的 (price * quantity) 之和。请勿包含 shipping 或 tax。
* 为了生成有意义的报告，通常必须提供 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 参数彼此独立。
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 否 ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID） 与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。
注意：`location id` 仅适用于商品级范围。
price number 否 10.01 商品的货币单价（以指定的 currency 参数为单位）。
如果商品有折扣，请将 price 设置为折扣后的单价，并在 discount 参数中指定单价折扣。
quantity number 否 3

商品数量。

如果未设置，quantity 将设置为 1。
除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

示例

add_to_wishlist

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

参数

名称 类型 是否必须提供 示例值 说明
currency string 是* USD 与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。

view_item 事件的价值指标不计入收入

* 如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value number 是* 30.03 与事件相关的货币价值。

* 将 value 设置为 items 中所有商品的 (price * quantity) 之和。请勿包含 shipping 或 tax。
* 为了生成有意义的报告，通常必须提供 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 参数彼此独立。
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 否 ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID） 与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。
注意：`location id` 仅适用于商品级范围。
price number 否 10.01 商品的货币单价（以指定的 currency 参数为单位）。
如果商品有折扣，请将 price 设置为折扣后的单价，并在 discount 参数中指定单价折扣。
quantity number 否 3

商品数量。

如果未设置，quantity 将设置为 1。
除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

示例

begin_checkout

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

参数

名称 类型 是否必须提供 示例值 说明
currency string 是* USD 与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。

view_item 事件的价值指标不计入收入

* 如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value number 是* 30.03 与事件相关的货币价值。

* 将 value 设置为 items 中所有商品的 (price * quantity) 之和。请勿包含 shipping 或 tax。
* 为了生成有意义的报告，通常必须提供 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 参数彼此独立。
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 否 ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID） 与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。
注意：`location id` 仅适用于商品级范围。
price number 否 10.01 商品的货币单价（以指定的 currency 参数为单位）。
如果商品有折扣，请将 price 设置为折扣后的单价，并在 discount 参数中指定单价折扣。
quantity number 否 3

商品数量。

如果未设置，quantity 将设置为 1。
除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

示例

close_convert_lead

此事件衡量的是潜在客户转化并完成交易的情况（例如，通过购买）。

参数

名称 类型 是否必须提供 示例值 说明
currency string 是* 美元 相应活动的 value 所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。

* 如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value number 是* 30.03 与事件相关的货币价值。

*为了生成有意义的报告，通常必须提供 value。如果您将事件标记为关键事件，则建议您设置 value。
*如果设置 value，则必须提供 currency。

示例

close_unconvert_lead

此事件衡量的是用户被标记为未成为完成转化的潜在客户的情况，以及相应的原因。

参数

名称 类型 是否必须提供 示例值 说明
currency string 是* 美元 相应活动的 value 所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。

* 如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value number 是* 30.03 与事件相关的货币价值。

*为了生成有意义的报告，通常必须提供 value。如果您将事件标记为关键事件，则建议您设置 value。
*如果设置 value，则必须提供 currency。
unconvert_lead_reason string 否 从未回复 潜在客户未转化的原因。

示例

disqualify_lead

此事件衡量的是用户被标记为不符合条件，无法成为潜在客户的情况，以及不符合条件的原因。

参数

名称 类型 是否必须提供 示例值 说明
currency string 是* 美元 相应活动的 value 所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。

* 如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value number 是* 30.03 与事件相关的货币价值。

*为了生成有意义的报告，通常必须提供 value。如果您将事件标记为关键事件，则建议您设置 value。
*如果设置 value，则必须提供 currency。
disqualified_lead_reason string 否 不打算购买 潜在客户被标记为不符合条件的原因。

示例

earn_virtual_currency

此事件将衡量用户在游戏中获得虚拟货币的情况。请在记录此事件时一同记录 spend_virtual_currency 事件，以便更好地了解您的虚拟经济情况。

参数

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

示例

generate_lead

此事件将衡量带来潜在客户的情况（例如，通过表单）。请记录此事件，以了解营销广告系列的效果，以及向潜在客户进行再营销后吸引了多少客户重新与您的商家互动。

参数

名称 类型 是否必须提供 示例值 说明
currency string 是* 美元 相应活动的 value 所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。

* 如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value number 是* 30.03 与事件相关的货币价值。

*为了生成有意义的报告，通常必须提供 value。如果您将事件标记为关键事件，则建议您设置 value。
*如果设置 value，则必须提供 currency。
lead_source string 否 贸易展会 潜在客户的来源。

示例

join_group

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

参数

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

示例

level_end

此事件表示玩家完成了游戏中的某个关卡。

参数

名称 类型 是否必须提供 示例值 说明
level_name string 否 踏上征途… 关卡的名称。
success boolean 否 true 如果成功通关，则设为 true。

示例

level_start

此事件表示玩家开启了游戏中的某个关卡。

参数

名称 类型 是否必须提供 示例值 说明
level_name string 否 踏上征途… 关卡的名称。

示例

level_up

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

参数

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

示例

login

发送此事件即表示用户登录了您的网站或应用。

参数

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

示例

post_score

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

参数

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

示例

purchase

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

参数

名称 类型 是否必须提供 示例值 说明
currency string 是* USD 与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。

view_item 事件的价值指标不计入收入

* 如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value number 是* 30.03 与事件相关的货币价值。

* 将 value 设置为 items 中所有商品的 (price * quantity) 之和。请勿包含 shipping 或 tax。
* 为了生成有意义的报告，通常必须提供 value。如果您将事件标记为关键事件，则建议您设置 value。
* 如果设置 value，则必须提供 currency。
customer_type string (new / returning) 否 新 转化来自“新”客户还是“回访”客户？
  • new：客户是在一定时间段内（建议使用默认的流失界定时限，即 540 天，但对此不作强制要求）未购买商品的新客户。
  • returning：客户是在指定时间段内购买了商品的回头客。

如果有不确定性（例如，用户以游客身份结账），请勿指定值。
transaction_id string 是 T_12345 交易的唯一标识符。

transaction_id 参数有助于避免出现重复的购买事件。
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 参数彼此独立。
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 否 ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID） 与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。
注意：`location id` 仅适用于商品级范围。
price number 否 10.01 商品的货币单价（以指定的 currency 参数为单位）。
如果商品有折扣，请将 price 设置为折扣后的单价，并在 discount 参数中指定单价折扣。
quantity number 否 3

商品数量。

如果未设置，quantity 将设置为 1。
除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

示例

qualify_lead

此事件衡量的是用户被标记为符合成为合格潜在客户的条件的情况。

参数

名称 类型 是否必须提供 示例值 说明
currency string 是* 美元 相应活动的 value 所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。

* 如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value number 是* 30.03 与事件相关的货币价值。

*为了生成有意义的报告，通常必须提供 value。如果您将事件标记为关键事件，则建议您设置 value。
*如果设置 value，则必须提供 currency。

示例

refund

此事件表示向用户退回一件或多件商品的款项。

参数

名称 类型 是否必须提供 示例值 说明
currency string 是* USD 与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。

view_item 事件的价值指标不计入收入

* 如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
transaction_id string 是 T_12345 交易的唯一标识符。
value number 是* 30.03 与事件相关的货币价值。

* 将 value 设置为 items 中所有商品的 (price * quantity) 之和。请勿包含 shipping 或 tax。
* 为了生成有意义的报告，通常必须提供 value。如果您将事件标记为关键事件，则建议您设置 value。
* 如果设置 value，则必须提供 currency。
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 参数彼此独立。
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 否 ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID） 与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。
注意：`location id` 仅适用于商品级范围。
price number 否 10.01 商品的货币单价（以指定的 currency 参数为单位）。
如果商品有折扣，请将 price 设置为折扣后的单价，并在 discount 参数中指定单价折扣。
quantity number 否 3

商品数量。

如果未设置，quantity 将设置为 1。
除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

示例

remove_from_cart

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

参数

名称 类型 是否必须提供 示例值 说明
currency string 是* USD 与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。

view_item 事件的价值指标不计入收入

* 如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value number 是* 30.03 与事件相关的货币价值。

* 将 value 设置为 items 中所有商品的 (price * quantity) 之和。请勿包含 shipping 或 tax。
* 为了生成有意义的报告，通常必须提供 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 参数彼此独立。
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 否 ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID） 与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。
注意：`location id` 仅适用于商品级范围。
price number 否 10.01 商品的货币单价（以指定的 currency 参数为单位）。
如果商品有折扣，请将 price 设置为折扣后的单价，并在 discount 参数中指定单价折扣。
quantity number 否 3

商品数量。

如果未设置，quantity 将设置为 1。
除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

示例

记录此事件，以表明用户何时执行了搜索。您可以使用此事件来确定用户在您的网站或应用上搜索的内容。例如，如果用户在执行搜索后查看了搜索结果页，您就可以发送此事件。

参数

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

示例

select_content

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

参数

名称 类型 是否必须提供 示例值 说明
content_type string 否 产品 所选内容的类型。
content_id string 否 C_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 参数彼此独立。
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 否 ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID） 与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。
注意：`location id` 仅适用于商品级范围。
price number 否 10.01 商品的货币单价（以指定的 currency 参数为单位）。
如果商品有折扣，请将 price 设置为折扣后的单价，并在 discount 参数中指定单价折扣。
quantity number 否 3

商品数量。

如果未设置，quantity 将设置为 1。
除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

示例

select_promotion

此事件表示从列表中选择了推广活动。

参数

名称 类型 是否必须提供 示例值 说明
creative_name string 否 summer_banner2 促销广告素材的名称。

如果在商品级别进行设置，系统会忽略此参数。
creative_slot string 否 featured_app_1 与事件相关的促销广告素材投放到的广告位的名称。

如果在商品级别进行设置，系统会忽略此参数。
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 参数彼此独立。
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 否 ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID） 与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。
注意：`location id` 仅适用于商品级范围。
price number 否 10.01 商品的货币单价（以指定的 currency 参数为单位）。
如果商品有折扣，请将 price 设置为折扣后的单价，并在 discount 参数中指定单价折扣。
promotion_id string 否 P_12345 与商品相关的促销活动的 ID。

如果设置此参数，系统会忽略事件级 promotion_id。
如果未设置此参数，系统会使用事件级 promotion_id（如果存在）。
promotion_name string 否 夏季促销 与商品相关的促销活动的名称。

如果设置此参数，系统会忽略事件级 promotion_name。
如果未设置此参数，系统会使用事件级 promotion_name（如果存在）。
quantity number 否 3

商品数量。

如果未设置，quantity 将设置为 1。
除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

示例

share

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

参数

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

示例

sign_up

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

参数

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

示例

spend_virtual_currency

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

参数

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

示例

tutorial_begin

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

参数

此事件没有任何参数。

示例

tutorial_complete

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

参数

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

示例

unlock_achievement

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

参数

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

示例

view_cart

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

参数

名称 类型 是否必须提供 示例值 说明
currency string 是* USD 与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。

view_item 事件的价值指标不计入收入

* 如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value number 是* 30.03 与事件相关的货币价值。

* 将 value 设置为 items 中所有商品的 (price * quantity) 之和。请勿包含 shipping 或 tax。
* 为了生成有意义的报告，通常必须提供 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 参数彼此独立。
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 否 ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID） 与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。
注意：`location id` 仅适用于商品级范围。
price number 否 10.01 商品的货币单价（以指定的 currency 参数为单位）。
如果商品有折扣，请将 price 设置为折扣后的单价，并在 discount 参数中指定单价折扣。
quantity number 否 3

商品数量。

如果未设置，quantity 将设置为 1。
除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

示例

view_item

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

参数

名称 类型 是否必须提供 示例值 说明
currency string 是* USD 与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。

view_item 事件的价值指标不计入收入

* 如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value number 是* 30.03 与事件相关的货币价值。

* 将 value 设置为 items 中所有商品的 (price * quantity) 之和。请勿包含 shipping 或 tax。
* 为了生成有意义的报告，通常必须提供 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 参数彼此独立。
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 否 ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID） 与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。
注意：`location id` 仅适用于商品级范围。
price number 否 10.01 商品的货币单价（以指定的 currency 参数为单位）。
如果商品有折扣，请将 price 设置为折扣后的单价，并在 discount 参数中指定单价折扣。
quantity number 否 3

商品数量。

如果未设置，quantity 将设置为 1。
除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

示例

view_item_list

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

参数

名称 类型 是否必须提供 示例值 说明
currency string 是* USD 与事件相关的商品所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。

view_item 事件的价值指标不计入收入

* 如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
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 参数彼此独立。
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 否 ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID） 与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。
注意：`location id` 仅适用于商品级范围。
price number 否 10.01 商品的货币单价（以指定的 currency 参数为单位）。
如果商品有折扣，请将 price 设置为折扣后的单价，并在 discount 参数中指定单价折扣。
quantity number 否 3

商品数量。

如果未设置，quantity 将设置为 1。
除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

示例

view_promotion

此事件表示从列表查看了推广活动。

参数

名称 类型 是否必须提供 示例值 说明
creative_name string 否 summer_banner2 促销广告素材的名称。

如果在商品级别进行设置，系统会忽略此参数。
creative_slot string 否 featured_app_1 与事件相关的促销广告素材投放到的广告位的名称。

如果在商品级别进行设置，系统会忽略此参数。
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 参数彼此独立。
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 否 ChIJIQBpAG2ahYAR_6128GcTUEo（旧金山对应的 Google 地点 ID） 与商品关联的实际位置（例如实体店）。建议使用与相关商品对应的 Google 地点 ID，也可使用自定义地理位置 ID。
注意：`location id` 仅适用于商品级范围。
price number 否 10.01 商品的货币单价（以指定的 currency 参数为单位）。
如果商品有折扣，请将 price 设置为折扣后的单价，并在 discount 参数中指定单价折扣。
promotion_id string 否 P_12345 与商品相关的促销活动的 ID。

如果设置此参数，系统会忽略事件级 promotion_id。
如果未设置此参数，系统会使用事件级 promotion_id（如果存在）。
promotion_name string 否 夏季促销 与商品相关的促销活动的名称。

如果设置此参数，系统会忽略事件级 promotion_name。
如果未设置此参数，系统会使用事件级 promotion_name（如果存在）。
quantity number 否 3

商品数量。

如果未设置，quantity 将设置为 1。
除这些指定参数外，您还可以在 items 数组中加入最多 27 个自定义参数。

示例

working_lead

此事件衡量的是用户联系代表或代表联系用户这一操作。

参数

名称 类型 是否必须提供 示例值 说明
currency string 是* 美元 相应活动的 value 所用的币种（采用由 3 个字母表示的 ISO 4217 格式）。

* 如果设置 value，则必须提供 currency，这样才能准确计算收入指标。
value number 是* 30.03 与事件相关的货币价值。

*为了生成有意义的报告，通常必须提供 value。如果您将事件标记为关键事件，则建议您设置 value。
*如果设置 value，则必须提供 currency。
lead_status string 否 已开始的对话 潜在客户的状态。

示例