电子商务跟踪 - iOS SDK

本文档将大略介绍如何使用 iOS 版 Google Analytics(分析)SDK v2 来衡量应用内付款和收入。

概览

借助电子商务衡量功能,您可以向 Google Analytics(分析)发送应用内购买和销售数据。Google Analytics(分析)中的电子商务数据通常由交易和商品组成,两者通过共享的交易 ID 相关联。在 iOS 版 Google Analytics(分析)SDK 中,可通过创建交易对象并添加商品来建立这种关系。

以下报告中主要使用电子商务数据:

  • 电子商务概览
  • 产品业绩
  • 销售业绩
  • 交易次数
  • 购买前所耗时间

实现

使用 Google Analytics(分析)衡量交易分为三个步骤:

  1. 构建交易对象。
  2. 构建 item 对象,并将其添加到交易对象中。
  3. 使用 sendTransaction: 发送交易。

在以下示例中,我们假设在用户完成应用内购买后调用 onPurchaseCompleted

- (void)onPurchaseCompleted {
  GAITransaction *transaction =
      [GAITransaction transactionWithId:@"0_123456"            // (NSString) Transaction ID, should be unique.
                        withAffiliation:@"In-App Store"];      // (NSString) Affiliation
  transaction.taxMicros = (int64_t)(0.17 * 1000000);           // (int64_t) Total tax (in micros)
  transaction.shippingMicros = (int64_t)(0);                   // (int64_t) Total shipping (in micros)
  transaction.revenueMicros = (int64_t)(2.16 * 1000000);       // (int64_t) Total revenue (in micros)

  [transaction addItemWithSKU:@"L_789"                         // (NSString) Product SKU
                         name:@"Level Pack: Space"             // (NSString) Product name
                     category:@"Game expansions"               // (NSString) Product category
                  priceMicros:(int64_t)(1.99 * 1000000)        // (int64_t)  Product price (in micros)
                     quantity:1];                              // (NSInteger)  Product quantity

  [[GAI sharedInstance].defaultTracker sendTransaction:transaction]; // Send the transaction.
}

货币类型

在 iOS 版 Google Analytics(分析)SDK 中,电子商务货币字段必须以微单位(货币的百万分之一)为单位。

例如,如需发送货币值 4.5991,您应在向 Google Analytics(分析)发送交易值时将该值转换为微单位(即 4599100),如上面的示例所示。当 SDK 将该交易分派给 Google Analytics(分析)时,该值会自动转换为定点数十进制值并作为 4.5991 发送。

电子商务代码不应包含货币符号,也不应使用逗号。

电子商务货币字段还支持为负数货币值,以用于退款或退货的情况。