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