Seguimiento de comercio electrónico: SDK para iOS

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

Descripción general

La medición del comercio electrónico permite enviar datos de las compras y las ventas integradas en la aplicación a Google Analytics. Los datos de comercio electrónico en Google Analytics se componen de hits de transacción y de artículo, relacionados por un ID de transacción compartido.

Las transacciones tienen los siguientes campos:

Nombre del campo Campo de seguimiento Tipo Obligatorio Descripción
ID de transacción kGAITransactionId NSString ID único que representa la transacción. Este ID no debe coincidir con otros ID de transacción.
Afiliación kGAITransactionAffiliation NSString Entidad a la que debe ir afiliada la transacción (por ejemplo, una tienda concreta)
Ingresos kGAITransactionRevenue NSNumber Los ingresos totales de una transacción, incluidos los impuestos y los gastos de envío
Impuestos kGAITransactionTax NSNumber Los impuestos totales de una transacción
Envío kGAITransactionShipping NSNumber El coste total del envío de una transacción
Código de moneda kGAICurrencyCode NSString No La moneda local de una transacción. La moneda predeterminada es la de la vista (perfil) en la que se visualizan las transacciones.

Los artículos tienen los siguientes campos:

Nombre del campo Campo de seguimiento Tipo Obligatorio Descripción
ID de transacción kGAITransactionId NSString El ID de transacción al que debe asociarse el artículo
Nombre kGAIItemName NSString El nombre del producto
Código SKU kGAIItemSku NSString El código SKU de un producto
Categoría kGAIItemCategory NSString No Una categoría a la que pertenece el producto
Que no sea caro kGAIItemPrice NSNumber El precio de un producto
Cantidad kGAIItemQuantity NSNumber La cantidad de un producto
Código de moneda kGAICurrencyCode NSString No La moneda local de una transacción. La moneda predeterminada es la de la vista (perfil) en la que aparecen las transacciones.

Los datos de comercio electrónico se usan principalmente en los siguientes informes estándar:

  • Visión general de comercio electrónico
  • Rendimiento del producto
  • Rendimiento de las ventas
  • Transacciones
  • Tiempo hasta la compra

Implementación

El envío de datos de transacción y de artículos a Google Analytics hace necesario establecer los valores de los campos de transacción y artículo en el objeto de seguimiento y enviarlos uno por uno. 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, ya que pueden resultar útiles en caso de reembolso o de devolución.

Configuración de monedas

De forma predeterminada, se supone que los valores de transacción corresponden a la moneda de la vista (perfil) en la que se muestran.

Para anular la moneda local de una transacción y todos los productos asociados, configura el nuevo código de moneda del campo correspondiente de los hits de transacción y de artículo. Para ver la lista completa de las monedas y los códigos de moneda admitidos, consulta la referencia de 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
}