E-Commerce-Tracking – SDK für Android

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.
}