Referencia de datos de Magento 1

Objetivos del artículo

Descubre qué datos de Magento 1 se importan a Klaviyo cuando integras ambas plataformas. La integración de Klaviyo con Magento importa todos los datos históricos de tu tienda de Magento en el momento de la sincronización histórica inicial. Una vez habilitada, la integración comenzará a sincronizar métricas y datos de clientes casi en tiempo real. Algunos ejemplos de estos datos incluyen la información asociada con pedidos realizados anteriormente, pedidos completados, etc.

En Klaviyo, puedes ir a la pestaña Análisis de la barra lateral izquierda para ver todas las métricas de tu cuenta; las métricas con un ícono de Magento son las que se sincronizan desde tu integración 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.

Puedes filtrar y dirigir los eventos de Pedido cancelado en función de los siguientes criterios:

• Valor: Valor total del pedido (subtotal + costo de envío - cualquier descuento).
• Items: Los nombres de los productos en el pedido de alguien.
  Ej.: camiseta o pantalones. Si se pidió varias veces, se mostrarán múltiples unidades del mismo artículo.
• Categorías de artículos: El conjunto completo de categorías de los artículos en el pedido de alguien (p. ej., t-shirts, mens, pants y oferta).
• Cantidad de artículos: La cantidad de artículos del pedido (por ejemplo, 2).
• Código de moneda: La moneda específica pagada por un artículo según el país (p. ej., USD, EUR).
• Con descuento: Si este artículo específico tiene un descuento aplicado (es decir, verdadero/falso).
• Coupon: El código de cupón aplicado.
• Artículos únicos: El artículo individual incluido en un pedido (p. ej., camisas, shorts). Si se piden varios productos, el artículo único solo se mostrará una vez.
• Categorías únicas de artículos: las categorías en las que se agrupan los artículos únicos (p. ej., hombres, ofertas).
• Atributos (opcional): atributos de producto personalizados.

Proceso de Pago Completado

Se realiza un seguimiento de este evento cuando un cliente completa un checkout en la tienda de Magento. El evento Checkout Completed no se sincroniza históricamente, por lo que no siempre es una medida precisa al ver el total de eventos con el tiempo. Para el seguimiento de ingresos y la segmentación, usa el evento Placed Order.

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

Este evento se rastrea cuando marcas un pedido en tu tienda de Magento como enviado. Klaviyo registra información de productos relacionados sobre los artículos que alguien compró, incluidos los nombres de los productos, las imágenes y la información de variantes, que se puede usar en correos electrónicos de seguimiento de compra.

Puedes filtrar y orientar los eventos de Pedido completado en función de los siguientes criterios:

• Valor: Valor total del pedido (subtotal + costo de envío - cualquier descuento).
• Artículos: Los nombres de los productos en el pedido de alguien (por ejemplo, playera o pantalones). Si se pidió varias veces, aparecerán varios ejemplares del mismo artículo.
• Categorías del artículo: El conjunto completo de categorías de los artículos en el pedido de alguien (p. ej., camisetas, ropa para hombre, pantalones y oferta).
• Item Count: El número de artículos en el pedido. (por ejemplo, 2).
• Código de moneda: la moneda específica pagada por un artículo según el país (p. ej., USD, EUR).
• Con descuento: Si este artículo específico tiene un descuento aplicado (es decir, verdadero/falso).
• Coupon: El código de cupón aplicado.
• Artículos únicos: el artículo individual creado en un pedido (p. ej., camisas, shorts). Si se piden varios productos, el artículo único solo se mostrará una vez.
• Categorías únicas de artículos: las categorías en las que se agrupan los artículos únicos (p. ej., hombres, ofertas).
• Atributos (opcional): atributos de producto personalizados.

Producto Pedido

Este evento se rastrea cuando un cliente realiza su pedido. Se realiza el seguimiento de un evento de Producto pedido por cada artículo que compra alguien. Por ejemplo, si alguien compra una camiseta y un par de pantalones, se rastrea un evento de Pedido Realizado y se registran dos eventos de Producto Pedido: uno para la camiseta y uno para los pantalones.

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:

• Value: Precio total del artículo (no incluye costos de envío ni descuentos aplicados).
• Nombre: El nombre asignado a este elemento específico.
• SKU: El SKU específico asignado para rastrear un artículo (p. ej., REDMEDIUMTSHIRT).
• Categorías: El conjunto completo de las colecciones de los productos en el pedido de alguien (p. ej., camisetas, ropa para hombre, pantalones y oferta).
• Precio: El valor en dólares del producto específico (p. ej., camisas 25.50, zapatos 50.25).
• Costo: el costo de fabricar un producto (por ejemplo, camisas 13.85, zapatos 20.00).
• Currency Code: La moneda específica pagada por un artículo según el país (por ejemplo, USD, 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.
• Quantity: Cantidad solicitada.
• Atributos (opcional): atributos de producto personalizados.

Pedido realizado

Este evento se registra cuando un cliente completa el proceso de página de pago y crea un pedido en tu tienda de Magento. Klaviyo hace un seguimiento de los datos relacionados, incluida la información del 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. Puedes filtrar y dirigir eventos de Pedido realizado en función de los siguientes criterios:

• Value: Valor total del pedido (subtotal + envío - cualquier descuento).
• Artículos: Los nombres de los productos en el pedido de alguien, por ejemplo: camiseta o pantalones. Si se ordena varias veces, se mostrará el mismo artículo varias veces.
• Categorías de artículos: El conjunto completo de categorías de los artículos en el pedido de alguien (p. ej., camisetas, hombre, pantalones y oferta).
• Cantidad de artículos: La cantidad de artículos del pedido (p. ej., 2).
• Código de moneda: La moneda específica que se paga por un artículo según el país (p. ej., USD, EUR).
• Con descuento: Si este artículo específico tiene un descuento aplicado (es decir, verdadero/falso).
• Coupon: El código de cupón aplicado.
• Artículos únicos: El artículo individual que se crea en un pedido (p. ej., camisas, shorts). Si se piden varios productos, el artículo único solo se mostrará una vez.
• Categorías únicas de artículos: Las categorías en las que se agrupan los artículos únicos (p. ej., mens, sale).
• Atributos (opcional): Se pueden sincronizar hasta 10 atributos de producto personalizados para los pedidos realizados. Esta sincronización debe habilitarse antes de que los datos de atributos personalizados fluyan a tu cuenta de Klaviyo. Consulta la sección a continuación sobre cómo configurar esto.

Pedido Reembolsado

Se realiza un seguimiento de este evento cuando se reembolsa un pedido en Magento.

• Value: Valor total del pedido (subtotal + envío - cualquier descuento).
• Coupon: El código de cupón aplicado.
• Código de moneda: La moneda específica que se paga por un artículo según el país (p. ej., USD, EUR).
• Con descuento: Si a este artículo específico se le aplicó un descuento (es decir, true/false).
• Categorías de artículos: El conjunto completo de categorías de los artículos en el pedido de alguien (p. ej., camisetas, hombre, pantalones y oferta).
• Recuento de artículos: La cantidad de artículos del pedido (p. ej., 2).
• Artículos: Los nombres de los productos en el pedido de alguien (por ejemplo, playera o pantalones). Si se ordena varias veces, se mostrará el mismo artículo varias veces.
• Categorías de artículos únicas: Las categorías en las que se agrupan los artículos únicos (p. ej., hombres, ofertas).
• Artículos únicos: El artículo individual creado en un pedido, p. ej.: camisas, shorts. Si se piden varios productos, el artículo único solo se mostrará una vez.

Los ingresos, o el valor del evento Pedido realizado, se calculan de la siguiente forma: (precio de los pedidos + envío - descuentos). Para filtrar un segmento según $value, filtra el segmento usando Ingresos.

Payment 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 las plantillas de correo electrónico.

Sincronización de los datos de clientes

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

• 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
• No se extraerá website_ID
• Las supresiones no se copian a Klaviyo, por lo que no estarán en la plataforma de Klaviyo

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.

Sincroniza atributos de producto personalizados para pedidos realizados

Klaviyo puede sincronizar hasta 10 atributos de producto personalizados para la métrica Placed Order. Los atributos de producto personalizados no se enviarán automáticamente a Klaviyo; sin embargo, se puede solicitar a Klaviyo que los importe. Para hacerlo, debes recopilar el ID del atributo personalizado (instrucciones abajo) y enviar una solicitud a nuestro equipo de soporte.

Busca los ID de producto personalizados en el panel de Administrador de Magento y ve a Catálogo > Atributos > Administrar atributos, y luego haz clic en el atributo.

El ID se puede encontrar en la URL de esta manera:

Verificar los datos de pedidos sincronizados

Klaviyo importa todos tus datos de Magento. Para verificarlo, puedes comparar la cantidad de pedidos de un día en particular con lo que aparece en la interfaz de Magento y confirmar que coinciden. Haz clic en Analytics en la barra lateral izquierda, busca la métrica Placed Order y haz clic en ella. Esto te llevará a la página del gráfico de métricas y mostrará los últimos 30 días de datos de forma predeterminada. Puedes ver a continuación un ejemplo del gráfico de métricas.

Pasa el cursor sobre el punto de datos de ayer o revisa la tabla de datos debajo de la gráfica para ver cuántos pedidos tuviste ayer. Compara ese número con lo que está almacenado en Magento y deberías ver que coinciden exactamente. Si no es así, lo más probable es que la zona horaria de la cuenta de Klaviyo no coincida con la zona horaria de Magento. Para verificar la configuración de la zona horaria:

1. Haz clic en el nombre de tu organización en la parte inferior izquierda.
2. Haz clic en Configuración.
3. Selecciona Organización.

Es posible que veas que el valor de Revenue en el 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.

Propiedades de 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.

Esto es útil para enviar las propiedades correctas de los pedidos que se combinarán con los datos de pedidos de Magento.

Pedido realizado

// 
// PLACED ORDER
// ------------------------------------------

{
  "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"], // If an item is ordered more than once, duplicate it. For example, someone orders two t-shirts this would be: ["T-Shirt", "T-Shirt"]
    "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

// 
// ORDERED PRODUCT
// ------------------------------------------

{
  "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", // LineId (unique)
    "$value" : 9.99,
    "Currency Code" : "USD",
    "Name" : "Winnie the Pooh",
    "SKU" : "WINNIEPOOH",
    "ProductID" : "567",
    "Categories" : ["Fiction", "Classics"],
    "Price" : 9.99,
    "Discounted" : true,
    "Cost" : 5.00, // (optional),
    "Attribute: Color" : "Red" // product attributes (optional)
    "$extra" : {
        "Product URL Key" : "winnie-pooh",
        "Product URL" : "https://www.store.com/winnie-pooh",
        "Image URL" : "https://cnd.store.com/images/winnie-pooh.png",
    }
  },
  "time" : 1387302423
}

Pedido completado

// 
// FULFILLED ORDER
// ------------------------------------------

{
  "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"], // If an item is ordered more than once, duplicate it. For example, someone orders two t-shirts this would be: ["T-Shirt", "T-Shirt"]
    "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