Referencia de datos de Magento 1

Objetivos del artículo

Descubre qué datos sincroniza tu integración existente de Magento 1 en Klaviyo, incluidos los pedidos históricos, los registros de clientes y los productos. Después de la sincronización histórica inicial, los pedidos, clientes y productos se sincronizan cada 30 minutos.

En Klaviyo, ve a Análisis > Métricas en la barra lateral izquierda para ver las métricas de la cuenta. Las métricas con un ícono de Magento se sincronizan desde las integraciones de Magento.

Métricas de Magento

Pedido Cancelado

Este evento se rastrea cuando un cliente crea un pedido en tu tienda Magento, pero luego cancela el pedido antes del cumplimiento. Klaviyo rastrea los datos asociados, incluida toda la información del producto sobre los artículos que alguien compró. La información del producto incluye nombres de productos, imágenes e información de la variante que puedes usar en correos electrónicos de seguimiento de compra.

Estos eventos incluyen los siguientes datos del pedido. Puedes usar propiedades de nivel superior para filtrar y segmentar eventos; los detalles de los atributos en extra están disponibles para el contenido del mensaje.

• Valor: El total general del pedido de Magento, incluidos impuestos y envío después de los descuentos.
• Artículos: Los nombres de los productos de cada elemento de línea del pedido (p. ej., playera o pantalones). Un nombre puede aparecer más de una vez si aparece en elementos de línea separados.
• Categorías de artículos: Las categorías de los productos en el pedido (por ejemplo: camisetas, ropa para hombre, pantalones y oferta).
• Número de artículos: El número de artículos de línea en el pedido (por ejemplo, 2). Esta no es la suma de las cantidades solicitadas.
• Código de moneda: El código de moneda del pedido (p. ej., USD o EUR).
• Con descuento: Si se aplicó un descuento al pedido (verdadero o falso).
• Coupon: El código de cupón aplicado.
• Artículos únicos: Los nombres de los productos en el pedido, con los duplicados eliminados (p. ej., camisas o shorts).
• Categorías únicas de artículos: Las categorías de producto en el pedido con los duplicados eliminados (p. ej., hombre o oferta).
• Atributos (opcional): Atributos del producto en los detalles del artículo, en “extra”. Usa eventos de Productos pedidos para filtrar por atributos de productos individuales.

Proceso de Pago Completado

Se realiza un seguimiento de este evento cuando un cliente completa un proceso de pago en tu tienda de Magento. Los eventos Checkout Completed no se sincronizan de forma histórica, por lo que sus totales podrían no reflejar todos los procesos de pago anteriores. Usa eventos Placed Order para la elaboración de informes de ingresos y la segmentación.

Puedes filtrar y orientar los eventos de Checkout Completed en función de los siguientes criterios:

• Valor: El valor total del pedido.
• Códigos de descuento: Se aplican cupones o códigos de descuento.
• Items: Los nombres de los productos en el carrito de alguien (p. ej., t-shirt o pants).
• Items Count: La cantidad total de artículos en el carrito de alguien.
• Descuentos totales (opcional): Valor total en dólares de cualquier cupón o descuento.

Proceso de pago iniciado

Este evento se rastrea 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 luego hace clic en continuar. Klaviyo rastrea los datos de producto relacionados sobre los artículos en el carrito de alguien, incluidos los nombres de producto, las imágenes y la información de la variante, que puedes usar en tus correos electrónicos de carrito abandonado. Este evento tiene una propiedad de URL de pago que enlaza de vuelta al carrito exacto de cada cliente y que se puede usar para reconstruir el carrito si un cliente abre el correo electrónico desde un dispositivo nuevo.

Puedes filtrar y orientar los eventos de Inicio de pago en función de los siguientes criterios:

• Valor: El valor del carrito al momento del pago (subtotal + costo de envío - cualquier descuento).
• Items: Los nombres de los productos en el carrito de alguien (p. ej., t-shirt o pants).
• Items Count: La cantidad total de artículos en el carrito de alguien.
• Códigos de descuento (opcional): Cualquier cupón o código de descuento aplicado.
• Descuentos totales (opcional): Valor total en dólares de cualquier cupón o descuento.

Pedido completado

Con los estados estándar de pedidos de Magento, este evento se registra cuando un pedido llega al estado de completado. Klaviyo registra información del producto relacionada sobre los artículos que alguien compró, incluidos los nombres de los productos, las imágenes y la información de las variantes, que puedes usar en correos electrónicos de seguimiento posteriores a la compra.

Estos eventos incluyen los siguientes datos del pedido. Puedes usar propiedades de nivel superior para filtrar y segmentar eventos; los detalles de los atributos en extra están disponibles para el contenido del mensaje.

• Valor: El total general del pedido de Magento, incluidos impuestos y envío después de los descuentos.
• Artículos: Los nombres de los productos de cada elemento de línea del pedido (p. ej., playera o pantalones). Un nombre puede aparecer más de una vez si aparece en elementos de línea separados.
• Categorías de artículos: Las categorías de los productos en el pedido (por ejemplo: camisetas, ropa para hombre, pantalones y oferta).
• Número de artículos: El número de artículos de línea en el pedido (por ejemplo, 2). Esta no es la suma de las cantidades solicitadas.
• Código de moneda: El código de moneda del pedido (p. ej., USD o EUR).
• Con descuento: Si se aplicó un descuento al pedido (verdadero o falso).
• Coupon: El código de cupón aplicado.
• Artículos únicos: Los nombres de los productos en el pedido, con los duplicados eliminados (p. ej., camisas o shorts).
• Categorías únicas de artículos: Las categorías de producto en el pedido con los duplicados eliminados (p. ej., hombre o oferta).
• Atributos (opcional): Atributos del producto en los detalles del artículo, en “extra”. Usa eventos de Productos pedidos para filtrar por atributos de productos individuales.

Producto Pedido

Este evento se registra cuando un cliente realiza su pedido. Para cantidades de números enteros, se rastrea 1 evento Ordered Product por cada unidad comprada, hasta 100 eventos por artículo de la línea del pedido. Por ejemplo, si alguien compra una playera y un par de pantalones, se registran 1 evento Placed Order y 2 eventos Ordered Product: 1 para la playera y 1 para los pantalones. Para productos que se venden en cantidades decimales, Klaviyo registra 1 evento para el artículo de la línea e incluye la cantidad comprada.

El evento Producto pedido incluye información detallada sobre cada producto que alguien compra. Esto es útil al crear segmentos de comportamiento basados en opciones de variantes de productos y otra información detallada que no está disponible en el evento Pedido realizado. Puedes filtrar y orientar los eventos de Producto pedido en función de los siguientes criterios:

• Valor: El valor representado por este evento antes de los descuentos, sin incluir el envío. Para cantidades de números enteros, es el total de la línea del pedido dividido entre su cantidad. Para cantidades decimales, es el total completo de la línea.
• Nombre: El nombre asignado a este elemento específico.
• SKU: El SKU asignado al artículo (p. ej., REDMEDIUMTSHIRT).
• Categorías: Las categorías de este producto (p. ej., playeras, ropa para hombre, pantalones y oferta).
• Precio: El precio unitario del producto en la moneda del pedido (p. ej., camisas 25.50 o zapatos 50.25).
• Costo (opcional): El costo del producto registrado en Magento, cuando está disponible (p. ej., camisas 13.85 o zapatos 20.00).
• Código de moneda: El código de moneda del pedido (p. ej., USD o EUR).
• Con descuento: Si este artículo específico tiene un descuento aplicado (es decir, true o false).
• ProductID: ID del producto específico en tu tienda.
• Cantidad: La cantidad representada por este evento: 1 para cantidades en números enteros o la cantidad comprada para un producto vendido en cantidades decimales.
• Atributos (opcional): atributos de producto personalizados.

Pedido realizado

Este evento se rastrea cuando un cliente completa el proceso de pago y crea un pedido en la tienda de Magento. Klaviyo rastrea datos relacionados, incluida la información de producto sobre los artículos que alguien compró, como nombres de productos, imágenes e información de la variante, que puedes usar en correos electrónicos de seguimiento de compra. Estos eventos Pedido realizado incluyen los siguientes datos del pedido. Puedes usar propiedades de nivel superior para filtrar y segmentar eventos; los detalles de los atributos en extra están disponibles para el contenido del mensaje.

• Valor: El total general del pedido de Magento, incluidos impuestos y envío después de los descuentos.
• Artículos: Los nombres de los productos de cada elemento de línea del pedido (p. ej., playera o pantalones). Un nombre puede aparecer más de una vez si aparece en elementos de línea separados.
• Categorías de artículos: Las categorías de los productos en el pedido (por ejemplo: camisetas, ropa para hombre, pantalones y oferta).
• Número de artículos: El número de artículos de línea en el pedido (por ejemplo, 2). Esta no es la suma de las cantidades solicitadas.
• Código de moneda: El código de moneda del pedido (p. ej., USD o EUR).
• Con descuento: Si se aplicó un descuento al pedido (verdadero o falso).
• Coupon: El código de cupón aplicado.
• Artículos únicos: Los nombres de los productos en el pedido, con los duplicados eliminados (p. ej., camisas o shorts).
• Categorías únicas de artículos: Las categorías de producto en el pedido con los duplicados eliminados (p. ej., hombre o oferta).
• Atributos (opcional): Atributos del producto en los detalles del artículo, en “extra”. Usa los eventos Ordered Product para filtrar por atributos individuales del producto. Aprende cómo revisar atributos de producto personalizados.

Pedido Reembolsado

Con los estados de pedido estándar de Magento, este evento se registra cuando un pedido llega al estado cerrado. Su Value es el total general original del pedido, no el monto de un reembolso individual.

• Valor: El total general del pedido original de Magento, incluidos los impuestos y el envío después de los descuentos.
• Coupon: El código de cupón aplicado.
• Código de moneda: El código de moneda del pedido (p. ej., USD o EUR).
• Con descuento: Si se aplicó un descuento al pedido (verdadero o falso).
• Categorías de artículos: Las categorías de los productos en el pedido (por ejemplo: camisetas, ropa para hombre, pantalones y oferta).
• Número de artículos: El número de artículos de línea en el pedido (por ejemplo, 2). Esta no es la suma de las cantidades solicitadas.
• Artículos: Los nombres de los productos de cada elemento de línea del pedido (p. ej., playera o pantalones). Un nombre puede aparecer más de una vez si aparece en elementos de línea separados.
• Categorías únicas de artículos: Las categorías de producto en el pedido con los duplicados eliminados (p. ej., hombre o oferta).
• Artículos únicos: Los nombres de los productos en el pedido, con los duplicados eliminados (p. ej., camisas o shorts).

Los ingresos de Placed Order usan el total general del pedido de Magento, incluido el impuesto y el envío después de los descuentos. Para filtrar un segmento en función de $value, usa Revenue.

Pago está disponible como una propiedad de segundo nivel en el campo extra. No puedes filtrar por propiedades de segundo nivel para segmentación, pero puedes usar estos datos como una variable de evento en plantillas de correo electrónico de flujo activadas por métrica.

Sincronización de los datos de clientes

Klaviyo crea o actualiza perfiles a partir de pedidos sincronizados, registros de clientes y checkouts iniciados. La información disponible en un perfil depende de los datos proporcionados por Magento. Puede incluir:

• 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., 2015-05-01 00:00:00)
• Grupo de clientes de Magento (p. ej., mayorista)
• Tienda de Magento (p. ej., tienda de EE. UU.)
• Fecha de nacimiento (p. ej., 1990-01-01)
• Género
• ID del sitio web de Magento (cuando el registro del cliente incluye un ID de tienda)

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

Revisar atributos personalizados del producto

Los atributos de producto personalizados dependen de la configuración existente de la integración. Los atributos configurados aparecen en los eventos Ordered Product como propiedades llamadas Attribute: seguidas del código del atributo. Los detalles del atributo también se almacenan con los artículos individuales en extra en los eventos de pedido. El equipo de soporte de Klaviyo ya no gestiona solicitudes para habilitar o cambiar la sincronización de atributos de Magento 1. Revisa los datos de eventos existentes para ver qué atributos están presentes. Puedes encontrar información general de soporte en Cómo contactar con soporte.

Para identificar un atributo personalizado en tu configuración existente, ve a Catálogo > Atributos > Administrar atributos en el panel de administración de Magento y haz clic en el atributo.

Encuentra el ID del atributo en la URL, como se muestra a continuación.

Verificar los datos de pedidos sincronizados

Para verificar los pedidos sincronizados, compara el número de eventos Pedido realizado de un día completo con los pedidos en Magento del mismo día y de las mismas tiendas. Deja que termine la sincronización histórica y que se complete la sincronización más reciente de 30 minutos antes de comparar los conteos.

1. Ve a Analytics > Métricas y selecciona la métrica de Magento Placed Order.
2. Configura Rango de fechas para incluir el día que quieres comparar. Configura Ver por en Diario y Medición en Total. Elimina cualquier Filtro que excluya pedidos de la comparación.
3. Coloca el cursor sobre el punto de datos del día o revisa su valor en la tabla debajo del gráfico. Compara el recuento con los pedidos de Magento del mismo día y de las mismas tiendas.

Si los recuentos difieren, revisa que ambos reportes usen la misma zona horaria y el mismo alcance de la tienda, y que la sincronización haya finalizado. También revisa si los pedidos de Magento no emparejados están pendientes de pago o no tienen una dirección de correo electrónico válida del cliente. Para comprobar la zona horaria de Klaviyo:

1. Haz clic en el nombre de la cuenta en la esquina inferior izquierda.
2. Haz clic en Configuración.
3. Selecciona General > Cuenta y revisa la configuración de Zona horaria.
4. Si cambias la Zona horaria, haz clic en Guardar. Necesitas permiso para editar la configuración de la cuenta para cambiar este valor.

Los ingresos de pedidos realizados en Klaviyo no restan los pedidos cancelados o reembolsados. Por lo tanto, puede diferir de un informe de Magento que sí resta esos pedidos.

Propiedades para pedidos de Magento sincronizados

A continuación se muestran cargas útiles de JSON de ejemplo para las métricas de Pedido realizado, Producto pedido y Pedido completado que coinciden con las propiedades que almacenamos para los pedidos sincronizados a través de la interfaz de programación de aplicaciones (API) de Magento SOAP.

Usa estos ejemplos para entender los nombres de las propiedades y la anidación de los eventos sincronizados. Muestran el formato heredado de la carga útil de eventos y no son instrucciones para enviar solicitudes a la interfaz de programación de aplicaciones (API) actual de Klaviyo. Los valores de ejemplo son ilustrativos; extra contiene todos los detalles del pedido para eventos a nivel de pedido.

Pedido realizado

{
  "token": "PUBLIC_API_KEY",
  "service": "magento",
  "event": "Placed Order",
  "customer_properties": {
    "$email": "john.smith@test.com",
    "$first_name": "John",
    "$last_name": "Smith"
  },
  "properties": {
    "$event_id": "1234",
    "$value": 29.98,
    "$extra": {},
    "Currency Code": "USD",
    "Item Count": 2,
    "Items": [
      "Winnie the Pooh",
      "A Tale of Two Cities"
    ],
    "Discounted": true,
    "Coupon": "COUPON123",
    "Unique Items": [
      "Winnie the Pooh",
      "A Tale of Two Cities"
    ],
    "Item Categories": [
      "Fiction",
      "Classics",
      "Children"
    ],
    "Unique Item Categories": [
      "Fiction",
      "Classics",
      "Children"
    ]
  },
  "time": 1387302423
}

Producto Pedido

{
  "token": "PUBLIC_API_KEY",
  "service": "magento",
  "event": "Ordered Product",
  "customer_properties": {
    "$email": "john.smith@test.com",
    "$first_name": "John",
    "$last_name": "Smith"
  },
  "properties": {
    "$event_id": "123456789",
    "$value": 9.99,
    "Currency Code": "USD",
    "Name": "Winnie the Pooh",
    "SKU": "WINNIEPOOH",
    "ProductID": "567",
    "Categories": [
      "Fiction",
      "Classics"
    ],
    "Price": 9.99,
    "Discounted": true,
    "Cost": 5.0,
    "Attribute: Color": "Red",
    "$extra": {
      "Product URL Key": "winnie-pooh",
      "Product URL": "https://www.store.com/winnie-pooh",
      "Image URL": "https://cnd.store.com/images/winnie-pooh.png"
    },
    "Quantity": 1
  },
  "time": 1387302423
}

Pedido completado

{
  "token": "PUBLIC_API_KEY",
  "service": "magento",
  "event": "Fulfilled Order",
  "customer_properties": {
    "$email": "john.smith@test.com",
    "$first_name": "John",
    "$last_name": "Smith"
  },
  "properties": {
    "$event_id": "1234",
    "$value": 29.98,
    "$extra": {},
    "Currency Code": "USD",
    "Item Count": 2,
    "Items": [
      "Winnie the Pooh",
      "A Tale of Two Cities"
    ],
    "Discounted": true,
    "Coupon": "COUPON123",
    "Unique Items": [
      "Winnie the Pooh",
      "A Tale of Two Cities"
    ],
    "Item Categories": [
      "Fiction",
      "Classics",
      "Children"
    ],
    "Unique Item Categories": [
      "Fiction",
      "Classics",
      "Children"
    ]
  },
  "time": 1387302423
}

Recursos adicionales