Dieses Dokument bietet einen Überblick über die Messung von In-App-Zahlungen und -Umsätzen mit dem Google Analytics SDK for Android Version 2.
Ü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 Android 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:
- Erstellen Sie ein Transaktionsobjekt.
- Erstellen Sie Elementobjekte und fügen Sie sie dem Transaktionsobjekt hinzu.
- Senden Sie die Transaktion mit
sendTransaction(Transaction transObject).
Im folgenden Beispiel gehen wir davon aus, dass onPurchaseCompleted() aufgerufen wird, nachdem der Nutzer einen In-App-Kauf abgeschlossen hat.
/**
* The purchase was processed. We will send the transaction and its associated line items to Google Analytics,
* but only if the purchase has been confirmed.
*/
public void onPurchaseCompleted() {
Transaction myTrans = new Transaction.Builder(
"0_123456", // (String) Transaction Id, should be unique.
(long) (2.16 * 1000000)) // (long) Order total (in micros)
.setAffiliation("In-App Store") // (String) Affiliation
.setTotalTaxInMicros((long) (0.17 * 1000000)) // (long) Total tax (in micros)
.setShippingCostInMicros(0) // (long) Total shipping cost (in micros)
.build();
myTrans.addItem(new Item.Builder(
"L_789", // (String) Product SKU
"Level Pack: Space", // (String) Product name
(long) (1.99 * 1000000), // (long) Product price (in micros)
(long) 1) // (long) Product quantity
.setProductCategory("Game expansions") // (String) Product category
.build());
Tracker myTracker = EasyTracker.getTracker(); // Get reference to tracker.
myTracker.sendTransaction(myTrans); // Send the transaction.
}
Währungstypen
Im Google Analytics SDK for Android 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.
Währungen angeben
Standardmäßig wird davon ausgegangen, dass Transaktionswerte die Währung der Datenansicht (des Profils) haben, in der sie gemeldet werden.
Um die lokale Währung einer Transaktion zu überschreiben, rufen Sie beim Erstellen eines
Transaction setCurrencyCode auf, wie im folgenden Beispiel gezeigt:
/**
* 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).
*/
public void onPurchaseCompleted() {
Transaction myTrans = new Transaction.Builder(
"0_123456",
(long) (1.59 * 1000000))
.setAffiliation("In-App Store")
.setTotalTaxInMicros((long) (0.13 * 1000000))
.setShippingCostInMicros(0)
.setCurrencyCode("EUR") // (String) Set currency code to Euros.
.build();
Tracker myTracker = EasyTracker.getTracker();
myTracker.sendTransaction(myTrans);
}
Eine vollständige Liste der unterstützten Währungen und Währungscodes finden Sie in der Referenz zu unterstützten Währungen.