Referencia de datos de Magento 2
Descubre qué datos importa Klaviyo de tu tienda Magento 2 cuando integras ambas plataformas. La integración de Klaviyo con Magento 2 incorpora todos los datos históricos de la tienda de Magento 2 con la sincronización histórica inicial. Una vez habilitada, la integración también comenzará a sincronizar los datos de pedidos y clientes cada 30 minutos. Algunos ejemplos de estos datos incluyen la información asociada con pedidos realizados anteriormente, pedidos completados, etc.
En Klaviyo, puedes ir a la pestaña de Analytics de la cuenta en la barra lateral izquierda para ver todas las métricas de la cuenta; las métricas con un ícono de Magento 2 son los eventos de pedido sincronizados desde las integraciones de Magento 2. También verás eventos de seguimiento onsite de Klaviyo con un ícono de engrane; estos también se rastrean mediante las integraciones.
Cómo Klaviyo determina las métricas de Magento 2
Métricas de pedidos
Las métricas de pedidos de Magento 2 se determinan según el campo Estado de un pedido en tu tienda de Magento 2.
Cada vez que se crea un pedido o se actualiza su estado, se evaluará en función de la matriz que aparece a continuación para determinar qué eventos se deben activar.
Estado del pedido de Magento | Métrica activada en Klaviyo |
Completar | Pedido completado |
cancelado, cancelado | Pedido Cancelado |
pay_aborted | Pago cancelado |
Cerrado | Pedido Reembolsado |
Todos los demás estados de pedido | Pedido realizado |
Si tienes estados de pedido personalizados que no deberían activar una métrica de Pedido realizado , o no se alinean con la tabla anterior, avísanos y podemos ajustar el mapeo de estados de pedido en consecuencia en las integraciones.
Los pedidos con un estado de “pending_payment” se ignorarán.
Métrica Proceso de Pago Iniciado
Con un proceso de pago estándar de Magento, este evento se activa cuando un cliente ingresa su información de contacto y envío en la primera página del proceso de pago de Magento y hace clic en Continuar.
El evento Started Checkout depende de que se cree un “Quote” y tenga una dirección de correo electrónico asociada. Esto ocurre después de que el cliente haya ingresado su dirección de correo electrónico en la etapa “Shipping Information” del proceso de pago. Si un cliente no completa el proceso de pago, esta cotización se sincroniza con Klaviyo como un evento Started Checkout.
Si el cliente procede a completar el pedido, esta cotización se convierte en una "factura" en la base de datos de Magento. Como resultado, no se envía a Klaviyo un evento de Started Checkout. En su lugar, se envía un evento de Placed Order. Ten en cuenta que los eventos de Started Checkout pueden tardar hasta 1 hora en sincronizarse con Klaviyo.
Métrica Envío completado
Se activa esta métrica cuando se crea un nuevo envío en tu tienda de Magento 2.
Datos de métricas de Magento 2
Esta sección abarca 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 el estado de un pedido cambia a cancelado o cancelado en tu tienda de Magento 2.
- ProductCategories
Las categorías de los productos en el pedido cancelado. - Valor
El valor del pedido cancelado. - Con descuento
(True o False) El estado de descuento del pedido cancelado. - ProductosOrdenados
Los nombres de los productos en el pedido cancelado. - OrderedProductCount
La cantidad de productos en el pedido cancelado. - OrderCurrencyCode
El código de moneda usado con el pedido cancelado. - CartPriceRuleIDs
Una matriz de ID de reglas de precio del carrito (cadenas de ID numéricas) que incluyen reglas aplicadas automáticamente y la regla de un cupón aplicado. - external_catalog_id
Se utiliza en la organización del catálogo en Klaviyo.
Pedido completado
Este evento se rastrea cuando estableces el estado de un pedido como completo en tu tienda de Magento 2.
- Categorías de productos
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 en el pedido. - OrderedProductCount
La cantidad de productos en el pedido. - OrderCurrencyCode
El código de moneda usado con el pedido. - external_catalog_id
Se utiliza en la organización del catálogo en Klaviyo.
Envío Completado
Se realiza un seguimiento de este evento cuando se crea un nuevo envío en tu tienda de Magento 2.
- StoreName
El nombre de la tienda donde se realizó el pedido. - ID de tienda
El ID de la tienda donde se realizó el pedido. - DirecciónDeFacturación
La dirección de facturación del pedido. - Tracks
Información sobre el seguimiento del envío. - external_catalog_id
Se utiliza en la organización del catálogo en Klaviyo.
Producto Pedido
Este evento se rastrea una vez por cada producto que un usuario pide cuando realiza un pedido.
- SKU
El SKU del producto. - OrderCurrencyCode
El código de moneda del producto. - Price
El valor del producto. - Categorías
La categoría del producto. - Con descuento
Cualquier descuento aplicado al producto. - Cantidad
La cantidad de productos. - Valor
El valor del producto. - ProductID
El ID del producto. - RootProductID
El ID del producto principal. - external_catalog_id
Se utiliza en la organización del catálogo en Klaviyo.
La métrica Producto pedido tiene varios otros campos de datos disponibles para el seguimiento. Ver los datos sin procesar de un evento de Producto pedido individual para ver todos los datos disponibles de este evento.
Pedido realizado
Este evento se rastrea cuando un usuario realiza un pedido.
- Categorías de productos
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 en el pedido. - OrderedProductCount
La cantidad de productos en el pedido. - OrderCurrencyCode
El código de moneda usado con el pedido. - CartPriceRuleIDs
Una matriz de ID de reglas de precio del carrito (cadenas de ID numéricas) que incluyen reglas aplicadas automáticamente y la regla de un cupón aplicado. - external_catalog_id
Se utiliza en la organización del catálogo en Klaviyo.
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 en el pedido. - OrderedProductCount
La cantidad de productos en el pedido. - OrderCurrencyCode
El código de moneda usado con el pedido. - Categorías de productos
Las categorías de los productos del pedido. - CartPriceRuleIDs
Una matriz de ID de reglas de precio del carrito (cadenas de ID numéricas) que incluyen reglas aplicadas automáticamente y la regla de un cupón aplicado. - external_catalog_id
Se utiliza en la organización del catálogo en Klaviyo.
Proceso de 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 ingresa 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. Klaviyo no recibe un evento Inicio de proceso de pago si el usuario completa el proceso de pago. En su lugar, se registra un evento Pedido realizado.
- Valor
El valor del pedido durante el proceso de pago. - ItemCount
La cantidad de artículos en el pedido. - Artículos
Los artículos del pedido. - Categorías de productos
Las categorías de los productos del pedido. - ProductNames
Los nombres de los productos del pedido. - NombreDeLaTienda
El nombre de la tienda donde se inició el pedido. - StoreID
El ID de la tienda donde se inició el pedido. - external_catalog_id
Se utiliza en la organización del catálogo en Klaviyo.
Se Añadió al Carrito
Toma en cuenta que esta métrica solo se registra si usas la versión 4.0.0 o posterior de la extensión de Klaviyo. Esta métrica se registra cuando un cliente al que Klaviyo le colocó cookies agrega un artículo a su carrito.
Incluye información detallada sobre el artículo que se agregó. Esto es útil al crear segmentos en función de qué productos han agregado los usuarios al carrito o al crear un flujo de carrito abandonado. Puedes filtrar y dirigir las métricas de Added To Cart en función de los siguientes criterios:
- MaskedQuoteId
MaskedQuoteId o identificador único para clientes con sesión iniciada. - AddedItemCategories
Las categorías a las que pertenece el artículo. - AddedItemProductName
El nombre del producto en tu 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 tu tienda Magento 2 del producto, p. ej., 1234. - AddedItemSKU
El SKU del artículo en tu tienda (por ejemplo, REDMEDIUMTSHIRT). - AddedItemURL
La URL del artículo. - external_catalog_id
Se utiliza en la organización del catálogo en Klaviyo. - integration_key
Tu plataforma de ecommerce (Magento 2).
Klaviyo genera una clave, la clave de reconstrucción del carrito, que te permite crear un enlace que reconstruye el carrito del cliente en caso de que vuelva a su carrito desde un correo electrónico activado por este evento en otro dispositivo. Esta clave se puede encontrar dentro del arreglo de propiedades ‘extra’. Puedes crear este enlace con la siguiente URL:
{{ organization.url|trim_slash }}reclaim/checkout/cart?quote_id={{ event.MaskedQuoteId }} Producto Visto
Esta métrica se registra cuando un cliente ve un producto en tu sitio. Puedes filtrar y dirigir métricas de Producto visto en función de los siguientes criterios:
- ProductID
El ID del producto. - Nombre
El nombre del producto. - SKU
El SKU del producto. - URL
La URL del producto. - Precio
El precio del producto. - FinalPrice
El precio final después de cualquier descuento. - Categorías
Una matriz que contiene las categorías a las que pertenece el producto. - ImageURL
La URL de la imagen del producto. - external_catalog_id
Se utiliza en la organización del catálogo en Klaviyo. - integration_key
Tu plataforma de ecommerce (Magento 2).
Con Actividad en el Sitio
Se hace seguimiento de esta métrica cuando un cliente está con actividad en tu sitio. Puedes filtrar y dirigir las métricas de Con actividad en el sitio en función de los siguientes criterios:
- utm_medium
El medio del parámetro de seguimiento de UTM (p. ej., campaña). - kx_present
(Verdadero o falso) Indica si el parámetro kx está presente. - os
El sistema operativo del dispositivo del usuario. - initial_page_path
La ruta de URL de la página inicial a la que llegó el usuario. - browser
El tipo de navegador del usuario. - página
La URL de la página en la que el usuario tuvo actividad. - utm_campaign
El parámetro de seguimiento de UTM para la campaña. - utm_source
La fuente de método de seguimiento de Urchin (UTM) (p. ej., Klaviyo).
Sincronización de los datos de clientes
Klaviyo crea un contacto a partir de la creación de un pedido existente, un registro de cliente existente o cuando se inicia un checkout. Klaviyo creará un nuevo perfil de Klaviyo para cada contacto sincronizado y completará este perfil con la siguiente información:
- Correo electrónico
- Nombre y apellido
- Ciudad, estado/región, código postal, país
- Número de teléfono
- Cuenta de Magento creada (p. ej., YYY-mm-dd hh:mm:ss; 2015-05-21 13:04:00)
- Grupo de clientes de Magento (p. ej., mayorista)
- Tienda de Magento (p. ej., tienda de EE. UU.)
- Fecha de nacimiento (p. ej., YYYY-mm-dd; 1990-03-25)
- Género
Si actualizas el grupo de clientes en Magento 2, incluso después de que se haya creado el perfil original en Klaviyo, el grupo de clientes se actualizará en Klaviyo.
No se obtendrá Website_ID. Las supresiones no se copian en Klaviyo, por lo que no estarán en la plataforma de Klaviyo.
Klaviyo no puede extraer ubicaciones de imágenes personalizadas.
Valor de ingresos
Es posible que veas que el valor de Revenue en el panel de Klaviyo no siempre coincide con el valor de ingresos que ves en Magento; esto se debe a que Klaviyo no resta los pedidos cancelados y reembolsados de nuestro cálculo de ingresos.
Recursos adicionales
- Primeros pasos con Magento 2.x (CE y EE)
Aprende a integrar Klaviyo con tu tienda de Magento 2 CE o EE. Tendrás que instalar la extensión de Klaviyo en Magento, configurar la extensión y configurar OAuth, y luego habilitar la integración en Klaviyo. Esta guía cubre todos los pasos de integración necesarios, así como cómo confirmar que la sincronización de tus datos históricos se haya realizado correctamente.
- Solucionar problemas con tu integración con Magento 2
Aprende a resolver problemas con la configuración de OAuth de Magento 2 siguiendo los pasos de solución de problemas que se describen a continuación. Si todavía tienes problemas después de seguir estos pasos, comunícate en nuestro Community o con nuestro equipo de soporte.