e コマース トラッキング - iOS SDK

このドキュメントでは、iOS 向け Google アナリティクス SDK v2 を使用して、アプリ内決済と収益を測定する方法の概要を説明します。

概要

e コマースの測定では、アプリ内の購入と売り上げのデータを Google アナリティクスに送ることができます。Google アナリティクスの e コマースデータは通常、共有のトランザクション ID に関連付けられたトランザクションとアイテムのデータで構成されます。iOS 向け Google アナリティクス SDK では、トランザクション オブジェクトを作成して項目を追加することで、関係が確立されます。

e コマースデータは、主に以下のレポートで使用されます。

  • e コマースの概要
  • 商品の販売状況
  • 販売実績
  • トランザクション
  • 購入までの間隔

実装

Google アナリティクスでトランザクションを測定するには、次の 3 つの手順を行います。

  1. トランザクション オブジェクトを作成します。
  2. アイテム オブジェクトを構築し、トランザクション オブジェクトに追加します。
  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 アナリティクス SDK では、e コマースの通貨フィールドはマイクロ(100 万単位)単位である必要があります。

たとえば、4.5991 の通貨値を送信するには、上記の例のように、トランザクションを Google アナリティクスに送信するときに、その値をミクロ(4599100)に変換する必要があります。SDK がそのトランザクションを Google アナリティクスにディスパッチすると、その値は自動的に固定小数点数値に変換され、4.5991 として送信されます。

e コマースコードでは通貨記号、カンマは使用しません。

e コマースの通貨フィールドは負の通貨値もサポートしています。払い戻しや返品で必要になる場合があります。