En este documento, se proporciona una descripción general de cómo medir los ingresos y pagos integrados en la app con el SDK de Google Analytics para Android versión 3.
Descripción general
La medición de comercio electrónico te permite enviar compras y ventas directas desde la aplicación a Google Analytics. Los datos de comercio electrónico en Google Analytics se componen de hits de transacciones y artículos, relacionados por un ID de transacción compartido.
Las transacciones tienen los siguientes campos:
Nombre del campo | Monitor de campo | Tipo | Obligatorio | Descripción |
---|---|---|---|---|
ID de transacción | Fields.TRANSACTION_ID
|
String
|
Sí | Es un ID único que representa la transacción. Este ID no debe superponerse con otros ID de transacción. |
Afiliación | Fields.TRANSACTION_AFFILIATION
|
String
|
Sí | Es una entidad a la que debe estar afiliada la transacción (p. ej., una tienda en particular). |
Ingresos | Fields.TRANSACTION_REVENUE
|
Double
|
Sí | Indica los ingresos totales de una transacción, incluidos los impuestos y el envío. |
Impuesto | Fields.TRANSACTION_TAX
|
Double
|
Sí | Impuesto total de una transacción |
Envíos | Fields.TRANSACTION_SHIPPING
|
Double
|
Sí | Es el costo total del envío de una transacción. |
Código de moneda | Fields.CURRENCY_CODE
|
String
|
No | Se refiere a la moneda local de una transacción. El valor predeterminado es la moneda de la vista (perfil) en la que se visualizan las transacciones. |
Los elementos tienen los siguientes campos:
Nombre del campo | Monitor de campo | Tipo | Obligatorio | Descripción |
---|---|---|---|---|
ID de transacción | Fields.TRANSACTION_ID
|
String
|
Sí | El ID de transacción con el que se debe asociar el artículo |
Nombre | Fields.ITEM_NAME
|
String
|
Sí | Es el nombre del producto. |
SKU | Fields.ITEM_SKU
|
String
|
Sí | El SKU de un producto |
Categoría | Fields.ITEM_CATEGORY
|
String
|
No | Una categoría a la que pertenece el producto |
Precio | Fields.ITEM_PRICE
|
Double
|
Sí | El precio de un producto |
Cantidad | Fields.ITEM_QUANTITY
|
Long
|
Sí | La cantidad de un producto |
Código de moneda | Fields.CURRENCY_CODE
|
String
|
No | Se refiere a la moneda local de una transacción. El valor predeterminado es la moneda de la vista (perfil) en la que se informan las transacciones. |
Los datos de comercio electrónico se usan principalmente en los siguientes informes estándares:
- Descripción general de Comercio electrónico
- Rendimiento de productos
- Rendimiento de ventas
- Transacciones
- Tiempo hasta la compra
Implementación
Para enviar los datos de transacciones y artículos a Google Analytics, es necesario configurar los valores de los campos de artículos y de transacciones en la herramienta de seguimiento y enviarlos, uno a la vez. Por ejemplo:
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 }
Los campos de moneda de comercio electrónico admiten valores de moneda negativos, lo que puede ser necesario en el caso de reembolsos o devoluciones.
Especificación de monedas
De forma predeterminada, se supone que los valores de la transacción están en la moneda de la vista (perfil) en la que se informan.
Para anular la moneda local de una transacción y cualquier producto asociado, configura el campo de código de moneda de la transacción y los hits de artículo con el nuevo código de moneda. Para obtener la lista completa de las monedas y los códigos de moneda admitidos, consulta la Referencia de las monedas admitidas.
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. }