Seguimiento de comercio electrónico: SDK de Android

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