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 for iOS v2.

Ü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 in der Regel aus Transaktionen und Artikeln, die durch eine gemeinsame Transaktions-ID verknüpft sind. Im Google Analytics SDK for iOS wird diese Beziehung hergestellt, indem ein Transaktionsobjekt erstellt und ihm Elemente hinzugefügt werden.

E-Commerce-Daten werden in den folgenden Berichten primär verwendet:

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

Implementierung

Zum Erfassen einer Transaktion mit Google Analytics sind drei Schritte erforderlich:

  1. Erstellen Sie ein Transaktionsobjekt.
  2. Erstellen Sie Elementobjekte und fügen Sie sie dem Transaktionsobjekt hinzu.
  3. Senden Sie die Transaktion mit sendTransaction:.

Im folgenden Beispiel gehen wir davon aus, dass onPurchaseCompleted aufgerufen wird, nachdem der Nutzer einen In-App-Kauf abgeschlossen hat.

- (void)onPurchaseCompleted {
  GAITransaction *transaction =
      [GAITransaction transactionWithId:@"0_123456"            // (NSString) Transaction ID, should be unique.
                        withAffiliation:@"In-App Store"];      // (NSString) Affiliation
  transaction.taxMicros = (int64_t)(0.17 * 1000000);           // (int64_t) Total tax (in micros)
  transaction.shippingMicros = (int64_t)(0);                   // (int64_t) Total shipping (in micros)
  transaction.revenueMicros = (int64_t)(2.16 * 1000000);       // (int64_t) Total revenue (in micros)

  [transaction addItemWithSKU:@"L_789"                         // (NSString) Product SKU
                         name:@"Level Pack: Space"             // (NSString) Product name
                     category:@"Game expansions"               // (NSString) Product category
                  priceMicros:(int64_t)(1.99 * 1000000)        // (int64_t)  Product price (in micros)
                     quantity:1];                              // (NSInteger)  Product quantity

  [[GAI sharedInstance].defaultTracker sendTransaction:transaction]; // Send the transaction.
}

Währungstypen

Im Google Analytics SDK for iOS müssen die Felder für E-Commerce-Währungen in Mikros (Millionen von Währungen) angegeben werden.

Wenn Sie beispielsweise einen Währungswert von 4.5991 senden möchten, müssen Sie diesen Wert beim Senden der Transaktion an Google Analytics in Mikros (z.B. 4599100) umrechnen, wie in den Beispielen oben gezeigt. Wenn das SDK diese Transaktion an Google Analytics sendet, wird der Wert automatisch in einen Festkommadewert umgewandelt und als 4.5991 gesendet.

Der E-Commerce-Code sollte weder Währungssymbole noch Kommas enthalten.

E-Commerce-Währungsfelder unterstützen auch negative Währungswerte, wie es bei Erstattungen oder Retouren erforderlich sein kann.