Google Analytics 4会将某些事件类型 自动创建。当前页面 描述您可以配置的其他可选事件, 并为您的业务生成更实用的报告。这些额外的 事件在配置上需要花费更多精力,然后才能使用 Analytics 4 无法自动发送这些数据。如需获取有关如何创建 来为您的网站或应用配置推荐事件和自定义事件,请参阅设置 事件。
如需查看您可以使用的每个事件的详细信息,请选择您的代码管理平台:
add_payment_info
此事件表示用户在电子商务结账流程中提交了自己的付款信息。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
currency |
string |
是* | USD |
与事件相关的商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 *如果设置 value ,则必须提供 currency ,这样才能准确计算收入指标。
|
value |
number |
是* | 30.03 | 与事件相关的货币价值。 * 将 value 设置为所有项的 (price * quantity) 的总和
items 。请勿添加 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_name |
string |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
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 |
否 | 商品所属品牌。 | |
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 |
商品的货币单位价格(采用指定货币的单位)
参数。
如果折扣适用于商品,请将 price 设置为折扣的单价,
在 discount 参数中指定单价折扣。
|
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 3 |
商品数量。 |
items
数组中加入最多 27 个自定义参数。
示例
add_shipping_info
此事件表示用户在电子商务结账流程中提交了自己的配送信息。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
currency |
string |
是* | USD |
与事件相关的商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 *如果设置 value ,则必须提供 currency ,这样才能准确计算收入指标。
|
value |
number |
是* | 30.03 | 与事件相关的货币价值。 * 将 value 设置为所有项的 (price * quantity) 的总和
items 。请勿添加 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_name |
string |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
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 |
否 | 商品所属品牌。 | |
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 |
商品的货币单位价格(采用指定货币的单位)
参数。
如果折扣适用于商品,请将 price 设置为折扣的单价,
在 discount 参数中指定单价折扣。
|
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 3 |
商品数量。 |
items
数组中加入最多 27 个自定义参数。
示例
add_to_cart
此事件表示商品已添加到购物车,可供购买。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
currency |
string |
是* | USD |
与事件相关的商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 *如果设置 value ,则必须提供 currency ,这样才能准确计算收入指标。
|
value |
number |
是* | 30.03 | 与事件相关的货币价值。 * 将 value 设置为所有项的 (price * quantity) 的总和
items 。请勿添加 shipping 或 tax 。
* 如需生成有意义的报告,通常必须提供 value 。
如果您将
指定为转化,建议您将
value 。
* 如果设置 value ,则 currency 是必需的。
|
items |
Array<Item> |
是 | 与事件相关的商品。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
item_id |
string |
是* | SKU_12345 |
商品的 ID。
*必须提供 |
item_name |
string |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
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 |
否 | 商品所属品牌。 | |
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 |
商品的货币单位价格(采用指定货币的单位)
参数。
如果折扣适用于商品,请将 price 设置为折扣的单价,
在 discount 参数中指定单价折扣。
|
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 3 |
商品数量。 |
items
数组中加入最多 27 个自定义参数。
示例
add_to_wishlist
此事件表示商品已添加到心愿单。使用此事件可找出您应用中的热门礼品。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
currency |
string |
是* | USD |
与事件相关的商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 *如果设置 value ,则必须提供 currency ,这样才能准确计算收入指标。
|
value |
number |
是* | 30.03 | 与事件相关的货币价值。 * 将 value 设置为所有项的 (price * quantity) 的总和
items 。请勿添加 shipping 或 tax 。
* 如需生成有意义的报告,通常必须提供 value 。
如果您将
指定为转化,建议您将
value 。
* 如果设置 value ,则 currency 是必需的。
|
items |
Array<Item> |
是 | 与事件相关的商品。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
item_id |
string |
是* | SKU_12345 |
商品的 ID。
*必须提供 |
item_name |
string |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
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 |
否 | 商品所属品牌。 | |
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 |
商品的货币单位价格(采用指定货币的单位)
参数。
如果折扣适用于商品,请将 price 设置为折扣的单价,
在 discount 参数中指定单价折扣。
|
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 3 |
商品数量。 |
items
数组中加入最多 27 个自定义参数。
示例
begin_checkout
此事件表示用户已开始结账流程。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
currency |
string |
是* | USD |
与事件相关的商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 *如果设置 value ,则必须提供 currency ,这样才能准确计算收入指标。
|
value |
number |
是* | 30.03 | 与事件相关的货币价值。 * 将 value 设置为所有项的 (price * quantity) 的总和
items 。请勿添加 shipping 或 tax 。
* 如需生成有意义的报告,通常必须提供 value 。
如果您将
指定为转化,建议您将
value 。
* 如果设置 value ,则 currency 是必需的。
|
coupon |
string |
否 | SUMMER_FUN | 与事件相关的优惠券名称/代码。 事件级和商品级 coupon 参数彼此独立。
|
items |
Array<Item> |
是 | 与事件相关的商品。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
item_id |
string |
是* | SKU_12345 |
商品的 ID。
*必须提供 |
item_name |
string |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
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 |
否 | 商品所属品牌。 | |
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 |
商品的货币单位价格(采用指定货币的单位)
参数。
如果折扣适用于商品,请将 price 设置为折扣的单价,
在 discount 参数中指定单价折扣。
|
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 3 |
商品数量。 |
items
数组中加入最多 27 个自定义参数。
示例
close_convert_lead
此事件将衡量潜在客户完成转化并达成交易的时间(例如, )。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
currency |
string |
是* | USD |
与事件相关的商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 *如果设置 value ,则必须提供 currency ,这样才能准确计算收入指标。
|
value |
number |
是* | 30.03 | 与事件相关的货币价值。 * 将 value 设置为所有项的 (price * quantity) 的总和
items 。请勿添加 shipping 或 tax 。
* 如需生成有意义的报告,通常必须提供 value 。
如果您将
指定为转化,建议您将
value 。
* 如果设置 value ,则 currency 是必需的。
|
items |
Array<Item>
|
否 | 与事件相关的商品。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
item_id |
string |
是* | SKU_12345 |
商品的 ID。
*必须提供 |
item_name |
string |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
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 |
否 | 商品所属品牌。 | |
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 |
商品的货币单位价格(采用指定货币的单位)
参数。
如果折扣适用于商品,请将 price 设置为折扣的单价,
在 discount 参数中指定单价折扣。
|
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 3 |
商品数量。 |
items
数组中加入最多 27 个自定义参数。
示例
close_unconvert_lead
此事件将衡量用户被标记为未成为完成转化的潜在客户的情况, 以及原因
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
currency |
string |
是* | USD |
与事件相关的商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 *如果设置 value ,则必须提供 currency ,这样才能准确计算收入指标。
|
value |
number |
是* | 30.03 | 与事件相关的货币价值。 * 将 value 设置为所有项的 (price * quantity) 的总和
items 。请勿添加 shipping 或 tax 。
* 如需生成有意义的报告,通常必须提供 value 。
如果您将
指定为转化,建议您将
value 。
* 如果设置 value ,则 currency 是必需的。
|
unconvert_lead_reason |
string |
否 | 从未回复 | 潜在客户未完成转化的原因。 |
items |
Array<Item>
|
否 | 与事件相关的商品。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
item_id |
string |
是* | SKU_12345 |
商品的 ID。
*必须提供 |
item_name |
string |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
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 |
否 | 商品所属品牌。 | |
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 |
商品的货币单位价格(采用指定货币的单位)
参数。
如果折扣适用于商品,请将 price 设置为折扣的单价,
在 discount 参数中指定单价折扣。
|
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 3 |
商品数量。 |
items
数组中加入最多 27 个自定义参数。
示例
disqualify_lead
此事件将衡量以下情况:用户被标记为不符合成为潜在客户的条件, 以及被取消资格的原因
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
currency |
string |
是* | USD |
与事件相关的商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 *如果设置 value ,则必须提供 currency ,这样才能准确计算收入指标。
|
value |
number |
是* | 30.03 | 与事件相关的货币价值。 * 将 value 设置为所有项的 (price * quantity) 的总和
items 。请勿添加 shipping 或 tax 。
* 如需生成有意义的报告,通常必须提供 value 。
如果您将
指定为转化,建议您将
value 。
* 如果设置 value ,则 currency 是必需的。
|
disqualified_lead_reason |
string |
否 | 不想购买 | 潜在客户被标记为不符合条件的原因。 |
items |
Array<Item>
|
否 | 与事件相关的商品。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
item_id |
string |
是* | SKU_12345 |
商品的 ID。
*必须提供 |
item_name |
string |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
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 |
否 | 商品所属品牌。 | |
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 |
商品的货币单位价格(采用指定货币的单位)
参数。
如果折扣适用于商品,请将 price 设置为折扣的单价,
在 discount 参数中指定单价折扣。
|
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 3 |
商品数量。 |
items
数组中加入最多 27 个自定义参数。
示例
earn_virtual_currency
此事件将衡量用户在游戏中获得虚拟货币的情况。请在记录此事件时一同记录 spend_virtual_currency 事件,以便更好地了解您的虚拟经济情况。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
virtual_currency_name |
string |
否 | 宝石 | 虚拟货币的名称。 |
value |
number |
否 | 5 | 虚拟货币的价值。 |
示例
generate_lead
此事件将衡量带来潜在客户的情况(例如,通过表单)。请记录此事件,以了解营销广告系列的效果,以及向潜在客户进行再营销后吸引了多少客户重新与您的商家互动。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
currency |
string |
是* | USD |
与事件相关的商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 *如果设置 value ,则必须提供 currency ,这样才能准确计算收入指标。
|
value |
number |
是* | 30.03 | 与事件相关的货币价值。 * 将 value 设置为所有项的 (price * quantity) 的总和
items 。请勿添加 shipping 或 tax 。
* 如需生成有意义的报告,通常必须提供 value 。
如果您将
指定为转化,建议您将
value 。
* 如果设置 value ,则 currency 是必需的。
|
lead_source |
string |
否 | 商展 | 潜在客户的来源。 |
items |
Array<Item>
|
否 | 与事件相关的商品。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
item_id |
string |
是* | SKU_12345 |
商品的 ID。
*必须提供 |
item_name |
string |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
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 |
否 | 商品所属品牌。 | |
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 |
商品的货币单位价格(采用指定货币的单位)
参数。
如果折扣适用于商品,请将 price 设置为折扣的单价,
在 discount 参数中指定单价折扣。
|
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 3 |
商品数量。 |
items
数组中加入最多 27 个自定义参数。
示例
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 |
否 | 登录时所用的方法。 |
示例
post_score
在用户发布得分时发送此事件。使用此事件可了解用户在您游戏中的表现,并将最高得分与受众群体或行为关联起来。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
score |
number |
是 | 10000 | 要发布的得分。 |
level |
number |
否 | 5 | 得分对应的关卡。 |
character |
string |
否 | 玩家 1 | 获得相应得分的角色。 |
示例
purchase
此事件表示用户已购买一件或多件商品。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
currency |
string |
是* | USD |
与事件相关的商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 *如果设置 value ,则必须提供 currency ,这样才能准确计算收入指标。
|
value |
number |
是* | 30.03 | 与事件相关的货币价值。 * 将 value 设置为所有项的 (price * quantity) 的总和
items 。请勿添加 shipping 或 tax 。
* 如需生成有意义的报告,通常必须提供 value 。
如果您将
指定为转化,建议您将
value 。
* 如果设置 value ,则 currency 是必需的。
|
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_name |
string |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
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 |
否 | 商品所属品牌。 | |
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 |
商品的货币单位价格(采用指定货币的单位)
参数。
如果折扣适用于商品,请将 price 设置为折扣的单价,
在 discount 参数中指定单价折扣。
|
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 3 |
商品数量。 |
items
数组中加入最多 27 个自定义参数。
示例
qualify_lead
此事件将衡量用户被标记为满足成为 符合条件的潜在客户。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
currency |
string |
是* | USD |
与事件相关的商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 *如果设置 value ,则必须提供 currency ,这样才能准确计算收入指标。
|
value |
number |
是* | 30.03 | 与事件相关的货币价值。 * 将 value 设置为所有项的 (price * quantity) 的总和
items 。请勿添加 shipping 或 tax 。
* 如需生成有意义的报告,通常必须提供 value 。
如果您将
指定为转化,建议您将
value 。
* 如果设置 value ,则 currency 是必需的。
|
items |
Array<Item>
|
否 | 与事件相关的商品。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
item_id |
string |
是* | SKU_12345 |
商品的 ID。
*必须提供 |
item_name |
string |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
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 |
否 | 商品所属品牌。 | |
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 |
商品的货币单位价格(采用指定货币的单位)
参数。
如果折扣适用于商品,请将 price 设置为折扣的单价,
在 discount 参数中指定单价折扣。
|
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 3 |
商品数量。 |
items
数组中加入最多 27 个自定义参数。
示例
refund
此事件表示向用户退回一件或多件商品的款项。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
currency |
string |
是* | USD |
与事件相关的商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 *如果设置 value ,则必须提供 currency ,这样才能准确计算收入指标。
|
transaction_id |
string |
是 | T_12345 | 交易的唯一标识符。 |
value |
number |
是* | 30.03 | 与事件相关的货币价值。 * 将 value 设置为所有项的 (price * quantity) 的总和
items 。请勿添加 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_name |
string |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
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 |
否 | 商品所属品牌。 | |
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 |
商品的货币单位价格(采用指定货币的单位)
参数。
如果折扣适用于商品,请将 price 设置为折扣的单价,
在 discount 参数中指定单价折扣。
|
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 3 |
商品数量。 |
items
数组中加入最多 27 个自定义参数。
示例
remove_from_cart
此事件表示商品已从购物车中移除。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
currency |
string |
是* | USD |
与事件相关的商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 *如果设置 value ,则必须提供 currency ,这样才能准确计算收入指标。
|
value |
number |
是* | 30.03 | 与事件相关的货币价值。 * 将 value 设置为所有项的 (price * quantity) 的总和
items 。请勿添加 shipping 或 tax 。
* 如需生成有意义的报告,通常必须提供 value 。
如果您将
指定为转化,建议您将
value 。
* 如果设置 value ,则 currency 是必需的。
|
items |
Array<Item> |
是 | 与事件相关的商品。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
item_id |
string |
是* | SKU_12345 |
商品的 ID。
*必须提供 |
item_name |
string |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
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 |
否 | 商品所属品牌。 | |
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 |
商品的货币单位价格(采用指定货币的单位)
参数。
如果折扣适用于商品,请将 price 设置为折扣的单价,
在 discount 参数中指定单价折扣。
|
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 3 |
商品数量。 |
items
数组中加入最多 27 个自定义参数。
示例
search
记录此事件,以表明用户何时执行了搜索。您可以使用此事件来确定用户在您的网站或应用上搜索的内容。例如,如果用户在执行搜索后查看了搜索结果页,您就可以发送此事件。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
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_name |
string |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
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 |
否 | 商品所属品牌。 | |
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 |
商品的货币单位价格(采用指定货币的单位)
参数。
如果折扣适用于商品,请将 price 设置为折扣的单价,
在 discount 参数中指定单价折扣。
|
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 3 |
商品数量。 |
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_name |
string |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
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 |
否 | 商品所属品牌。 | |
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 |
商品的货币单位价格(采用指定货币的单位)
参数。
如果折扣适用于商品,请将 price 设置为折扣的单价,
在 discount 参数中指定单价折扣。
|
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 3 |
商品数量。 |
items
数组中加入最多 27 个自定义参数。
示例
share
在用户分享了内容时使用此事件。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
method |
string |
否 | 共享内容的方法。 | |
content_type |
string |
否 | 图片 | 共享内容的类型。 |
item_id |
string |
否 | C_12345 | 共享内容的 ID。 |
示例
sign_up
此事件表示用户已注册账号。使用此事件可了解登录用户和退出用户的不同行为。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
method |
string |
否 | 注册时所用的方法。 |
示例
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 格式)。 *如果设置 value ,则必须提供 currency ,这样才能准确计算收入指标。
|
value |
number |
是* | 30.03 | 与事件相关的货币价值。 * 将 value 设置为所有项的 (price * quantity) 的总和
items 。请勿添加 shipping 或 tax 。
* 如需生成有意义的报告,通常必须提供 value 。
如果您将
指定为转化,建议您将
value 。
* 如果设置 value ,则 currency 是必需的。
|
items |
Array<Item> |
是 | 与事件相关的商品。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
item_id |
string |
是* | SKU_12345 |
商品的 ID。
*必须提供 |
item_name |
string |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
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 |
否 | 商品所属品牌。 | |
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 |
商品的货币单位价格(采用指定货币的单位)
参数。
如果折扣适用于商品,请将 price 设置为折扣的单价,
在 discount 参数中指定单价折扣。
|
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 3 |
商品数量。 |
items
数组中加入最多 27 个自定义参数。
示例
view_item
此事件表示向用户展示了某些内容。使用此事件可了解用户查看了哪些最热门商品。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
currency |
string |
是* | USD |
与事件相关的商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 *如果设置 value ,则必须提供 currency ,这样才能准确计算收入指标。
|
value |
number |
是* | 30.03 | 与事件相关的货币价值。 * 将 value 设置为所有项的 (price * quantity) 的总和
items 。请勿添加 shipping 或 tax 。
* 如需生成有意义的报告,通常必须提供 value 。
如果您将
指定为转化,建议您将
value 。
* 如果设置 value ,则 currency 是必需的。
|
items |
Array<Item> |
是 | 与事件相关的商品。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
item_id |
string |
是* | SKU_12345 |
商品的 ID。
*必须提供 |
item_name |
string |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
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 |
否 | 商品所属品牌。 | |
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 |
商品的货币单位价格(采用指定货币的单位)
参数。
如果折扣适用于商品,请将 price 设置为折扣的单价,
在 discount 参数中指定单价折扣。
|
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 3 |
商品数量。 |
items
数组中加入最多 27 个自定义参数。
示例
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_name |
string |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
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 |
否 | 商品所属品牌。 | |
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 |
商品的货币单位价格(采用指定货币的单位)
参数。
如果折扣适用于商品,请将 price 设置为折扣的单价,
在 discount 参数中指定单价折扣。
|
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 3 |
商品数量。 |
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_name |
string |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
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 |
否 | 商品所属品牌。 | |
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 |
商品的货币单位价格(采用指定货币的单位)
参数。
如果折扣适用于商品,请将 price 设置为折扣的单价,
在 discount 参数中指定单价折扣。
|
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 3 |
商品数量。 |
items
数组中加入最多 27 个自定义参数。
示例
working_lead
此事件衡量的是用户何时与销售代表联系。
参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
currency |
string |
是* | USD |
与事件相关的商品所用的币种(采用由 3 个字母表示的 ISO 4217 格式)。 *如果设置 value ,则必须提供 currency ,这样才能准确计算收入指标。
|
value |
number |
是* | 30.03 | 与事件相关的货币价值。 * 将 value 设置为所有项的 (price * quantity) 的总和
items 。请勿添加 shipping 或 tax 。
* 如需生成有意义的报告,通常必须提供 value 。
如果您将
指定为转化,建议您将
value 。
* 如果设置 value ,则 currency 是必需的。
|
lead_status |
string |
否 | 已开始的对话 | 潜在客户的状态。 |
items |
Array<Item>
|
否 | 与事件相关的商品。 |
Item 参数
名称 | 类型 | 是否必须提供 | 示例值 | 说明 |
---|---|---|---|---|
item_id |
string |
是* | SKU_12345 |
商品的 ID。
*必须提供 |
item_name |
string |
是* | Stan 和 Friends Tee |
商品的名称。
*必须提供 |
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 |
否 | 商品所属品牌。 | |
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 |
商品的货币单位价格(采用指定货币的单位)
参数。
如果折扣适用于商品,请将 price 设置为折扣的单价,
在 discount 参数中指定单价折扣。
|
promotion_id |
string |
否 | P_12345 |
与商品相关的促销活动的 ID。 如果设置此参数,系统会忽略事件级 promotion_id 。
如果未设置此参数,系统会使用事件级 promotion_id (如果存在)。
|
promotion_name |
string |
否 | 夏季促销 |
与商品相关的促销活动的名称。 如果设置此参数,系统会忽略事件级 promotion_name 。
如果未设置此参数,系统会使用事件级 promotion_name (如果存在)。
|
quantity |
number |
否 | 3 |
商品数量。 |
items
数组中加入最多 27 个自定义参数。