このドキュメントでは、iOS 向け Google アナリティクス SDK v3 を使って、アプリ内のお支払いと収益を測定する方法の概要を説明します。
概要
e コマースの測定では、アプリ内の購入と売り上げのデータを Google アナリティクスに送ることができます。Google アナリティクスの e コマースデータにはトランザクションとアイテムのヒットが含まれ、それぞれが共通のトランザクション ID で結び付けられます。
トランザクションには次のフィールドがあります。
| フィールド名 | トラッカー フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|---|
| Transaction ID |
kGAITransactionId |
NSString |
はい | トランザクションを表す固有の ID です。他のトランザクション ID と重ならないようにしてください。 |
| Affiliation |
kGAITransactionAffiliation |
NSString |
はい | トランザクションに関わる当事者です（特定のショップなど）。 |
| 収益 |
kGAITransactionRevenue |
NSNumber |
はい | トランザクションの収益の合計額です（税金と送料を含む）。 |
| Tax |
kGAITransactionTax |
NSNumber |
はい | トランザクションに伴う税金の合計額です。 |
| Shipping |
kGAITransactionShipping |
NSNumber |
はい | トランザクションに伴う送料の合計額です。 |
| Currency code |
kGAICurrencyCode |
NSString |
× | トランザクションで使用されるローカル通貨です。デフォルトでは、そのトランザクション データが表示される ビュー（旧プロファイル）の通貨になります。 |
アイテムには次のフィールドがあります。
| フィールド名 | トラッカー フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|---|
| Transaction ID |
kGAITransactionId |
NSString |
はい | アイテムに関連するトランザクション ID です。 |
| 名前 |
kGAIItemName |
NSString |
はい | 商品の名前です。 |
| SKU |
kGAIItemSku |
NSString |
はい | 商品の SKU です。 |
| カテゴリ |
kGAIItemCategory |
NSString |
× | 商品が属するカテゴリです。 |
| Price |
kGAIItemPrice |
NSNumber |
はい | 商品の価格です。 |
| 数量 |
kGAIItemQuantity |
NSNumber |
はい | 商品の数量です。 |
| 通貨コード |
kGAICurrencyCode |
NSString |
× | トランザクションで使用されるローカル通貨です。デフォルトでは、そのトランザクション データが表示されるビュー（旧プロファイル）の通貨になります。 |
e コマースデータは、主に次の標準レポートで使用されます。
- e コマースの概要
- 商品の販売状況
- 販売実績
- トランザクション
- 購入までの間隔
実装
Google アナリティクスにトランザクションとアイテムのデータを送るには、トラッカーのトランザクションとアイテムのフィールドに値を設定し、1 つずつ送る必要があります。次に例を示します。
/*
* Called when a purchase is processed and verified.
*/
- (void)onPurchaseCompleted {
// Assumes a tracker has already been initialized with a property ID, otherwise
// this call returns null.
id tracker = [[GAI sharedInstance] defaultTracker];
[tracker send:[[GAIDictionaryBuilder createTransactionWithId:@"0_123456" // (NSString) Transaction ID
affiliation:@"In-app Store" // (NSString) Affiliation
revenue:@2.16F // (NSNumber) Order revenue (including tax and shipping)
tax:@0.17F // (NSNumber) Tax
shipping:@0 // (NSNumber) Shipping
currencyCode:@"USD"] build]]; // (NSString) Currency code
[tracker send:[[GAIDictionaryBuilder createItemWithTransactionId:@"0_123456" // (NSString) Transaction ID
name:@"Space Expansion" // (NSString) Product Name
sku:@"L_789" // (NSString) Product SKU
category:@"Game expansions" // (NSString) Product category
price:@1.9F // (NSNumber) Product price
quantity:@1 // (NSInteger) Product quantity
currencyCode:@"USD"] build]]; // (NSString) Currency code
}
e コマースの通貨フィールドは負の値に対応しています。払い戻しや返品で必要となる 場合があるためです。
通貨の指定
デフォルトでは、トランザクションの値は表示されるビュー（旧プロファイル）の通貨と みなされます。
トランザクションとその商品のローカル通貨を上書きするには、 トランザクションとアイテムのヒットの通貨コード フィールドに 新しい通貨コードを設定します。サポートされている通貨と通貨コードの一覧については、利用可能な通貨のリファレンスをご覧ください。
/*
In this example, the currency of the transaction is set to Euros. The
currency values will appear in reports using the global currency
type of the view (profile).
*/
- (void)onPurchaseCompleted {
// Assumes a tracker has already been initialized with a property ID, otherwise
// this call returns null.
id tracker = [[GAI sharedInstance] defaultTracker];
[tracker send:[[GAIDictionaryBuilder createTransactionWithId:@"0_123456", // (NSString) Transaction ID, should be unique among transactions.
affiliation:@"In-app Store", // (NSString) Affiliation
revenue:(int64_t) 2.16, // (int64_t) Order revenue (including tax and shipping)
tax:(int64_t) 0.17, // (int64_t) Tax
shipping:(int64_t) 0, // (int64_t) Shipping
currencyCode:@"EUR"] build]]; // (NSString) Currency code
}