本文件概述如何使用 Google Analytics SDK for iOS v3,評估應用程式內付款和收益。
總覽
電子商務評估可讓您將應用程式內購和銷售資料傳送至 Google Analytics (分析)。Google Analytics (分析) 中的電子商務資料包含交易和商品命中,與共用交易 ID 相關。
交易包含下列欄位:
欄位名稱 | 追蹤器欄位 | 類型 | 必填 | 說明 |
---|---|---|---|---|
交易 ID |
kGAITransactionId |
NSString |
是 | 代表交易的專屬 ID。這個 ID 不得與其他交易 ID 衝突。 |
聯盟 |
kGAITransactionAffiliation |
NSString |
是 | 與交易建立關聯的實體 (例如特定商店) |
收益 |
kGAITransactionRevenue |
NSNumber |
是 | 交易的總收益,包括稅金和運費 |
稅金 |
kGAITransactionTax |
NSNumber |
是 | 交易總額 |
運送 |
kGAITransactionShipping |
NSNumber |
是 | 交易總費用 |
貨幣代碼 |
kGAICurrencyCode |
NSString |
否 | 交易的當地幣別。預設為用於查看交易的資料檢視幣別 (設定檔)。 |
項目包含下列欄位:
欄位名稱 | 追蹤器欄位 | 類型 | 必填 | 說明 |
---|---|---|---|---|
交易 ID |
kGAITransactionId |
NSString |
是 | 與項目相關聯的交易 ID |
名稱 |
kGAIItemName |
NSString |
是 | 產品名稱 |
SKU |
kGAIItemSku |
NSString |
是 | 產品的 SKU |
類別 |
kGAIItemCategory |
NSString |
否 | 產品所屬的類別 |
價格 |
kGAIItemPrice |
NSNumber |
是 | 產品的價格 |
數量 |
kGAIItemQuantity |
NSNumber |
是 | 產品數量 |
貨幣代碼 |
kGAICurrencyCode |
NSString |
否 | 交易的當地幣別。預設值為交易交易的資料檢視 (設定檔) 貨幣。 |
電子商務資料主要用於下列標準報表中:
- 電子商務總覽
- 產品業績
- 銷售業績
- 交易
- 購買前天數
導入作業
將交易和項目資料傳送至 Google Analytics (分析) 時,您必須在追蹤器中設定交易和項目欄位值,一次傳送一個。例如:
/* * 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 }
電子商務貨幣欄位支援負值幣別 (以退款或退貨來說為必要)。
指定貨幣
根據預設,系統會假設交易金額是以報表採用的資料檢視 (設定檔) 所使用的貨幣為準。
如要覆寫交易的當地幣別和任何相關聯的產品,請使用新的貨幣代碼設定交易的貨幣代碼欄位和商品命中。如需支援貨幣和貨幣代碼的完整清單,請參閱支援的貨幣參考資料。
/* 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 }