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íos |
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 }