Referencia de datos de Magento 1

Qué aprenderás

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

En Klaviyo, ve a Analítica > Métricas en la barra lateral izquierda para ver las métricas de tu cuenta. Las métricas con un icono de Magento se sincronizan desde tus integraciones de Magento.

Métricas de Magento

Pedido Cancelado

Este evento se registra cuando un cliente crea un pedido en tu tienda de Magento, pero luego cancela el pedido antes del cumplimiento. Klaviyo realiza un seguimiento de 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 variantes que puedes usar en emails de seguimiento de compra.

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

• Valor: El total general del pedido de Magento, que incluye los impuestos y el envío después de los descuentos.
• Items: Los nombres de producto de cada artículo de línea del pedido (p. ej., camiseta o pantalones). Un nombre puede aparecer más de una vez si aparece en artículos de línea separados.
• Categorías de artículos: Las categorías de los productos del pedido (por ejemplo, camisetas, hombre, pantalones y oferta).
• Número de artículos: el número de líneas de artículo en el pedido (por ejemplo, 2). No es la suma de las cantidades pedidas.
• 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).
• Cupón: El código de cupón aplicado.
• Artículos únicos: los nombres de los productos del pedido con los duplicados eliminados (p. ej., camisas o pantalones cortos).
• Categorías únicas de artículos: las categorías de productos del pedido con los duplicados eliminados (p. ej., mens o sale).
• Atributos (opcional): atributos del producto en los detalles del artículo, en extra. Usa eventos Ordered Product para filtrar por atributos individuales del producto.

Pago Completado

Este evento se registra cuando un cliente completa el proceso de pago en tu tienda de Magento. Los eventos Checkout Completed no se sincronizan de forma histórica, por lo que sus totales pueden no reflejar todos los procesos de pago anteriores. Usa los 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: cualquier cupón o códigos de descuento aplicados.
• Items: Los nombres de los productos del carrito de alguien (por ejemplo, camiseta o pantalones).
• Recuento de artículos: 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.

Pago Iniciado

Este evento se registra 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, luego, hace clic en continuar. Klaviyo registra datos de producto relacionados sobre los artículos del carrito de alguien, incluidos los nombres de productos, las imágenes y la información de variantes, que puedes usar en tus emails 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 email desde un nuevo dispositivo.

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

• Valor: El valor del carrito en el momento de finalizar la compra (subtotal + coste de envío - cualquier descuento).
• Items: Los nombres de los productos del carrito de alguien (por ejemplo, camiseta o pantalones).
• Recuento de artículos: la cantidad total de artículos en el carrito de alguien.
• Códigos de descuento (opcional): cualquier cupón o códigos de descuento aplicados.
• Descuentos totales (opcional): valor total en dólares de cualquier cupón o descuento.

Pedido Procesado

Con los estados de pedidos estándar de Magento, este evento se registra cuando un pedido alcanza el estado completado. Klaviyo registra información de productos relacionada sobre los artículos que alguien compró, incluidos los nombres de los productos, las imágenes y la información de la variante que puedes usar en emails de seguimiento de compra.

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

• Valor: El total general del pedido de Magento, que incluye los impuestos y el envío después de los descuentos.
• Items: Los nombres de producto de cada artículo de línea del pedido (p. ej., camiseta o pantalones). Un nombre puede aparecer más de una vez si aparece en artículos de línea separados.
• Categorías de artículos: Las categorías de los productos del pedido (por ejemplo, camisetas, hombre, pantalones y oferta).
• Número de artículos: el número de líneas de artículo en el pedido (por ejemplo, 2). No es la suma de las cantidades pedidas.
• 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).
• Cupón: El código de cupón aplicado.
• Artículos únicos: los nombres de los productos del pedido con los duplicados eliminados (p. ej., camisas o pantalones cortos).
• Categorías únicas de artículos: las categorías de productos del pedido con los duplicados eliminados (p. ej., mens o sale).
• Atributos (opcional): atributos del producto en los detalles del artículo, en extra. Usa eventos Ordered Product para filtrar por atributos individuales del producto.

Producto Pedido

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

El evento Producto pedido incluye información detallada sobre cada producto que compre alguien. Esto resulta útil a la hora de crear segmentos de comportamiento basados en opciones de variante del producto y otra información detallada que no está disponible en el evento de Pedido Realizado. Puedes filtrar y orientar los eventos de Producto Pedido en función de los siguientes criterios:

• Valor: el valor que representa este evento antes de los descuentos, sin incluir el envío. Para las cantidades en números enteros, este es el total de la línea del pedido dividido entre su cantidad. Para las 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 (por ejemplo, camisetas, hombre, pantalones y oferta).
• Precio: El precio unitario del producto en la moneda del pedido (p. ej., camisas 25.50 o zapatos 50.25).
• Coste (opcional): el coste 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, verdadero o falso).
• ProductID: ID de un producto específico en tu tienda.
• Cantidad: la cantidad representada por este evento: 1 para cantidades de números enteros o la cantidad comprada en el caso de un producto vendido en cantidades decimales.
• Atributos (opcional): atributos de producto personalizados.

Pedido Realizado

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

• Valor: El total general del pedido de Magento, que incluye los impuestos y el envío después de los descuentos.
• Items: Los nombres de producto de cada artículo de línea del pedido (p. ej., camiseta o pantalones). Un nombre puede aparecer más de una vez si aparece en artículos de línea separados.
• Categorías de artículos: Las categorías de los productos del pedido (por ejemplo, camisetas, hombre, pantalones y oferta).
• Número de artículos: el número de líneas de artículo en el pedido (por ejemplo, 2). No es la suma de las cantidades pedidas.
• 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).
• Cupón: El código de cupón aplicado.
• Artículos únicos: los nombres de los productos del pedido con los duplicados eliminados (p. ej., camisas o pantalones cortos).
• Categorías únicas de artículos: las categorías de productos del pedido con los duplicados eliminados (p. ej., mens o sale).
• Atributos (opcional): atributos del producto en los detalles del artículo, en extra. Usa los eventos de Producto pedido para filtrar por atributos de productos individuales. Descubre cómo revisar atributos de productos personalizados.

Pedido Reembolsado

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

• Valor: el total general original del pedido de Magento, incluidos los impuestos y el envío tras los descuentos.
• Cupón: 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 del pedido (por ejemplo, camisetas, hombre, pantalones y oferta).
• Número de artículos: el número de líneas de artículo en el pedido (por ejemplo, 2). No es la suma de las cantidades pedidas.
• Items: Los nombres de producto de cada artículo de línea del pedido (p. ej., camiseta o pantalones). Un nombre puede aparecer más de una vez si aparece en artículos de línea separados.
• Categorías únicas de artículos: las categorías de productos del pedido con los duplicados eliminados (p. ej., mens o sale).
• Artículos únicos: los nombres de los productos del pedido con los duplicados eliminados (p. ej., camisas o pantalones cortos).

Los ingresos de Placed Order usan el total general del pedido de Magento, incluidos los impuestos 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 la segmentación, pero puedes usar estos datos como una variable de evento en plantillas de email de flujo activadas por una métrica.

Datos del cliente sincronizados

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

• Email
• Nombre y apellidos
• Ciudad, estado/región, código postal, país
• Phone Number
• Cuenta de Magento creada (por ejemplo, 2015-05-01 00:00:00)
• Grupo de clientes de Magento (p. ej., mayoristas)
• 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 el perfil original se haya creado en Klaviyo, el grupo de clientes se actualizará en Klaviyo.

Revisa los atributos personalizados de producto

Los atributos de producto personalizados dependen de la configuración de la integración existente. Los atributos configurados aparecen en los eventos de producto pedido como propiedades denominadas Attribute: seguidas del código de atributo. Los detalles del atributo también se almacenan con los elementos 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 ponerte en contacto con el equipo de soporte.

Para identificar un atributo personalizado en la configuración existente, ve a Catálogo > Atributos > Gestionar 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.

Verifica tus datos de pedidos sincronizados

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

1. Ve a Analíticas > Métricas y selecciona la métrica Pedido realizado de Magento.
2. Configura Intervalo de fechas para incluir el día que quieres comparar. Configura Ver por en Diario y Medición en Total. Elimina cualquier Filtro que pudiera excluir pedidos de la comparación.
3. Pasa el cursor sobre el punto de datos del día o lee su valor en la tabla debajo del gráfico. Compara el recuento con los pedidos de Magento del mismo día y tiendas.

Si los recuentos no coinciden, comprueba que ambos informes usen la misma zona horaria y el mismo alcance de la tienda, y que la sincronización se haya completado. Comprueba también si los pedidos de Magento sin coincidencia están pendientes de pago o no tienen una dirección de email válida del cliente. Para comprobar la zona horaria de Klaviyo:

1. Haz clic en el nombre de tu 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 Pedido realizado 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 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 mediante la 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 de carga útil de eventos heredado y no son instrucciones para enviar solicitudes a las API actuales de Klaviyo. Los valores de ejemplo son ilustrativos; extra contiene todos los detalles del pedido para los 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 Procesado

{
  "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