使用 gtag.js 收集增强型电子商务数据

本页介绍了如何使用 gtag.js 收集增强型电子商务数据。

如果您在 gtag.js 中配置了 Google Analytics(分析),并且在 Google Analytics(分析)中启用了增强型电子商务功能,则可以使用 gtag.js 将展示次数数据、商品数据、促销数据和操作数据发送给 Google Analytics(分析)。

要查看与电子商务相关的事件列表,请参阅 gtag.js 事件参考

展示数据

以下商品参数表示被查看的商品的相关信息。

商品参数 数据类型 是否必须提供 说明
id string 是* 商品的唯一 ID/SKU。
name string 是* 商品名称。
list_name string 呈现给用户的商品所在列表
brand string 商品的品牌
category string 商品类别
variant string 商品款式
list_position integer 商品在列表中的位置
price currency 商品的购买价格

*idname 必须至少设置其中之一。

商品数据

如果执行了查看商品、将商品添加到购物车等操作,以下商品参数表示该商品的相关信息:

商品参数 数据类型 是否必须提供 说明
id string 是* 商品的唯一 ID/SKU。
name string 是* 商品名称。
brand string 商品的品牌
category string 商品类别
variant string 商品款式
price currency 商品的购买价格
quantity integer 商品数量
coupon string 可购买商品的优惠券代码
list_position integer 商品在列表中的位置

*idname 必须至少设置其中之一。

促销数据

以下促销参数表示已查看的促销活动的相关信息:

促销参数 数据类型 是否必须提供 说明
id string 是* 促销活动 ID。
name string 是* 促销名称。
creative_name string 使用的广告素材的名称
creative_slot string 广告素材位置的名称

*idname 必须至少设置其中之一。

操作数据

以下事件参数和商品参数表示发生的电子商务相关操作的信息。

事件参数 数据类型 是否必须提供 说明
transaction_id string 是* 交易的唯一 ID。
affiliation string 发生此交易的商店或关联商户
value number 与事件相关的价值(即收入)
tax currency 税额
shipping currency 运费
items array 包含相关商品的阵列
checkout_step number 结帐过程中的步骤(编号)
checkout_option string 结帐选项(即选定的付款方式)

*purchaserefund 必须至少填写其中之一。

商品参数 数据类型 是否必须提供 说明
coupon string 可购买商品的优惠券代码

商品和促销操作

以下操作(事件)指定应当如何解读您发送到 Google Analytics(分析)的商品和促销数据:

事件 说明
select_content 对某个产品的点击,或是对一个或多个产品的链接的点击。
view_item 查看产品详情。
add_to_cart 将一个或多个商品添加到购物车。
remove_from_cart 从购物车中移除一个或多个商品。
begin_checkout 开始一个或多个商品的结帐流程。
set_checkout_option 发送某个结帐步骤的选项值。
purchase 购买一个或多个产品。
refund 为一个或多个产品退款。
view_promotion 对内部促销信息的点击。

跟踪商品展示

要跟踪商品的展示情况,请发送包含相应商品信息的 view_item_list

gtag('event', 'view_item_list', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": 3
    }
  ]
});

跟踪商品点击

要跟踪某次商品点击,请发送 select_content 事件,将 product 指定为 content_type,并提供相应的商品信息:

gtag('event', 'select_content', {
  "content_type": "product",
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    }
  ]
});

跟踪商品详情查看

点击商品列表后,用户可能会查看商品详情页面。要跟踪商品详情的查看情况,请发送包含相应商品详情的 view_item 事件:

gtag('event', 'view_item', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

跟踪将商品添加到购物车或从购物车中移除商品的操作

要跟踪将商品添加到购物车的操作,请发送包含相应商品信息的 add_to_cart 事件:

gtag('event', 'add_to_cart', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

要跟踪从购物车中移除商品的操作,请发送包含相应商品信息的 remove_from_cart 事件:

gtag('event', 'remove_from_cart', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

跟踪促销信息展示

要跟踪促销信息的展示情况,请发送包含相应促销信息的 view_promotion 事件:

gtag('event', 'view_promotion', {
  "promotions": [
    {
      "id": "abc123",
      "name": "summer_promo"
    },
    {
      "id": "xyz987",
      "name": "spring savings"
    }
  ]
});

跟踪促销信息点击

要跟踪某次促销信息点击,请发送 select_content 事件并提供相应的促销信息:

gtag('event', 'select_content', {
  "promotions": [
    {
      "id": "abc123",
      "name": "summer_promo"
    }
  ]
});

跟踪结帐操作

要跟踪结帐流程中的每一步,您需要执行以下操作:

  1. 添加跟踪代码,以衡量结帐流程中的每一步。
  2. 如果适用,添加跟踪代码以衡量结帐选项。

1. 跟踪结帐步骤

要跟踪结帐的第一步,请发送包含相应结帐商品的 begin_checkout 事件:

gtag('event', 'begin_checkout', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ],
  "coupon": ""
});

要跟踪之后的每个结帐步骤,请发送包含相应结帐商品的 checkout_progress 事件:

gtag('event', 'checkout_progress', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ],
  "coupon": "SUMMER_DISCOUNT"
});

2. 跟踪结帐选项

要跟踪某个结帐选项,请发送包含相应结帐选项的 set_checkout_option 事件:

gtag('event', 'set_checkout_option', {
  "checkout_step": 1,
  "checkout_option": "shipping method",
  "value": "USPS"
});

跟踪购买情况

要跟踪某笔交易,请发送包含该笔交易所涉及商品的 purchase 事件:

gtag('event', 'purchase', {
  "transaction_id": "24.031608523954162",
  "affiliation": "Google online store",
  "value": 23.07,
  "currency": "USD",
  "tax": 1.24,
  "shipping": 0,
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": '3.0'
    }
  ]
});

跟踪退款情况

要跟踪某笔交易的全额退款情况,请发送包含相应交易 ID 的 refund 事件:

gtag('event', 'refund', { "transaction_id": "T12345" })

要跟踪部分退款情况,请发送包含相应交易 ID 和退款商品的 refund 事件:

gtag('event', 'refund', {
  "transaction_id": "79.18502354114992",
  "affiliation": "Google online store",
  "value": 23.07,
  "currency": "USD",
  "tax": 1.24,
  "shipping": 0,
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": '3.0'
    }
  ]
});