跟踪代码：电子商务

ga.js 是一个旧版库。如果您要启动一个新的实现，我们建议您使用此库的最新版本 analytics.js。对于现有实现，请了解如何从 ga.js 迁移到 analytics.js。

注意：本参考文档介绍了您在 Google Analytics（分析）报告中用于电子商务的方法。有关设置电子商务跟踪的更多信息，请参阅电子商务跟踪。

GATC 电子商务方法

• _addItem(transactionId, sku, name, category, price, quantity)
• _addTrans(transactionId, affiliation, total, tax, shipping, city, state, country)
• _trackTrans()

方法详解

_addItem()

_addItem(transactionId, sku, name, category, price, quantity)

使用此方法可以跟踪您电子商务网站的访问者购买的商品。此方法按商品 SKU 跟踪各个商品。这意味着 sku 参数是必需的。 然后，此方法通过 transactionId 参数将商品与父交易对象相关联。

此方法的参数按位置进行匹配，因此请务必提供所有参数，即使其中某些参数为空值也是如此。

此方法不会执行其他计算，例如数量计算。因此，您应牢记以下最佳做法：

• 使用您自己的软件计算数量。
  • 在同一会话中，（按 SKU）添加的重复项不会影响数量的计算。
  • 在同一会话中，如果添加了两个具有相同 SKU 的项目，则第一项信息会被替换为第二项信息。
• 确保商品目录中的每件商品都有唯一的 SKU。
  • 如果您的库存中的两种不同物品具有相同的 SKU，并且访问者同时购买了这两种物品，则您将只会收到最近添加的物品的数据。
• 请务必为添加的商品设置父级交易对象。
  • 如果添加的物品不存在父级交易对象，则该物品会被附加到一个空交易对象。
  • 如果在添加某件商品时没有父级交易对象，您的报告将按 SKU 显示未与任何交易关联的商品。
• 始终为 name 参数提供值。
  • 虽然 name 参数不是必需的，但如果添加到交易中的商品不带 name 参数，该商品将不会显示在某笔交易的产品细分中。虽然您仍可以看到交易的总收入，但无法查看特定商品为交易总额贡献了多少收入。

   _gaq.push(['_addItem',
      '1234',         // transaction ID - necessary to associate item with transaction
      'DD44',         // SKU/code - required
      'T-Shirt',      // product name - necessary to associate revenue with product
      'Olive Medium', // category or variation
      '11.99',        // unit price - required
      '1'             // quantity - required
   ]);

形参

String   transactionId 可选：要与商品关联的交易的订单 ID。
String   sku 必需。商品的 SKU 代码。
String   name 必需。产品名称。必须填写此字段，才能查看商品详情报告中的数据。
String   category 可选。产品类别。
String   price 必需。产品价格。
String   quantity 必需。购买数量。

---

_addTrans()

_addTrans(transactionId, affiliation, total, tax, shipping, city, state, country)

使用指定值创建交易对象。与 _addItem() 一样，此方法仅处理交易跟踪，不提供其他电子商务功能。因此，如果事务与该会话中现有事务重复，则旧事务值将被新事务值覆盖。此方法的参数按位置进行匹配，因此请务必提供所有参数，即使其中某些参数为空值也是如此。

   _gaq.push(['_addTrans',
      '1234',           // transaction ID - required
      'Womens Apparel', // affiliation or store name
      '28.28',          // total - required; Shown as "Revenue" in the
                        // Transactions report. Does not include Tax and Shipping.
      '1.29',           // tax
      '15.00',          // shipping
      'San Jose',       // city
      'California',     // state or province
      'USA'             // country
   ]);

形参

String   transactionId 必需。 此交易的内部唯一交易 ID 号。
String   affiliation 可选。合作伙伴或商店关联（如果不存在则未定义）。
String   total 必需。 交易的总金额。不含税费和运费，只有在您明确包含运费和税费的情况下，才应将其视为“总金额”。
String   tax 可选。交易的税额。
String   shipping 可选。交易的运费。
String   city 可选。与交易相关的城市。
String   state 可选。与交易相关的状态。
String   country 可选。与交易关联的国家/地区。

返回

_gat.GA_EComm_.Transactions_ 所创建或修改的交易对象。

注意：可包含在交易对象中的可选地理位置信息不会用于填充 Google Analytics（分析）报告中的地理位置数据，但可以在数据视图过滤器中使用。

---

_trackTrans()

_trackTrans()

将交易和商品数据都发送到 Google Analytics（分析）服务器。 此方法应在 _trackPageview() 之后调用，并与 _addItem() 和 addTrans() 方法结合使用。 此方法应在设置商品和交易元素之后调用。

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);
_gaq.push(['_addTrans',
   '1234',           // transaction ID - required
   'Womens Apparel', // affiliation or store name
   '28.28',          // total - required
   '1.29',           // tax
   '15.00',          // shipping
   'San Jose',       // city
   'California',     // state or province
   'USA'             // country
]);
_gaq.push(['_addItem',
   '1234',           // transaction ID - necessary to associate item with transaction
   'DD44',           // SKU/code - required
   'T-Shirt',        // product name
   'Olive Medium',   // category or variation
   '11.99',          // unit price - required
   '1'               // quantity - required
]);
_gaq.push(['_trackTrans']);

---