Śledzenie e-commerce – pakiet SDK do systemu Android

Ten dokument zawiera przegląd sposobów pomiaru przychodów i płatności w aplikacji za pomocą pakietu SDK Google Analytics na Androida w wersji 3.

Przegląd

Pomiar e-commerce umożliwia przesyłanie do Google Analytics zakupów i sprzedaży w aplikacji. Dane e-commerce w Google Analytics obejmują działania dotyczące transakcji i produktu powiązane ze wspólnym identyfikatorem transakcji.

Transakcje zawierają te pola:

Nazwa pola Pole skryptu śledzenia Typ Wymagane Opis
Identyfikator transakcji Fields.TRANSACTION_ID String Tak Unikalny identyfikator transakcji. Ten identyfikator nie powinien kolidować z innymi identyfikatorami transakcji.
Przynależność Fields.TRANSACTION_AFFILIATION String Tak Podmiot, z którym powinna być powiązana transakcja (np.konkretny sklep).
Przychody Fields.TRANSACTION_REVENUE Double Tak Łączne przychody z transakcji, z uwzględnieniem podatku i kosztów dostawy.
Podatek Fields.TRANSACTION_TAX Double Tak Łączna kwota podatku od transakcji
dostawa, Fields.TRANSACTION_SHIPPING Double Tak Całkowity koszt dostawy w ramach transakcji
Kod waluty Fields.CURRENCY_CODE String Nie Waluta lokalna transakcji. Domyślnie jest to waluta widoku (profilu), w którym wyświetlane są transakcje.

Elementy mają te pola:

Nazwa pola Pole skryptu śledzenia Typ Wymagane Opis
Identyfikator transakcji Fields.TRANSACTION_ID String Tak Identyfikator transakcji, z którą element powinien być powiązany
Nazwa Fields.ITEM_NAME String Tak Nazwa produktu
SKU Fields.ITEM_SKU String Tak Kod SKU produktu
Kategoria Fields.ITEM_CATEGORY String Nie Kategoria, do której należy produkt
Cena Fields.ITEM_PRICE Double Tak Cena produktu
Ilość Fields.ITEM_QUANTITY Long Tak Liczba sztuk produktu
Kod waluty Fields.CURRENCY_CODE String Nie Waluta lokalna transakcji. Domyślnie jest to waluta widoku (profilu), w którym raportowane są transakcje.

Dane e-commerce są używane głównie w tych raportach standardowych:

  • E-commerce ogółem
  • Skuteczność produktu
  • Skuteczność sprzedaży
  • Transakcje
  • Czas do zakupu

Implementacja

Wysyłanie do Google Analytics danych o transakcjach i produktach wymaga ustawienia w module śledzenia wartości pól transakcji i produktów oraz wysyłania ich pojedynczo. Na przykład:

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
}

Pola waluty e-commerce obsługują wartości ujemne, co może być konieczne w przypadku zwrotów środków.

Określanie walut

Domyślnie wartości transakcji są przedstawiane w walucie widoku (profilu), w którym są raportowane.

Aby zastąpić walutę lokalną transakcji i wszystkich powiązanych produktów, ustaw nowy kod waluty w polu kodu waluty transakcji i działań produktu. Pełną listę obsługiwanych walut i ich kodów znajdziesz w dokumentacji obsługiwanych walut.

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