Ce document explique comment mesurer les paiements et les revenus via l'application à l'aide du SDK Google Analytics pour Android v2.
Présentation
Les mesures de l'e-commerce vous permettent d'envoyer les achats et les ventes via l'application à Google Analytics. Dans Google Analytics, les données d'e-commerce sont généralement constituées de transactions et d'articles associés à un ID de transaction partagé. Dans le SDK Google Analytics pour Android, cette relation est établie en créant un objet de transaction et en y ajoutant des éléments.
Les données d'e-commerce sont utilisées en priorité dans les rapports suivants:
- Vue d'ensemble de l'e-commerce
- Performances des produits
- Performances des ventes
- Transactions
- Délai avant l'achat
Implémentation
La mesure d'une transaction avec Google Analytics s'effectue en trois étapes:
- Créez un objet de transaction.
- Créez des objets "item" et ajoutez-les à l'objet "transaction".
- Envoyez la transaction à l'aide de
sendTransaction(Transaction transObject).
Dans l'exemple suivant, nous supposons que onPurchaseCompleted() est appelé après que l'utilisateur a effectué un achat via l'application.
/**
* 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.
}
Types de devise
Dans le SDK Google Analytics pour Android, les champs de devise de l'e-commerce doivent être exprimés en micros (millions de devises).
Par exemple, pour envoyer une valeur monétaire de 4.5991, vous devez convertir cette valeur en micro-unités (c'est-à-dire 4599100) lorsque vous envoyez la transaction à Google Analytics, comme dans les exemples ci-dessus. Lorsque le SDK envoie cette transaction à Google Analytics, cette valeur est automatiquement convertie en valeur décimale à virgule fixe et envoyée sous la forme 4.5991.
Vous ne devez pas inclure de symboles de devise dans votre code d'e-commerce ni de virgules.
Les champs "Devise de l'e-commerce" acceptent également les valeurs négatives dans les devises, dans la mesure où cela peut être nécessaire dans le cas de remboursements ou de retours.
Spécifier les devises
Par défaut, les valeurs de transaction sont supposées être exprimées dans la devise de la vue (profil) dans laquelle elles sont enregistrées.
Pour remplacer la devise locale d'une transaction, appelez setCurrencyCode lors de la création d'un
Transaction, comme dans l'exemple suivant:
/**
* 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);
}
Pour obtenir la liste complète des devises et des codes de devise acceptés, consultez la documentation de référence sur les devises acceptées.