本文件將概述如何使用 iOS 專用的 Google Analytics (分析) SDK 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 }