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 |
Sí | ID único que representa la transacción. Este ID no debe coincidir con otros ID de transacción. |
Afiliación |
kGAITransactionAffiliation |
NSString |
Sí | Entidad a la que debe ir afiliada la transacción (por ejemplo, una tienda concreta) |
Ingresos |
kGAITransactionRevenue |
NSNumber |
Sí | Los ingresos totales de una transacción, incluidos los impuestos y los gastos de envío |
Impuestos |
kGAITransactionTax |
NSNumber |
Sí | Los impuestos totales de una transacción |
Envío |
kGAITransactionShipping |
NSNumber |
Sí | 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 |
Sí | El ID de transacción al que debe asociarse el artículo |
Nombre |
kGAIItemName |
NSString |
Sí | El nombre del producto |
Código SKU |
kGAIItemSku |
NSString |
Sí | 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 |
Sí | El precio de un producto |
Cantidad |
kGAIItemQuantity |
NSNumber |
Sí | 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 }