Referencia de datos de Magento 2

Qué aprenderás

Conozca qué datos importa Klaviyo de su tienda Magento 2 cuando integra las dos plataformas. La integración de Klaviyo con Magento 2 extrae todos los datos históricos de su tienda Magento 2 con la sincronización histórica inicial. Una vez habilitada, la integración también comenzará a sincronizar las métricas y los datos de los clientes casi en tiempo real. Ejemplos de estos datos son la información asociada a pedidos anteriores realizados, pedidos cumplidos, etc.

En Klaviyo, puede navegar a la pestaña Analytics de su cuenta en la barra lateral izquierda para ver todas las métricas de su cuenta; las métricas con un icono de Magento 2 son las sincronizadas desde su integración con Magento 2.

Cómo determina Klaviyo las métricas de Magento 2

Métricas de pedidos

Las métricas de pedido de Magento 2 vienen determinadas por el campo Estado de un pedido en su tienda Magento 2.

Cada vez que se cree un pedido, o se actualice su estado, se evaluará con respecto a la matriz que figura a continuación para determinar qué eventos deben activarse.

Si tiene estados de pedido personalizados que no deberían activar una métrica de Pedido realizado , o no se ajustan a la tabla anterior, háganoslo saber y podremos ajustar la asignación de estados de pedido en consecuencia en su integración.

Los pedidos con el estado "pendiente_pago" serán ignorados.

Métrica de pago iniciada

Con un proceso de pago estándar de Magento, este evento se activa cuando un cliente introduce su información de contacto y de envío en la primera página del proceso de pago de Magento y hace clic en Continuar. 

El evento Pago iniciado depende de que se haya creado una "Cotización" y de que tenga asociada una dirección de correo electrónico. Esto ocurre después de que el cliente haya introducido su dirección de correo electrónico en la fase de "Información de envío" del proceso de pago. Si un cliente no completa el pago, esta cita se sincroniza con Klaviyo como un evento de Pago iniciado.

Si el cliente procede a completar el pedido, este presupuesto se convierte en una "factura" en la base de datos de Magento. Como resultado, no se envía a Klaviyo un evento de Pago iniciado. En su lugar, se envía un evento Pedido realizado. Tenga en cuenta que puede tardar hasta 1 hora para que los eventos de Pago iniciado se sincronicen con Klaviyo.

Métrica de envíos realizados

Esta métrica se activa cuando se crea un nuevo Envío en su tienda Magento 2.

Métricas de Magento 2

Esta sección cubre cada una de las métricas de Magento 2 y los datos que están disponibles para filtrar al crear segmentos y flujos.

Pedido cancelado

Este evento se activa cuando se cambia el estado de un pedido a cancelado o anulado en su tienda Magento 2.

• ProductCategories: Las categorías de los productos del pedido cancelado.
• Valor: El valor de la orden cancelada.
• Descontado: (Verdadero o Falso) El estado de descuento del pedido cancelado.
• OrderedProducts: Los nombres de los productos del pedido cancelado.
• CuentaProductosPedidos: El número de productos del pedido cancelado.
• OrderCurrencyCode: El código de divisa utilizado con la orden cancelada.
• CartPriceRuleIDs: Un array de Cart Price Rule IDs (cadenas de id numéricas) que incluyen las reglas aplicadas automáticamente y la regla para un cupón aplicado.

Pedido cumplido

Este evento se rastrea cuando se establece el estado de un pedido como completado en su tienda Magento 2.

• ProductCategories: Las categorías de los productos del pedido.
• Valor: El valor del pedido.
• Con descuento: Si el pedido tiene descuento o no.
• OrderedProducts:Los nombres de los productos del pedido.
• OrderedProductCount: El número de productos del pedido.
• OrderCurrencyCode: El código de divisa utilizado con el pedido.

Envío realizado

Este evento se rastrea cuando se crea un nuevo Envío en su tienda Magento 2.

• StoreName: El nombre de la tienda donde se realizó el pedido.
• StoreID: El ID de la tienda donde se realizó el pedido.
• BillingAddress: La dirección de facturación del pedido.
• Seguimiento: Información sobre el seguimiento del envío.

Producto pedido

Este evento se rastrea una vez por cada producto que pide un usuario cuando realiza un pedido.

• SKU: La SKU del producto.
• OrderCurrencyCode:El código de moneda del producto.
• Precio: El valor del producto.
• Categorías: La categoría del producto.
• Descuento: Cualquier descuento aplicado al producto.
• Cantidad: El número de productos.
• Valor: El valor del producto.
• ProductID: El ID del producto.

Pedido realizado

Este evento se rastrea cuando un usuario realiza un pedido.

• ProductCategories: Las categorías de los productos del pedido.
• Valor: El valor del pedido.
• Con descuento: Si el pedido tiene descuento o no.
• OrderedProducts:Los nombres de los productos del pedido.
• OrderedProductCount: El número de productos del pedido.
• OrderCurrencyCode: El código de divisa utilizado con el pedido.
• CartPriceRuleIDs: Un array de Cart Price Rule IDs (cadenas de id numéricas) que incluyen las reglas aplicadas automáticamente y la regla para un cupón aplicado.

Pedido reembolsado

Este evento se activa cuando un cliente reembolsa un pedido. 

• Valor: El valor del pedido.
• Con descuento: Si el pedido tiene descuento o no. 
• OrderedProducts: Los nombres de todos los productos del pedido.
• OrderedProductCount: El número de productos del pedido. 
• OrderCurrencyCode: El código de divisa utilizado con el pedido. 
• ProductCategories: Las categorías de los productos del pedido. 
• CartPriceRuleIDs: Un array de Cart Price Rule IDs (cadenas de id numéricas) que incluyen las reglas aplicadas automáticamente y la regla para un cupón aplicado.

Pago iniciado

Este evento se activa cuando un cliente con una dirección de correo electrónico conocida inicia un proceso de pago. En una página de pago estándar, este evento se activa cuando un cliente introduce su información de contacto y de envío en la primera página del proceso de pago de Magento y hace clic en Continuar. No se envía a Klaviyo un evento de pago iniciado si el usuario completa el pago. En su lugar, se registra un evento de Pedido realizado.

• Valor: El valor del pedido durante el pago.
• ItemCount: El número de artículos del pedido. 
• Artículos: Los artículos del pedido. 
• ProductCategories: Las categorías de los productos del pedido. 
• NombresDeLosProductos: Los nombres de los productos del pedido. 
• StoreName: El nombre de la tienda donde se inició el pedido.
• StoreID: El ID de la tienda donde se inició el pedido.

Añadido a la cesta

Tenga en cuenta que esta métrica sólo se rastrea si utiliza la extensión Klaviyo versión 4.0.0 y superiores. Esta métrica se rastrea cuando un cliente que ha sido cocinado por Klaviyo añade un artículo a su cesta.

Incluye información detallada sobre el elemento que se ha añadido. Esto resulta útil a la hora de crear segmentos basados en los productos que los usuarios han añadido al carro, o cuando se construye un flujo de carros abandonados. Puede filtrar y orientar las métricas de Añadido a la cesta en función de los siguientes criterios:

• MaskedQuoteId: MaskedQuoteId o identificador único para los clientes registrados.
• AddedItemCategories: Las categorías a las que pertenece el artículo.
• AddedItemProductName: El nombre del producto en su tienda, por ejemplo, Camiseta roja.
• AddedItemDescription: La descripción del artículo.
• AddedItemImageURLKey: La URL de la imagen del artículo.
• AddedItemPrice: El precio del artículo.
• AddedItemProductID: El ID personalizado en su tienda Magento 2 del producto, por ejemplo, 1234.
• AddedItemSKU: El SKU del artículo en su tienda, por ejemplo, REDMEDIUMTSHIRT.
• AddedItemURL: La URL del artículo.

Klaviyo genera una clave, la clave de reconstrucción del carrito, que le permite crear un enlace que reconstruye el carrito del cliente en caso de que vuelva a su carrito a través de un correo electrónico provocado por este evento en otro dispositivo. Esta clave se encuentra dentro de la matriz de propiedades 'extra'. Puede crear este enlace utilizando la siguiente URL:

{{ organization.url|trim_slash }}reclaim/checkout/cart?quote_id={{ event.MaskedQuoteId }}

Datos de clientes sincronizados

Klaviyo crea un contacto a partir de la creación de un pedido, de un registro de cliente existente o cuando se inicia un proceso de pago. Klaviyo creará un nuevo Perfil Klaviyo para cada contacto sincronizado, y rellenará este perfil con la siguiente información:

• Correo electrónico
• Nombre y apellidos
• Ciudad, Estado/Región, Código postal, País
• Número de teléfono
• Cuenta Magento creada (por ejemplo, AAAA-mm-dd hh:mm:ss; 2015-05-21 13:04:00)
• Grupo de clientes de Magento (por ejemplo, mayoristas)
• Tienda Magento (por ejemplo, tienda en EE.UU.)
• Fecha de nacimiento (por ejemplo, AAAA-mm-dd; 1990-03-25)
• Género

Si actualiza el grupo de clientes en Magento 2, incluso después de haber creado el perfil original en Klaviyo, el grupo de clientes se actualizará en Klaviyo.

Verifique los datos de sus pedidos sincronizados

Klaviyo importa todos sus datos de Magento 2. Para comprobarlo, puede comparar el número de pedidos de un día concreto con lo que aparece en la interfaz de Magento 2 y confirmar que coinciden. Haga clic en Analítica en la barra lateral izquierda, busque la métrica Pedido realizado y haga clic en ella. Esto le llevará a la página del gráfico de métricas y mostrará por defecto los datos de los últimos 30 días. A continuación puede ver un ejemplo del gráfico métrico.

Pase el ratón por encima del punto de datos de ayer o mire en la tabla de datos situada debajo del gráfico para ver cuántos pedidos tuvo ayer. Compare ese número con el que está almacenado en Magento y debería ver que coinciden exactamente. Si no lo hacen, lo más probable es que la zona horaria de su cuenta de Klaviyo no coincida con la zona horaria de Magento.

Para comprobar o actualizar la zona horaria de tu cuenta:

1. Haz clic en el nombre de tu organización en la parte inferior izquierda.
2. Selecciona Configuración.
3. Vaya a la pestaña Organización . 

Es posible que vea que el valor de ingresos en su tablero de Klaviyo no siempre coincide con el valor de ingresos que ve en Magento; esto se debe a que Klaviyo no resta los pedidos cancelados y reembolsados de nuestro cálculo de ingresos.

Recursos adicionales

• Cómo integrarse con Magento 2.x (CE y EE)
• Solución de problemas de integración en Magento 2