Seguimiento de comercio electrónico: SDK de iOS

En este documento, se proporciona una descripción general de cómo medir los ingresos y pagos integrados en la app con la versión 3 del SDK de Google Analytics para iOS.

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 kGAITransactionId NSString Sí Es un ID único que representa la transacción. Este ID no debe superponerse con otros ID de transacción.
Afiliación kGAITransactionAffiliation NSString Sí Es una entidad a la que debe estar afiliada la transacción (p. ej., una tienda en particular).
Ingresos kGAITransactionRevenue NSNumber Sí Indica los ingresos totales de una transacción, incluidos los impuestos y el envío.
Impuesto kGAITransactionTax NSNumber Sí Impuesto total de una transacción
Envío kGAITransactionShipping NSNumber Sí Es el costo total del envío de una transacción.
Código de moneda kGAICurrencyCode NSString 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 kGAITransactionId NSString Sí El ID de transacción con el que se debe asociar el artículo
Nombre kGAIItemName NSString Sí Es el nombre del producto.
SKU kGAIItemSku NSString Sí El SKU de un producto
Categoría kGAIItemCategory NSString No Una categoría a la que pertenece el producto
Precio kGAIItemPrice NSNumber Sí El precio de un producto
Cantidad kGAIItemQuantity NSNumber Sí La cantidad de un producto
Código de moneda kGAICurrencyCode NSString 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:

/*
 * Called when a purchase is processed and verified.
 */
- (void)onPurchaseCompleted {

  // Assumes a tracker has already been initialized with a property ID, otherwise
  // this call returns null.
  id tracker = [[GAI sharedInstance] defaultTracker];



  [tracker send:[[GAIDictionaryBuilder createTransactionWithId:@"0_123456"             // (NSString) Transaction ID
                                                   affiliation:@"In-app Store"         // (NSString) Affiliation
                                                       revenue:@2.16F                  // (NSNumber) Order revenue (including tax and shipping)
                                                           tax:@0.17F                  // (NSNumber) Tax
                                                      shipping:@0                      // (NSNumber) Shipping
                                                  currencyCode:@"USD"] build]];        // (NSString) Currency code


  [tracker send:[[GAIDictionaryBuilder createItemWithTransactionId:@"0_123456"         // (NSString) Transaction ID
                                                              name:@"Space Expansion"  // (NSString) Product Name
                                                               sku:@"L_789"            // (NSString) Product SKU
                                                          category:@"Game expansions"  // (NSString) Product category
                                                             price:@1.9F               // (NSNumber) Product price
                                                          quantity:@1                  // (NSInteger) Product quantity
                                                      currencyCode:@"USD"] build]];    // (NSString) Currency code

}

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.

/*
 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).
 */
- (void)onPurchaseCompleted {

  // Assumes a tracker has already been initialized with a property ID, otherwise
  // this call returns null.
  id tracker = [[GAI sharedInstance] defaultTracker];

  [tracker send:[[GAIDictionaryBuilder createTransactionWithId:@"0_123456",         // (NSString) Transaction ID, should be unique among transactions.
                                                   affiliation:@"In-app Store",     // (NSString) Affiliation
                                                       revenue:(int64_t) 2.16,      // (int64_t) Order revenue (including tax and shipping)
                                                           tax:(int64_t) 0.17,      // (int64_t) Tax
                                                      shipping:(int64_t) 0,         // (int64_t) Shipping
                                                  currencyCode:@"EUR"] build]];     // (NSString) Currency code
}