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 todo el histórico de datos de tu tienda Magento 2 con la sincronización histórica inicial. Una vez habilitada, la integración también empezará a sincronizar los datos de pedidos y clientes cada 30 minutos. Algunos ejemplos de estos datos incluyen la información asociada a pedidos anteriores realizados, pedidos completados, etc.

En Klaviyo, puedes ir a la pestaña Analytics de tu cuenta en la barra lateral izquierda para ver todas las métricas de tu cuenta; las métricas con un icono de Magento 2 son los eventos de pedido sincronizados desde tu integración de Magento 2. También verás eventos de seguimiento en el sitio de Klaviyo con un icono de engranaje; estos también se registran a través de la integración.

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

Métricas de pedidos

Las métricas de pedidos de Magento 2 se determinan mediante el campo Estado en un pedido de 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 de abajo para determinar qué eventos se deben activar.

Si tienes estados de pedido personalizados que no deberían activar una métrica Placed Order , o no se ajustan a la tabla anterior, háznoslo saber y podremos ajustar la asignación del estado del pedido en tu integración según corresponda.

Los pedidos con el estado «pending_payment» se ignorarán.

Métrica de pago iniciado

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 Started Checkout depende de que se cree un «Quote» y de que tenga asociada una dirección de email. Esto ocurre después de que el cliente haya introducido su dirección de email en la etapa de pago «Shipping Information». Si un cliente no completa el pago, este quote se sincroniza con Klaviyo como un evento Started Checkout.

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 Started Checkout. En su lugar, se envía un evento Placed Order. Ten en cuenta que los eventos Started Checkout pueden tardar hasta 1 hora en sincronizarse con Klaviyo.

Métrica de envío completado

Esta métrica se activa cuando se crea un nuevo envío en tu tienda de Magento 2.

Datos de métricas de Magento 2

Esta sección trata 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 se cambia a canceled o canceled en tu tienda de Magento 2.

• Categorías de productos
  Las categorías de los productos del pedido cancelado.
• Valor
  El valor del pedido cancelado.
• Con descuento
  (Verdadero o falso) El estado de descuento del pedido cancelado.
• OrderedProducts
  Los nombres de los productos del pedido cancelado.
• OrderedProductCount
  El número de productos del pedido cancelado.
• OrderCurrencyCode
  El código de moneda utilizado con el pedido cancelado.
• CartPriceRuleIDs
  Una matriz de IDs de reglas de precio del carrito (cadenas de id numéricos) que incluye las reglas aplicadas automáticamente y la regla de un cupón aplicado.
• external_catalog_id
  
  Se usa para organizar los catálogos en Klaviyo.

Pedido Procesado

Este evento se registra cuando estableces el estado de un pedido como complete en tu tienda de Magento 2.

• CategoríasDeProducto
  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 moneda usado con el pedido.
• external_catalog_id
  
  Se usa para organizar los catálogos en Klaviyo.

Envío Completado

Este evento se registra cuando se crea un nuevo Envío en tu tienda de Magento 2.

• StoreName
  El nombre de la tienda donde se hizo el pedido.
• StoreID
  El ID de la tienda donde se realizó el pedido.
• Dirección de facturación
  La dirección de facturación del pedido.
• Realiza el seguimiento
  Información sobre el seguimiento de envíos.
• external_catalog_id
  
  Se usa para organizar los catálogos en Klaviyo.

Producto Pedido

De forma predeterminada, se realiza un seguimiento de este evento una vez por cada producto que solicita un usuario cuando hace un pedido.

• SKU
  El SKU del producto.
• OrderCurrencyCode
  El código de moneda del producto.
• Precio
  El valor del producto.
• Categorías
  La categoría del producto.
• Con descuento
  Cualquier descuento aplicado al producto.
• Quantity
  El número de productos.
• Valor
  El valor del producto.
• ID de producto
  El ID del producto.
• RootProductID
  El ID del producto principal.
• external_catalog_id
  
  Se usa para organizar los catálogos en Klaviyo.

Pedido Realizado

Este evento se rastrea cuando un usuario realiza un pedido.

• CategoríasDeProducto
  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 moneda usado con el pedido.
• CartPriceRuleIDs
  Una matriz de IDs de reglas de precio del carrito (cadenas de id numéricos) que incluye las reglas aplicadas automáticamente y la regla de un cupón aplicado.
• external_catalog_id
  
  Se usa para organizar los catálogos 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.
• Productos pedidos
  Los nombres de todos los productos del pedido.
• OrderedProductCount
  El número de productos del pedido.
• OrderCurrencyCode
  El código de moneda usado con el pedido.
• CategoríasDeProducto
  Las categorías de los productos del pedido.
• CartPriceRuleIDs
  Una matriz de IDs de reglas de precio del carrito (cadenas de id numéricos) que incluye las reglas aplicadas automáticamente y la regla de un cupón aplicado.
• external_catalog_id
  
  Se usa para organizar los catálogos en Klaviyo.

Pago iniciado

Este evento se activa cuando un cliente con una dirección de email 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 Started Checkout si el usuario completa el proceso de pago. En su lugar, se registra un evento Placed Order.

• Valor
  El valor del pedido durante el proceso de pago.
• ItemCount
  El número de artículos del pedido.
• Artículos
  Los artículos del pedido.
• CategoríasDeProducto
  Las categorías de los productos del pedido.
• Nombres de productos
  Los nombres de los productos del pedido.
• StoreName
  El nombre de la tienda donde se inició el pedido.
• ID de tienda
  El ID de la tienda en la que se inició el pedido.
• external_catalog_id
  
  Se usa para organizar los catálogos en Klaviyo.

Añadido al Carrito

Ten en cuenta que esta métrica solo se registra si usas la versión 4.0.0 o superior de la extensión de Klaviyo. Esta métrica se registra cuando un cliente al que Klaviyo le ha asignado una cookie añade un artículo a su carrito.

Incluye información detallada sobre el artículo que se ha añadido. Esto resulta útil al crear segmentos basados en los productos que los usuarios han añadido al carrito o al crear un flujo de carrito abandonado. Puedes filtrar y orientar métricas de Añadido al carrito en función de los siguientes criterios:

• MaskedQuoteId
  MaskedQuoteId o identificador único para clientes con sesión iniciada.
• CategoríasDeArtículosAñadidos
  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 del producto en tu tienda de Magento 2, p. ej., 1234.
• AddedItemSKU
  El SKU del artículo en tu tienda (p. ej., REDMEDIUMTSHIRT).
• AddedItemURL
  La URL del artículo.
• external_catalog_id
  
  Se usa para organizar los catálogos en Klaviyo.
• integration_key
  Es la plataforma de comercio electrónico que usas (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 a través de un email activado por este evento en otro dispositivo. Esta clave se puede encontrar dentro de la matriz de propiedades «extra». Puedes crear este enlace usando la siguiente URL:

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

Producto visto

Se hace un seguimiento de esta métrica cuando un cliente 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.
• Name
  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 aplicar 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 usa para organizar los catálogos en Klaviyo.
• integration_key
  Es la plataforma de comercio electrónico que usas (Magento 2).

Actividad en el Sitio

Esta métrica se registra cuando un cliente está activo en tu sitio. Puedes filtrar y orientar las métricas de Activo en el sitio en función de los siguientes criterios:

• utm_medium
  El medio del parámetro de seguimiento de UTM (por ejemplo, campaña).
• kx_present
  (True or False) Si el parámetro kx está presente.
• sistema operativo
  El sistema operativo del dispositivo del usuario.
• initial_page_path
  La ruta de URL de la página inicial en la que aterrizó el usuario.
• navegador
  El tipo de navegador del usuario.
• página
  El URL de la página en la que el usuario estaba activo.
• utm_campaign
  El parámetro de seguimiento de UTM para la campaña.
• utm_source
  La fuente de UTM (Urchin Tracking Module) (p. ej., Klaviyo).

Datos del cliente sincronizados

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

• Email
• Nombre y apellidos
• Ciudad, estado/región, código postal, país
• Phone Number
• 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., mayoristas)
• Tienda de Magento (p. ej., tienda de EE. UU.)
• Fecha de nacimiento (p. ej., aaaa-mm-dd; 1990-03-25)
• Género

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

Valor de ingresos

Puede que veas que el valor de Ingresos en tu 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