Dieses Dokument bietet eine Übersicht über die Messung von In-App-Zahlungen und -Umsätzen mit dem Google Analytics SDK for Android Version 3.
Ü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 | Fields.TRANSACTION_ID
|
String
|
Ja | Eine eindeutige ID, die die Transaktion darstellt. Diese ID sollte nicht mit anderen Transaktions-IDs in Konflikt stehen. |
Händler/Partner | Fields.TRANSACTION_AFFILIATION
|
String
|
Ja | Eine Entität, mit der die Transaktion verknüpft sein sollte (z.B. ein bestimmtes Geschäft) |
Umsatz | Fields.TRANSACTION_REVENUE
|
Double
|
Ja | Gesamtumsatz einer Transaktion, einschließlich Steuern und Versandkosten |
Steuer | Fields.TRANSACTION_TAX
|
Double
|
Ja | Die Gesamtsteuer für eine Transaktion |
Versand | Fields.TRANSACTION_SHIPPING
|
Double
|
Ja | Die Gesamtkosten für den Versand einer Transaktion |
Währungscode | Fields.CURRENCY_CODE
|
String
|
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 | Fields.TRANSACTION_ID
|
String
|
Ja | Die Transaktions-ID, mit der der Artikel verknüpft werden soll |
Name | Fields.ITEM_NAME
|
String
|
Ja | Der Name des Produkts. |
Artikelnummer | Fields.ITEM_SKU
|
String
|
Ja | Die Artikelnummer eines Produkts |
Kategorie | Fields.ITEM_CATEGORY
|
String
|
Nein | Eine Kategorie, zu der das Produkt gehört |
Preis | Fields.ITEM_PRICE
|
Double
|
Ja | Der Preis eines Produkts |
Menge | Fields.ITEM_QUANTITY
|
Long
|
Ja | Die Menge eines Produkts |
Währungscode | Fields.CURRENCY_CODE
|
String
|
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:
import android.app.Activity; import com.google.analytics.tracking.android.EasyTracker; import com.google.analytics.tracking.android.MapBuilder; public class CheckoutActivity extends Activity { /* * Called when a purchase is processed and verified. */ public void onPurchaseCompleted() { // May return null if EasyTracker has not yet been initialized with a // property ID. EasyTracker easyTracker = EasyTracker.getInstance(this); easyTracker.send(MapBuilder .createTransaction("0_123456", // (String) Transaction ID "In-app Store", // (String) Affiliation 2.16d, // (Double) Order revenue 0.17d, // (Double) Tax 0.0d, // (Double) Shipping "USD") // (String) Currency code .build() ); easyTracker.send(MapBuilder .createItem("0_123456", // (String) Transaction ID "Level Pack: Space", // (String) Product name "L_789", // (String) Product SKU "Game expansions", // (String) Product category 1.99d, // (Double) Product price 1L, // (Long) Product quantity "USD") // (String) Currency code .build() ); } // ... Rest of the Activity definition }
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.
import android.app.Activity; import com.google.analytics.tracking.android.EasyTracker; import com.google.analytics.tracking.android.MapBuilder; public class CheckoutActivity extends Activity { /** * 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() { // Assumes a tracker has already been initialized with a property ID, otherwise // this call returns null. EasyTracker easyTracker = EasyTracker.getInstance(this); easyTracker.send(MapBuilder .createTransaction("0_123456", // (String) Transaction ID, should be unique among transactions. "In-app Store", // (String) Affiliation (long) 2.16, // (long) Order revenue (includes tax and shipping) (long) 0.17, // (long) Tax 0.0, // (long) Shipping cost "EUR") // (String) Currency code .build(); } // ... Rest of the Activity definition. }