このドキュメントでは、iOS 向け Google アナリティクス SDK v2 を使って、アプリ内のお支払いと収益を測定する方法の概要を説明します。
概要
e コマースの測定では、アプリ内の購入と売り上げのデータを Google アナリティクスに送ることができます。通常、Google アナリティクスの e コマースデータは、共通のトランザクション ID で関連付けられたトランザクションとアイテムで構成されます。iOS 向け Google アナリティクス SDK では、トランザクション オブジェクトを作成してアイテムを追加することで、この関係が確立されます。
e コマースデータは主に次のレポートで使用されます。
- e コマースの概要
- 商品の販売状況
- 販売実績
- トランザクション
- 購入までの間隔
実装
Google アナリティクスでトランザクションを測定するには、次の 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 万分の 1 の通貨）で指定する必要があります。
たとえば、通貨の値 4.5991 を送信する場合は、トランザクションを Google アナリティクスに送信する際に、上の例のようにその値をマイクロに変換（つまり 4599100）する必要があります。SDK がそのトランザクションを Google アナリティクスに送信すると、その値は自動的に固定小数点以下の 10 進値に変換され、4.5991 として送信されます。
e コマースコードに通貨記号を含めたり、カンマを使用したりすることはできません。
e コマースの通貨フィールドでは、マイナスの通貨の値も使用できます。払い戻しや返品で必要となる場合があるためです。