Monitoraggio e-commerce - SDK per Android

Questo documento fornisce una panoramica su come misurare i pagamenti in-app e le entrate utilizzando l'SDK di Google Analytics per Android v3.

Panoramica

La misurazione e-commerce ti consente di inviare acquisti e vendite in-app a Google Analytics. I dati di e-commerce in Google Analytics sono costituiti da hit di transazioni e articoli, correlati da un ID transazione condiviso.

Le transazioni includono i seguenti campi:

Nome campo Campo tracker Tipo Obbligatorio Descrizione
ID transazione Fields.TRANSACTION_ID String Sì Un ID univoco che rappresenta la transazione. Questo ID non deve entrare in conflitto con altri ID transazione.
Affiliazione Fields.TRANSACTION_AFFILIATION String Sì Un'entità a cui dovrebbe essere affiliata la transazione (ad es. un determinato negozio)
Entrate Fields.TRANSACTION_REVENUE Double Sì Le entrate totali di una transazione, incluse imposte e spedizione
Tasse Fields.TRANSACTION_TAX Double Sì L'imposta totale per una transazione
Spedizione Fields.TRANSACTION_SHIPPING Double Sì Il costo totale della spedizione per una transazione
Codice valuta Fields.CURRENCY_CODE String No La valuta locale di una transazione. Il valore predefinito è la valuta della vista (profilo) in cui vengono visualizzate le transazioni.

Gli elementi hanno i seguenti campi:

Nome campo Campo tracker Tipo Obbligatorio Descrizione
ID transazione Fields.TRANSACTION_ID String Sì L'ID transazione a cui deve essere associato l'articolo
Nome Fields.ITEM_NAME String Sì Il nome del prodotto.
SKU Fields.ITEM_SKU String Sì Lo SKU di un prodotto
Categoria Fields.ITEM_CATEGORY String No Una categoria a cui appartiene il prodotto
Prezzo Fields.ITEM_PRICE Double Sì Il prezzo di un prodotto
Quantità Fields.ITEM_QUANTITY Long Sì La quantità di un prodotto
Codice valuta Fields.CURRENCY_CODE String No La valuta locale di una transazione. Il valore predefinito è la valuta della vista (profilo) in cui sono riportate le transazioni.

I dati di e-commerce vengono utilizzati principalmente nei seguenti report standard:

  • Panoramica e-commerce
  • Rendimento prodotti
  • Rendimento delle vendite
  • Transazioni
  • Tempo all'acquisto

Implementazione

L'invio dei dati sulle transazioni e sugli articoli a Google Analytics richiede l'impostazione dei valori dei campi delle transazioni e degli articoli sul tracker e l'invio di questi valori, uno alla volta. Ad esempio:

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
}

I campi della valuta e-commerce supportano valori di valuta negativi, come potrebbe essere necessario in caso di rimborsi o resi.

Indicazione delle valute

Per impostazione predefinita, si presume che i valori delle transazioni siano espressi nella valuta della vista (profilo) in cui sono riportati.

Per sostituire la valuta locale di una transazione e di eventuali prodotti associati, imposta il campo del codice valuta della transazione e degli hit dell'articolo con il nuovo codice valuta. Per l'elenco completo delle valute e dei codici valuta supportati, consulta la documentazione di riferimento sulle valute supportate.

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