Ce document explique comment mesurer les paiements et les revenus via l'application à l'aide du SDK Google Analytics pour Android v3.
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 constituées d'appels de transaction et d'article, associés par un ID de transaction partagé.
Les transactions comportent les champs suivants:
Nom du champ | Champ de suivi | Type | Obligatoire | Description |
---|---|---|---|---|
ID de la transaction | Fields.TRANSACTION_ID
|
String
|
Oui | Identifiant unique représentant la transaction. Cet ID ne doit pas entrer en conflit avec d'autres ID de transaction. |
Affiliation | Fields.TRANSACTION_AFFILIATION
|
String
|
Oui | Entité à laquelle la transaction devrait être affiliée (par exemple, un magasin particulier) |
Revenus | Fields.TRANSACTION_REVENUE
|
Double
|
Oui | Montant total du chiffre d'affaires d'une transaction, taxes et frais de livraison inclus |
Taxes | Fields.TRANSACTION_TAX
|
Double
|
Oui | Montant total des taxes pour une transaction |
La livraison | Fields.TRANSACTION_SHIPPING
|
Double
|
Oui | les frais de port totaux pour une transaction donnée ; |
Code de devise | Fields.CURRENCY_CODE
|
String
|
Non | Devise locale d'une transaction. La valeur par défaut est la devise de la vue (profil) dans laquelle les transactions sont visualisées. |
Les éléments comportent les champs suivants:
Nom du champ | Champ de suivi | Type | Obligatoire | Description |
---|---|---|---|---|
ID de la transaction | Fields.TRANSACTION_ID
|
String
|
Oui | ID de la transaction à laquelle l'article doit être associé |
Nom | Fields.ITEM_NAME
|
String
|
Oui | Nom du produit |
SKU | Fields.ITEM_SKU
|
String
|
Oui | SKU d'un produit |
Catégorie | Fields.ITEM_CATEGORY
|
String
|
Non | Catégorie à laquelle appartient le produit |
Prix | Fields.ITEM_PRICE
|
Double
|
Oui | Prix d'un produit |
Quantité | Fields.ITEM_QUANTITY
|
Long
|
Oui | Quantité d'un produit |
Code de devise | Fields.CURRENCY_CODE
|
String
|
Non | Devise locale d'une transaction. La valeur par défaut est la devise de la vue (profil) dans laquelle les transactions sont enregistrées. |
Les données d'e-commerce sont principalement utilisées dans les rapports standards suivants:
- Vue d'ensemble de l'e-commerce
- Performances des produits
- Performances des ventes
- Transactions
- Délai avant l'achat
Implémentation
Pour envoyer des données sur les transactions et les articles à Google Analytics, vous devez définir les valeurs des champs de la transaction et de l'article dans l'outil de suivi, puis les envoyer une par une. Exemple :
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 }
Les champs "Devise de l'e-commerce" acceptent les valeurs négatives dans les devises, ce qui 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 et de tous les produits associés, utilisez le nouveau code de devise dans le champ "Code de devise" des appels de transaction et d'article. Pour obtenir la liste complète des devises et codes de devise acceptés, consultez la documentation de référence sur les devises acceptées.
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. }