增强型电子商务跟踪

本文档将大略介绍如何使用 Android 版 Google Analytics(分析)SDK v4 来衡量应用内电子商务相关操作和展示。

概览

增强型电子商务功能可让您衡量用户在其购物历程中与产品的互动,包括产品展示、产品点击、查看产品详情、将产品添加到购物车、开始结帐流程、交易以及退款。

实现

增强型电子商务衡量要求您使用 HitBuilder 类及其中的方法来针对产品、展示和促销发送电子商务数据。另外还有一组 Google Analytics(分析)电子商务类供您用于构建电子商务相关信息。

使用增强型电子商务功能,您可以:

衡量电子商务活动

典型的增强型电子商务实现将会衡量产品展示次数以及以下任一操作:

  • 选择产品。
  • 查看产品详情。
  • 内部促销信息的展示和选择。
  • 向购物车中添加产品或从中移除产品。
  • 开始产品结帐流程。
  • 购买和退款。

衡量展示

要衡量产品展示,请构建 Product 对象,并使用 addImpression 方法随匹配发送此对象。Product 必须有 name 或 id 值。其他所有值都非必需,可以不用设置。

Product product = new Product()
    .setId("P12345")
    .setName("Android Warhol T-Shirt")
    .setCategory("Apparel/T-Shirts")
    .setBrand("Google")
    .setVariant("Black")
    .setPosition(1)
    .setCustomDimension(1, "Member");
HitBuilders.ScreenViewBuilder builder = new HitBuilders.ScreenViewBuilder()
    .addImpression(product, "Search Results");

Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("searchResults");
t.send(builder.build());

请参见高级配置,详细了解 getTracker 方法。

衡量操作

操作的衡量方法如下:使用 addProduct 方法和 Product 对象来添加产品详情,并使用 setProductAction 方法和 ProductAction 对象来指定用户执行的操作。

例如,以下代码衡量对搜索结果列表中展示的某个产品的选择:

Product product =  new Product()
    .setId("P12345")
    .setName("Android Warhol T-Shirt")
    .setCategory("Apparel/T-Shirts")
    .setBrand("Google")
    .setVariant("Black")
    .setPosition(1)
    .setCustomDimension(1, "Member");
ProductAction productAction = new ProductAction(ProductAction.ACTION_CLICK)
    .setProductActionList("Search Results");
HitBuilders.ScreenViewBuilder builder = new HitBuilders.ScreenViewBuilder()
    .addProduct(product)
    .setProductAction(productAction);

Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("searchResults");
t.send(builder.build());

合并展示和操作数据

既有产品展示又有操作时,可以将两者合并到同一次匹配中进行衡量。

下例显示了如何衡量一次在相关产品部分中的展示以及一次产品详情查看:

// The product from a related products section.
Product relatedProduct =  new Product()
    .setId("P12346")
    .setName("Android Warhol T-Shirt")
    .setCategory("Apparel/T-Shirts")
    .setBrand("Google")
    .setVariant("White")
    .setPosition(1);

// The product being viewed.
Product viewedProduct =  new Product()
    .setId("P12345")
    .setName("Android Warhol T-Shirt")
    .setCategory("Apparel/T-Shirts")
    .setBrand("Google")
    .setVariant("Black")
    .setPosition(1);

ProductAction productAction = new ProductAction(ProductAction.ACTION_DETAIL);
HitBuilders.ScreenViewBuilder builder = new HitBuilders.ScreenViewBuilder()
    .addImpression(relatedProduct, "Related Products")
    .addProduct(viewedProduct)
    .setProductAction(productAction);

Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("product");
t.send(builder.build());

衡量交易

交易的衡量方法如下:使用 addProduct 方法和 Product 对象来添加产品详情,并使用 setProductAction 方法和 ProductAction 对象来指定购买操作。总收入、税费、运费等交易级详情在 ProductAction 对象中提供:

Product product =  new Product()
    .setId("P12345")
    .setName("Android Warhol T-Shirt")
    .setCategory("Apparel/T-Shirts")
    .setBrand("Google")
    .setVariant("black")
    .setPrice(29.20)
    .setCouponCode("APPARELSALE")
    .setQuantity(1);
ProductAction productAction = new ProductAction(ProductAction.ACTION_PURCHASE)
    .setTransactionId("T12345")
    .setTransactionAffiliation("Google Store - Online")
    .setTransactionRevenue(37.39)
    .setTransactionTax(2.85)
    .setTransactionShipping(5.34)
    .setTransactionCouponCode("SUMMER2013");
HitBuilders.ScreenViewBuilder builder = new HitBuilders.ScreenViewBuilder()
    .addProduct(product)
    .setProductAction(productAction);

Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("transaction");
t.send(builder.build());

指定货币

默认情况下,您可以通过 Google Analytics(分析)的管理网络界面为所有交易和商品配置一种通用的全局货币。

局部货币必须按 ISO 4217 标准指定。如需支持的完整转换货币列表,请参阅货币代码参考文档

局部货币使用 currencyCode 跟踪器属性来指定。例如,此跟踪器将以欧元发送货币金额值:

Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("transaction");
t.set("&cu", "EUR");  // Set tracker currency to Euros.
t.send(builder.build());

衡量退款

要为整个交易退款,请使用 setProductAction 方法和 ProductAction 对象来指定交易 ID 和退款操作类型:

// Refund an entire transaction.
ProductAction productAction = new ProductAction(ProductAction.ACTION_REFUND)
    .setTransactionId("T12345");  // Transaction ID is only required field for a full refund.
HitBuilders.ScreenViewBuilder builder = new HitBuilders.ScreenViewBuilder()
    .setProductAction(productAction);

Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("refund");
t.send(builder.build());

如果未找到相符的交易,则退款将不会得到处理。

要衡量部分退款,请使用 setProductAction 方法和 ProductAction 对象来指定要退款的交易 ID、产品 ID 和产品数量:

// Refund a single product.
Product product =  new Product()
    .setId("P12345")  // Product ID is required for partial refund.
    .setQuantity(1);  // Quanity is required for partial refund.
ProductAction productAction = new ProductAction(ProductAction.ACTION_REFUND)
    .setTransactionId("T12345");  // Transaction ID is required for partial refund.
HitBuilders.ScreenViewBuilder builder = new HitBuilders.ScreenViewBuilder()
    .addProduct(product)
    .setProductAction(productAction);

Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("refundProduct");
t.send(builder.build());

为退款使用非互动事件

如果您需要使用事件来发送退款数据,但该事件不属于通常衡量的行为(即并非由用户发起),则建议您发送非互动事件。这可让特定指标免受该事件的影响。例如:

// Refund an entire transaction.
ProductAction productAction = new ProductAction(ProductAction.ACTION_REFUND)
    .setTransactionId("T12345");
HitBuilders.EventBuilder builder = new HitBuilders.EventBuilder()
    .setProductAction(productAction)
    .setNonInteraction(true)
    .setCategory("Ecommerce")
    .setAction("Refund");

Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.send(builder.build());

衡量结帐流程

为衡量结帐流程中的每个步骤,您需要:

  1. 添加跟踪代码,以衡量结帐流程中的每一步。
  2. 如果适用,添加跟踪代码以衡量结帐选项。
  3. (可选)设置直观易懂的步骤名称以用于结帐渠道报告,方法是在网页界面的“管理”部分中配置电子商务设置

1. 衡量结帐步骤

对于结帐流程中的每一步,您都需要实现相应的跟踪代码,以便向 Google Analytics(分析)发送数据。

Step 字段

对于要衡量的每一个结帐步骤,您都应加入 step 值。此值用于将结帐操作映射到您在电子商务设置中为每个步骤配置的标签。

Option 字段

在衡量某个结帐步骤时,如果您有关于此步骤的更多信息,则可以为 checkout 操作设置 option 字段来捕获此信息,例如用户的默认付款方式(如“Visa”)。

衡量某个结帐步骤

要衡量某个结帐步骤,请使用 addProduct 方法和 Product 对象来添加产品详情,并使用 setProductAction 方法和 ProductAction 对象来指示结帐操作。如果适用,还可以设置该结帐步骤的 stepoption

下例显示了如何衡量结帐流程的第一步(一个产品,拥有关于付款方式的额外信息):

Product product =  new Product()
    .setId("P12345")
    .setName("Android Warhol T-Shirt")
    .setCategory("Apparel/T-Shirts")
    .setBrand("Google")
    .setVariant("black")
    .setPrice(29.20)
    .setQuantity(1);
// Add the step number and additional info about the checkout to the action.
ProductAction productAction = new ProductAction(ProductAction.ACTION_CHECKOUT)
    .setCheckoutStep(1)
    .setCheckoutOptions("Visa");
HitBuilders.ScreenViewBuilder builder = new HitBuilders.ScreenViewBuilder()
    .addProduct(product)
    .setProductAction(productAction);

Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("checkoutStep1");
t.send(builder.build());

2. 衡量结帐选项

结帐选项可让您衡量关于结帐状态的额外信息。有时您已经衡量了某个结帐步骤,但在用户设置了选项之后,关于此步骤有了新的额外信息,在这种情况下,结帐选项就可以派上用场。例如,用户选择了送货方式。

要衡量结帐选项,请使用 setAction 来指示结帐选项,并加入步骤序号和选项说明信息。

您很可能希望在用户执行特定操作进入结帐流程中的下一步时衡量此操作。例如:

// (On "Next" button click.)
ProductAction productAction = new ProductAction(ProductAction.ACTION_CHECKOUT_OPTIONS)
    .setCheckoutStep(1)
    .setCheckoutOptions("FedEx");
HitBuilders.EventBuilder builder = new HitBuilders.EventBuilder()
    .setProductAction(productAction)
    .setCategory("Checkout")
    .setAction("Option");

Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.send(builder.build());

// Advance to next page.

3. 结帐渠道配置

您可以为结帐流程中的每一步指定一个描述性的名称,以在报告中使用。要配置此类名称,请转到 Google Analytics(分析)网络界面的管理部分,选择相应数据视图(配置文件),然后点击电子商务设置。请按照相应电子商务设置说明,为要跟踪的每个结帐步骤设置标签。

Google Analytics(分析)网页界面“管理”部分中的“电子商务设置”。开启了电子商务功能,为 4 个结帐渠道步骤指定了标签:1. 检查购物车,2. 填写付款信息,3. 确认订单详情,4. 收据
图 1:电子商务设置 - 结帐渠道

衡量内部促销

增强型电子商务功能支持对内部促销信息的展示次数和点击次数进行衡量,例如对促销活动进行宣传的横幅。

促销信息展示

内部促销信息的展示一般在初始屏幕浏览发生时衡量,并使用 addPromotion 方法和 Promotion 对象来指定促销详情。例如:

Promotion promotion = new Promotion()
    .setId("PROMO_1234")
    .setName("Summer Sale")
    .setCreative("summer_banner2")
    .setPosition("banner_slot1");
HitBuilders.ScreenViewBuilder builder = new HitBuilders.ScreenViewBuilder()
    .addPromotion(promotion);

Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("promotions");
t.send(builder.build());

促销信息点击

内部促销信息点击的衡量方法如下:使用 addPromotion 方法和 Promotion 对象以及 setProductAction 方法和 ProductAction 对象来指示促销信息点击操作。例如:

Promotion promotion = new Promotion()
    .setId("PROMO_1234")
    .setName("Summer Sale")
    .setCreative("summer_banner2")
    .setPosition("banner_slot1");
ProductAction promoClickAction = new ProductAction(Promotion.ACTION_CLICK);
HitBuilders.EventBuilder builder = new HitBuilders.EventBuilder()
    .addPromotion(promotion)
    .setProductAction(promoClickAction)
    .setCategory("Internal Promotions")
    .setAction("click")
    .setLabel("Summer Sale");

Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.send(builder.build());