事件

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_iditem_name 中的一个。

item_name string 是* Stan 和 Friends Tee

商品的名称。

*必须提供 item_iditem_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

商品数量。

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_payment_info",
      "params": {
        "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 陆运 用户为所购商品选择的配送级别(例如 GroundAirNext-day)。
items Array<Item> 与事件相关的商品。

Item 参数

名称 类型 是否必须提供 示例值 说明
item_id string 是* SKU_12345

商品的 ID。

*必须提供 item_iditem_name 中的一个。

item_name string 是* Stan 和 Friends Tee

商品的名称。

*必须提供 item_iditem_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

商品数量。

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_shipping_info",
      "params": {
        "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_iditem_name 中的一个。

item_name string 是* Stan 和 Friends Tee

商品的名称。

*必须提供 item_iditem_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

商品数量。

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_cart",
      "params": {
        "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_iditem_name 中的一个。

item_name string 是* Stan 和 Friends Tee

商品的名称。

*必须提供 item_iditem_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

商品数量。

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_wishlist",
      "params": {
        "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_iditem_name 中的一个。

item_name string 是* Stan 和 Friends Tee

商品的名称。

*必须提供 item_iditem_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

商品数量。

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "begin_checkout",
      "params": {
        "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 虚拟货币的价值。

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "earn_virtual_currency",
      "params": {
        "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

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "generate_lead",
      "params": {
        "currency": "USD",
        "value": 99.99
      }
    }]
  })
});

join_group

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

参数

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

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events":[{
      "name":"join_group",
      "params":{
        "group_id":"G_12345"
      }
    }]
  })
});

level_up

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

参数

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

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "level_up",
      "params": {
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

login

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

参数

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

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "login",
      "params": {
        "method": "Google"
      }
    }]
  })
});

post_score

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

参数

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

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "post_score",
      "params": {
        "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_iditem_name 中的一个。

item_name string 是* Stan 和 Friends Tee

商品的名称。

*必须提供 item_iditem_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

商品数量。

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "purchase",
      "params": {
        "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
          }
        ]
      }
    }]
  })
});

退款

此事件表示退款已发放。

参数

名称 类型 是否必须提供 示例值 说明
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_iditem_name 中的一个。

item_name string 是* Stan 和 Friends Tee

商品的名称。

*必须提供 item_iditem_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

商品数量。

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "refund",
      "params": {
        "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_iditem_name 中的一个。

item_name string 是* Stan 和 Friends Tee

商品的名称。

*必须提供 item_iditem_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

商品数量。

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "remove_from_cart",
      "params": {
        "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_term string T 恤 搜索的字词。

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "search",
      "params": {
        "search_term": "t-shirts"
      }
    }]
  })
});

select_content

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

参数

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

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_content",
      "params": {
        "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_iditem_name 中的一个。

item_name string 是* Stan 和 Friends Tee

商品的名称。

*必须提供 item_iditem_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

商品数量。

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_item",
      "params": {
        "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_iditem_name 中的一个。

item_name string 是* Stan 和 Friends Tee

商品的名称。

*必须提供 item_iditem_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

商品数量。

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_promotion",
      "params": {
        "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。

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "share",
      "params": {
        "method": "Twitter",
        "content_type": "image",
        "item_id": "C_12345"
      }
    }]
  })
});

sign_up

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

参数

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

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "sign_up",
      "params": {
        "method": "Google"
      }
    }]
  })
});

spend_virtual_currency

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

参数

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

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "spend_virtual_currency",
      "params": {
        "value": 5,
        "virtual_currency_name": "Gems",
        "item_name": "Starter Boost"
      }
    }]
  })
});

tutorial_begin

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

参数

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

此事件没有任何参数。

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "tutorial_begin"
    }]
  })
});

tutorial_complete

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

参数

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

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "tutorial_complete"
    }]
  })
});

unlock_achievement

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

参数

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

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "unlock_achievement",
      "params": {
        "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_iditem_name 中的一个。

item_name string 是* Stan 和 Friends Tee

商品的名称。

*必须提供 item_iditem_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

商品数量。

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_cart",
      "params": {
        "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_iditem_name 中的一个。

item_name string 是* Stan 和 Friends Tee

商品的名称。

*必须提供 item_iditem_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

商品数量。

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item",
      "params": {
        "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_iditem_name 中的一个。

item_name string 是* Stan 和 Friends Tee

商品的名称。

*必须提供 item_iditem_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

商品数量。

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item_list",
      "params": {
        "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_iditem_name 中的一个。

item_name string 是* Stan 和 Friends Tee

商品的名称。

*必须提供 item_iditem_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

商品数量。

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_promotion",
      "params": {
        "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
          }
        ]
      }
    }]
  })
});

view_search_results

向用户展示搜索结果时记录此事件。

参数

名称 类型 是否必须提供 示例值 说明
search_term string 服饰 搜索时所用的字词。

发送事件

在 GA4 Event Builder 中试用此事件

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_search_results",
      "params": {
        "search_term": "Clothing"
      }
    }]
  })
});