電子商務追蹤 - iOS SDK

本文件概述如何使用 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
}