Questo documento fornisce una panoramica su come misurare i pagamenti in-app e le entrate utilizzando l'SDK di Google Analytics per Android v2.
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 generalmente costituiti da transazioni ed articoli correlati da un ID transazione condiviso. Nell'SDK Google Analytics per Android, questa relazione viene stabilita creando un oggetto Transaction e aggiungendo elementi allo stesso.
I dati di e-commerce sono utilizzati come principali nei seguenti report:
- Panoramica e-commerce
- Rendimento prodotti
- Rendimento delle vendite
- Transazioni
- Tempo all'acquisto
Implementazione
Per misurare una transazione con Google Analytics sono previsti tre passaggi:
- Creare un oggetto Transaction.
- Creare oggetti elemento e aggiungerli all'oggetto Transaction.
- Invia la transazione utilizzando
sendTransaction(Transaction transObject).
Nell'esempio seguente, supponiamo che
onPurchaseCompleted()
venga chiamata dopo che l'utente ha completato un acquisto in-app.
/**
* The purchase was processed. We will send the transaction and its associated line items to Google Analytics,
* but only if the purchase has been confirmed.
*/
public void onPurchaseCompleted() {
Transaction myTrans = new Transaction.Builder(
"0_123456", // (String) Transaction Id, should be unique.
(long) (2.16 * 1000000)) // (long) Order total (in micros)
.setAffiliation("In-App Store") // (String) Affiliation
.setTotalTaxInMicros((long) (0.17 * 1000000)) // (long) Total tax (in micros)
.setShippingCostInMicros(0) // (long) Total shipping cost (in micros)
.build();
myTrans.addItem(new Item.Builder(
"L_789", // (String) Product SKU
"Level Pack: Space", // (String) Product name
(long) (1.99 * 1000000), // (long) Product price (in micros)
(long) 1) // (long) Product quantity
.setProductCategory("Game expansions") // (String) Product category
.build());
Tracker myTracker = EasyTracker.getTracker(); // Get reference to tracker.
myTracker.sendTransaction(myTrans); // Send the transaction.
}
Tipi di valuta
Nell'SDK Google Analytics per Android, i campi della valuta e-commerce devono essere in micro (milioni di valuta).
Ad esempio, per inviare un valore di valuta pari a 4.5991, devi
convertirlo in micro (ovvero 4599100) quando invii la
transazione a Google Analytics, come negli esempi precedenti. Quando l'SDK invia la transazione a Google Analytics, questo valore viene automaticamente convertito in un valore decimale a virgola fissa e inviato come 4.5991.
I simboli di valuta non devono essere inclusi nel codice e-commerce e non devono essere utilizzate le virgole.
I campi della valuta di e-commerce supportano anche 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 eseguire l'override della valuta locale di una transazione, chiama
setCurrencyCode quando crei un
Transaction
come nel seguente
esempio:
/**
* 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() {
Transaction myTrans = new Transaction.Builder(
"0_123456",
(long) (1.59 * 1000000))
.setAffiliation("In-App Store")
.setTotalTaxInMicros((long) (0.13 * 1000000))
.setShippingCostInMicros(0)
.setCurrencyCode("EUR") // (String) Set currency code to Euros.
.build();
Tracker myTracker = EasyTracker.getTracker();
myTracker.sendTransaction(myTrans);
}
Per l'elenco completo delle valute e dei codici valuta supportati, consulta la documentazione di riferimento sulle valute supportate.