Referencia de datos de Magento 2

Descubre qué datos importa Klaviyo de tu tienda de Magento 2 cuando integras las dos plataformas. La sincronización histórica inicial importa hasta 5 años de datos de pedidos y clientes, incluida la información asociada a pedidos anteriores realizados y tramitados. 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étricas en la barra lateral izquierda para ver todas las métricas de la cuenta; las métricas con un icono de Magento 2 son los eventos sincronizados desde las integraciones de Magento 2. También verás eventos de seguimiento in situ 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

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

Cuando se crea o se actualiza un pedido, Klaviyo comprueba su estado actual y el historial de estados. La tabla siguiente muestra las asignaciones estándar. Los pedidos con pending_payment o 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 que no se ajustan a la tabla anterior, háznoslo saber para que podamos configurar los estados personalizados para que se ignoren o se asignen a eventos de pedido adicionales.

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

Si el cliente completa el pedido antes de que se sincronice el carrito, el carrito deja de estar activo y Klaviyo lo omite. Se registra un evento Placed Order cuando se sincroniza el pedido, a menos que se ignore su estado. Un evento Started Checkout que ya se ha sincronizado se mantiene en Klaviyo. 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 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 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.
• ProductNames
  Los nombres de los productos del pedido cancelado.
• ItemCount
  El número de líneas de pedido del pedido, no la cantidad total de unidades.
• 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.
• Nombres de productos
  Los nombres de los productos del pedido.
• ItemCount
  El número de líneas de pedido del pedido, no la cantidad total de unidades.
• 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

Klaviyo registra 1 evento Ordered Product por cada unidad pedida, hasta 100 eventos por artículo de línea. Por ejemplo, un pedido de 3 camisetas iguales genera 3 eventos Ordered Product, cada uno con una Quantity de 1. En el caso de 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.
• Precio
  El valor del producto.
• Categorías
  La categoría del producto.
• Con descuento
  (Verdadero o falso) Indica si se aplicó un descuento al producto.
• Cantidad
  La cantidad representada por este evento: 1 para compras de unidades enteras o la cantidad pedida para productos vendidos en cantidades fraccionarias.
• 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.
• Nombres de productos
  Los nombres de los productos del pedido.
• ItemCount
  El número de líneas de pedido del pedido, no la cantidad total de unidades.
• 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 el estado de un pedido cambia a cerrado en Magento 2. Un reembolso parcial que deja el pedido en otro estado no activa Refunded Order mediante la asignación de estados estándar.

• Valor
  El valor del pedido.
• Con descuento
  Si el pedido tiene descuento o no.
• ProductNames
  Los nombres de todos los productos del pedido.
• ItemCount
  El número de líneas de pedido del pedido, no la cantidad total de unidades.
• 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 y el carrito sigue activo con artículos cuando Klaviyo lo sincroniza. En una página de pago estándar, el cliente introduce su información de contacto y de envío y hace clic en Continuar. Si completa el proceso de pago antes de que se sincronice el carrito, Klaviyo se salta el evento Started Checkout y registra Placed Order cuando se sincroniza el pedido, a menos que se ignore su estado. Completar un pedido no elimina un evento Started Checkout que ya se haya sincronizado.

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

Utiliza el valor MaskedQuoteId del evento Added To Cart para crear un enlace que reconstruya el carrito del cliente cuando vuelva desde un email en otro dispositivo. Utiliza la siguiente URL:

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

Producto visto

Esta métrica se realiza un seguimiento cuando Klaviyo puede identificar que 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 que Klaviyo puede identificar está activo en tu sitio. Puedes usar la actividad Activo en el sitio en segmentos y flujos, pero las propiedades del evento que aparecen a continuación no están disponibles para los filtros de segmento ni los filtros de flujo. Puedes inspeccionarlos en los datos sin procesar del evento:

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

• Email
• Nombre y apellidos
• Ciudad, estado/región, código postal, país
• Phone Number
• 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., 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

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 que se muestran en Magento.

Recursos adicionales