E-Commerce-Tracking – iOS SDK

Dieses Dokument bietet einen Überblick über die Messung von In-App-Zahlungen und -Umsätzen mit dem Google Analytics SDK für iOS v3.

Überblick

Mithilfe der E-Commerce-Messung können Sie In-App-Käufe und -Verkäufe an Google Analytics senden. E-Commerce-Daten in Google Analytics bestehen aus Transaktions- und Artikeltreffern, die durch eine gemeinsame Transaktions-ID verknüpft sind.

Transaktionen enthalten die folgenden Felder:

Feldname Tracker-Feld Typ Erforderlich Beschreibung
Transaktions-ID kGAITransactionId NSString Ja Eine eindeutige ID, die die Transaktion darstellt. Diese ID sollte nicht mit anderen Transaktions-IDs in Konflikt stehen.
Händler/Partner kGAITransactionAffiliation NSString Ja Eine Entität, mit der die Transaktion verknüpft sein sollte (z.B. ein bestimmtes Geschäft)
Umsatz kGAITransactionRevenue NSNumber Ja Gesamtumsatz einer Transaktion, einschließlich Steuern und Versandkosten
Steuer kGAITransactionTax NSNumber Ja Die Gesamtsteuer für eine Transaktion
Versand kGAITransactionShipping NSNumber Ja Die Gesamtkosten für den Versand einer Transaktion
Währungscode kGAICurrencyCode NSString Nein Die Landeswährung einer Transaktion. Die Standardeinstellung ist die Währung der Datenansicht (des Profils), in der die Transaktionen aufgerufen werden.

Elemente haben die folgenden Felder:

Feldname Tracker-Feld Typ Erforderlich Beschreibung
Transaktions-ID kGAITransactionId NSString Ja Die Transaktions-ID, mit der der Artikel verknüpft werden soll
Name kGAIItemName NSString Ja Der Name des Produkts.
Artikelnummer kGAIItemSku NSString Ja Die Artikelnummer eines Produkts
Kategorie kGAIItemCategory NSString Nein Eine Kategorie, zu der das Produkt gehört
Preis kGAIItemPrice NSNumber Ja Der Preis eines Produkts
Menge kGAIItemQuantity NSNumber Ja Die Menge eines Produkts
Währungscode kGAICurrencyCode NSString Nein Die Landeswährung einer Transaktion. Die Standardeinstellung ist die Währung der Datenansicht (des Profils), in der die Transaktionen gemeldet werden.

E-Commerce-Daten werden hauptsächlich in den folgenden Standardberichten verwendet:

  • E-Commerce-Übersicht
  • Produktleistung
  • Verkaufsleistung
  • Transaktionen
  • Zeit bis zum Kauf

Implementierung

Zum Senden von Transaktions- und Artikeldaten an Google Analytics müssen die Transaktions- und Artikelfeldwerte im Tracker festgelegt und nacheinander gesendet werden. Beispiel:

/*
 * 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 den E-Commerce-Währungsfeldern werden negative Währungswerte unterstützt, wie es bei Erstattungen oder Retouren erforderlich sein kann.

Währungen angeben

Standardmäßig wird davon ausgegangen, dass Transaktionswerte die Währung der Datenansicht (des Profils) haben, in der sie gemeldet werden.

Wenn Sie die Landeswährung einer Transaktion und aller zugehörigen Produkte überschreiben möchten, legen Sie für das Feld „Währungscode“ der Transaktion und für die Artikeltreffer den neuen Währungscode fest. Eine vollständige Liste der unterstützten Währungen und Währungscodes finden Sie in der Referenz zu unterstützten Währungen.

/*
 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
}