電子商務追蹤 - iOS SDK

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