Google Analytics SDK for Android v2 を訳してみた⑥「eコマーストラッキング」

チームEggの赤峰です。

Google Analytics V2のβ版の翻訳第6段です。
libGoogleAnalyticsV2.jarの使い方が書かれています。
今回はeコマースのトラッキングについてです。 原文はこちらです。
　　Google Analytics V2 - Ecommerce Tracking(原文)

eコマーストラッキング

このSDKは、β版のGoogle Mobile App Analyticsです。
興味ある方はある方は、サインアップしてβ版にアクセスしてください。

このドキュメントでは、Android用Google AnalyticsのSDKを使用して、アプリ内の支払いと収益を追跡する方法の概要を説明します。

（項目）
概要
実装
　通貨の種類


[概要]
-------------------------------
eコマーストラッキングでは、アプリ内売買をトラッキングすることができます。Google Analyticsのeコマースのデータは、共有されるtransacation IDによって関連した処理とアイテムで一般的に構成されます。
Android用Google AnalyticsのSDKでは、その関係は、トランザクションオブジェクトを作成し、そこにアイテムを追加することによって確立されています。

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

• eコマースの概要
• 製品の性能
• 販売実績
• 取引
• 購入する時

[実装]
-------------------------------
トランザクションをトラッキングするための3つのステップがあります：

1. トランザクション·オブジェクトを作成します。
2. アイテムオブジェクトを作成し、トランザクションオブジェクトに追加します。
3. trackTransaction(Transaction transObject)を使用してトランザクションをトラッキングします。

次の例では、ユーザーがアプリ内購入を完了した後onPurchaseCompleted()が呼び出されることを想定しています。

/**
 * 購入処理されました。現在のトランザクションとそれに関連付けられた行のアイテムを追跡しますが、
 * 購入が確認されている場合のみです。The purchase was processed. We will track the transaction 
 */
public void onPurchaseCompleted() {
  Transaction myTrans = new Transaction.Builder(
      "0_123456",                                           // (String) トランザクションId,ユニークにすべき
      (long) 2.16 * 1000000)                                // (long) 注文合計(in micros)
      .setAffiliation("In-App Store")                       // (String) 提携
      .setTotalTaxInMicros((long) 0.17 * 1000000)           // (long) 合計税 (in micros)
      .setShippingCostInMicros(0)                           // (long) 合計配達費(in micros)
      .build();

  myTrans.addItem(new Item.Builder(
      "L_789",                                              // (String) 商品SKU
      "Level Pack: Space",                                  // (String) 商品名
      (long) 1.99 * 1000000,                                // (long) 商品値段(in micros)
      (long) 1 * 1000000)                                   // (long) 商品数
      .setProductCategory("Game expansions")                // (String) 商品カテゴリ
      .build());

    Tracker myTracker = EasyTracker.getTracker(); // トラッカーの参照を取得
    myTracker.trackTransaction(myTrans); // トランザクションをトラッキング
}

通貨の種類

Android用Google AnalyticsのSDKでは、eコマース通貨フィールドはマイクロ（通貨の100万分の1）でなければなりません。

たとえば、4.5991の通貨値を追跡するには、マイクロの値（すなわち、4599100）は、上記の例のように、SDKを使用してトランザクションをトラッキングするときに変換する必要があります。SDKがGoogle Analyticsにトランザクションをディスパッチする場合、その値は自動的に固定小数点式の10進値に変換され、4.5991として送られます。

注：あなたは通貨をマイクロに変換していなければなりませんが、フードの下では、SDKは固定小数点式の10進値を使用してGoogle Analyticsに、通貨データを送信します。これは、その精度は様々な通貨間で失われないようにします。

eコマースの通貨の値は、プロファイルの設定で指定した通貨を使用してレポートに表示されます。通貨記号は、あなたのeコマースのコードに含まれるべきではありません。また、コンマを使用する必要があります。

eコマース通貨フィールドは、払い戻しまたは返品の場合に必要に応じて負の通貨値をサポートしています。


次回はイベントを翻訳します。