Referencia de datos de Magento 2

Descubre qué datos importa Klaviyo de tu tienda Magento 2 cuando integras ambas plataformas. La sincronización histórica inicial importa hasta 5 años de datos de pedidos y clientes, incluida la información asociada con pedidos anteriores realizados y completados. Una vez habilitada, la integración también sincroniza los datos de pedidos y clientes cada 30 minutos.

En Klaviyo, ve a Análisis > Métrica en la barra lateral izquierda para ver todas las métricas de tu cuenta; las métricas con un ícono de Magento 2 son los eventos sincronizados desde tus integraciones de Magento 2. También verás eventos de seguimiento en el sitio de Klaviyo con un ícono de engranaje; estos también se registran mediante las integraciones.

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

Métricas de pedidos

Klaviyo registra un evento de Pedido realizado por cada pedido que sincroniza. También usa el Estado actual del pedido y el historial de estado en Magento 2 para registrar métricas adicionales de pedidos.

Cuando se crea o actualiza un pedido, Klaviyo revisa el estado actual y el historial de estados. La tabla siguiente muestra las asignaciones estándar. Los pedidos con pending_payment o con un estado personalizado configurado para ignorarse se excluyen.

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 para que podamos configurar los estados personalizados para ignorarlos o asignarlos a eventos de pedido adicionales.

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 un carrito (llamado cotización en Magento) con una dirección de correo electrónico asociada. Klaviyo lo sincroniza solo si el carrito sigue con actividad y contiene artículos cuando se ejecuta la sincronización.

Si el cliente completa el pedido antes de que el carrito se sincronice, el carrito ya no está con actividad y Klaviyo lo omite. Se registra un evento Placed Order cuando el pedido se sincroniza, a menos que se ignore su estado. Un evento Started Checkout que ya se sincronizó permanece en Klaviyo. Ten en cuenta que los eventos 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 cubre las métricas de Magento 2 y los datos 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.
• Nombres de productos
  Los nombres de los productos en el pedido cancelado.
• ItemCount
  La cantidad de partidas del pedido, no la cantidad total de unidades.
• 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.
• ProductNames
  Los nombres de los productos del pedido.
• ItemCount
  La cantidad de partidas del pedido, no la cantidad total de unidades.
• 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

Klaviyo registra 1 evento de Producto pedido por unidad pedida, hasta 100 eventos por partida. Por ejemplo, un pedido de 3 playeras iguales genera 3 eventos de Producto pedido, cada uno con una cantidad de 1. Para productos vendidos en cantidades fraccionarias, Klaviyo registra 1 evento con la cantidad pedida.

• 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
  (Verdadero o falso) Si se aplicó un descuento al producto.
• Cantidad
  La cantidad representada por este evento: 1 para compras de unidades completas, o la cantidad ordenada para productos vendidos en cantidades fraccionarias.
• 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.

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.
• ProductNames
  Los nombres de los productos del pedido.
• ItemCount
  La cantidad de partidas del pedido, no la cantidad total de unidades.
• 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 el estado de un pedido se cierra en Magento 2. Un reembolso parcial que deja el pedido en otro estado no activa Pedido reembolsado a través de la asignación de estado estándar.

• Valor
  El valor del pedido.
• Con descuento
  Si el pedido tiene descuento o no.
• Nombres de productos
  Los nombres de todos los productos del pedido.
• ItemCount
  La cantidad de partidas del pedido, no la cantidad total de unidades.
• 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 y el carrito todavía tiene artículos con actividad cuando Klaviyo lo sincroniza. En una página de pago estándar, el cliente ingresa su información de contacto y envío y hace clic en Continuar. Si completan el pago antes de que el carrito se sincronice, Klaviyo omite Started Checkout y registra Placed Order cuando el pedido se sincroniza, a menos que se ignore su estado. Completar un pedido no elimina un evento Pago iniciado que ya se haya sincronizado.

• Valor
  El valor del pedido durante el proceso de pago.
• ItemCount
  La cantidad de elementos de línea en el carrito, no la cantidad total de unidades.
• 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).

Usa el valor de MaskedQuoteId del evento Added To Cart para crear un enlace que reconstruya el carrito del cliente cuando regrese desde un correo electrónico en otro dispositivo. Usa la siguiente URL:

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

Producto Visto

Esta métrica se rastrea cuando un cliente que Klaviyo puede identificar ve un producto en tu sitio. Puedes filtrar y orientar las 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

Esta métrica se rastrea cuando un cliente que Klaviyo puede identificar está con actividad en el sitio. Puedes usar la actividad con actividad en el sitio en segmentos y flujo, pero las propiedades del evento que se indican a continuación no están disponibles para segmentos ni para filtro de flujo. Puedes revisarlas en los datos sin procesar del evento:

• utm_medium
  El medio del parámetro de seguimiento de UTM (p. ej., campaña).
• kx_present
  Verdadero cuando el parámetro kx está presente en la URL. El campo se omite cuando el parámetro no 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 o actualiza perfiles a partir de pedidos sincronizados, registros de clientes y checkouts iniciados. La siguiente información se agrega cuando está disponible en los datos de origen:

• 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., YYYY-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.

Valor de ingresos

Cuando usas la métrica Placed Order de Magento 2 para medir los ingresos, los pedidos cancelados y reembolsados no se restan automáticamente. Esto puede hacer que los ingresos que se muestran en Klaviyo difieran de los ingresos que se muestran en Magento.

Recursos adicionales