e コマース トラッキング

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

概要

e コマースの測定では、アプリ内購入と売上のデータを Google アナリティクスに送信できます。Google アナリティクスの e コマースデータにはトランザクションとアイテムのヒットが含まれ、それぞれが共通のトランザクション ID で結び付けられます。

トランザクションには次のフィールドがあります。

フィールド名 必須 説明
Transaction ID String 必須 トランザクションを表す固有の ID です。他のトランザクション ID と重ならないようにしてください。
Affiliation String 必須 トランザクションに関わる当事者です(特定のショップなど)。
Revenue Double 必須 トランザクションの収益の合計額です(税金と送料を含む)。
Tax Double 必須 トランザクションに伴う税金の合計額です。
Shipping Double 必須 トランザクションに伴う送料の合計額です。
Currency code String いいえ トランザクションで使用されるローカル通貨です。デフォルトでは、そのトランザクション データが表示される ビュー(旧プロファイル)の通貨になります。

アイテムには次のフィールドがあります。

フィールド名 必須 説明
Transaction ID String 必須 アイテムに関連するトランザクション ID です。
Name String 必須 商品の名前です。
SKU String 必須 商品の SKU です。
Category String いいえ 商品が属するカテゴリです。
Price Double 必須 商品の価格です。
Quantity Long 必須 商品の数量です。
Currency code String いいえ トランザクションで使用されるローカル通貨です。デフォルトでは、そのトランザクション データが表示されるビュー(旧プロファイル)の通貨になります。

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

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

実装

Google アナリティクスにトランザクションとアイテムのデータを送るには、TransactionBuilderItemBuilder を使用します。これらの e コマース フィールドは、ヘルパー メソッドを使って設定します。次の例をご覧ください。

// Build the transaction.
sendDataToTwoTrackers(new HitBuilders.TransactionBuilder()
    .setTransactionId(getOrderId())
    .setAffiliation(getStoreName())
    .setRevenue(getTotalOrder())
    .setTax(getTotalTax())
    .setShipping(getShippingCost())
    .setCurrencyCode("USD")
    .build());

// Build an item.
sendDataToTwoTrackers(new HitBuilders.ItemBuilder()
    .setTransactionId(getOrderId())
    .setName(getItemName(1))
    .setSku(getItemSku(1))
    .setCategory(getItemCategory(1))
    .setPrice(getItemPrice(getView(), 1))
    .setQuantity(getItemQuantity(getView(), 1))
    .setCurrencyCode("USD")
    .build());

// Sends the ecommerce data.
private void sendDataToTwoTrackers(Map<String, String> params) {
  AnalyticsSampleApp app = ((AnalyticsSampleApp) getActivity().getApplication());
  Tracker appTracker = app.getTracker(TrackerName.APP_TRACKER);
  Tracker ecommerceTracker = app.getTracker(TrackerName.ECOMMERCE_TRACKER);
  appTracker.send(params);
  ecommerceTracker.send(params);
}

getTracker メソッドの詳細については、高度な設定の説明をご覧ください。

e コマースの通貨フィールドは負の値に対応しています。払い戻しや返品で必要となる 場合があるためです。

通貨の指定

デフォルトでは、トランザクションの値は表示されるビュー(旧プロファイル)の通貨と みなされます。

トランザクションとその商品のローカル通貨を上書きするには、 トランザクションとアイテムのヒットの通貨コード フィールドに 新しい通貨コードを設定します。サポートされている通貨と通貨コードの一覧については、利用可能な通貨のリファレンスをご覧ください。