Referencia de datos de Magento 1

Qué aprenderás

Descubre qué datos de Magento 1 se importan a Klaviyo cuando integras ambas plataformas. Las integraciones de Klaviyo con Magento incorporan todo el histórico de datos de tu tienda de Magento en el momento de tu sincronización histórica inicial. Una vez activadas, las integraciones comenzarán a sincronizar la métrica y los datos de cliente casi en tiempo real. 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 Análisis 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 son las que se han sincronizado desde tu integración 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.

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

• Valor: Valor total del pedido (subtotal + coste de envío - cualquier descuento).
• Artículos: Los nombres de los productos del pedido de alguien.
  ej.: camiseta o pantalones. Si se pide varias veces, se mostrarán varios del mismo artículo.
• Categorías de artículos: El conjunto completo de categorías de los artículos del pedido de una persona (por ejemplo, camisetas, hombre, pantalones y oferta).
• Recuento de artículos: el número de artículos del pedido (por ejemplo, 2).
• Código de divisa: el tipo de divisa específica pagada por un artículo según el país (por ejemplo, USD, EUR).
• Con descuento: si a este artículo específico se le aplica un descuento (es decir, verdadero/falso).
• Cupón: El código de cupón aplicado.
• Artículos únicos: El artículo individual incluido en un pedido (p. ej., camisetas, pantalones cortos). Si se piden varios productos, el artículo único solo se mostrará una vez.
• Categorías de artículos únicas: las categorías en las que se agrupan los artículos únicos (p. ej., hombre, ofertas).
• Atributos (opcional): atributos de producto personalizados.

Pago Completado

Este evento se registra cuando un cliente completa el proceso de pago en tu tienda de Magento. El evento Checkout Completed no se sincroniza históricamente, por lo que no siempre es una medida precisa al analizar el total de eventos a lo largo del tiempo. Para el seguimiento de ingresos y la segmentación, utiliza 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: 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

Este evento se registra cuando marcas un pedido en tu tienda de Magento como enviado. Klaviyo realiza un seguimiento de la información de producto relacionada con los artículos que alguien compró, incluidos los nombres de producto, las imágenes y la información de variante, que se puede usar en emails 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 + coste de envío - cualquier descuento).
• Items: Los nombres de los productos del pedido de alguien (por ejemplo, camiseta o pantalones). Si se ha pedido varias veces, aparecerán múltiplos del mismo artículo.
• Categorías de artículos: El conjunto completo de categorías de los artículos del pedido de alguien (por ejemplo, camisetas, hombre, pantalones y oferta).
• Número de artículos: La cantidad de artículos en el pedido. (por ejemplo, 2).
• Código de moneda: la moneda específica pagada por un artículo en función del país (p. ej., USD, EUR).
• Con descuento: si a este artículo específico se le aplica un descuento (es decir, verdadero/falso).
• Cupón: El código de cupón aplicado.
• Artículos únicos: El artículo individual creado en un pedido (p. ej., camisetas, pantalones cortos). Si se piden varios productos, el artículo único solo se mostrará una vez.
• Categorías de artículos únicas: las categorías en las que se agrupan los artículos únicos (p. ej., hombre, ofertas).
• Atributos (opcional): atributos de producto personalizados.

Producto Pedido

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

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: precio total del artículo (no incluye los gastos de envío ni los descuentos aplicados).
• Nombre: el nombre asignado a este elemento específico.
• SKU: el SKU específico asignado para hacer un seguimiento de un artículo (p. ej., REDMEDIUMTSHIRT).
• Categorías: El conjunto completo de las colecciones de los productos en el pedido de alguien (por ejemplo, camisetas, hombre, pantalones y oferta).
• Precio: el valor en dólares del producto específico (p. ej., camisas 25,50, zapatos 50,25).
• Coste: el coste de fabricar un producto (p. ej., camisetas 13,85, zapatos 20,00).
• Código de divisa: La divisa 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 o falso).
• ProductID: ID de un producto específico en tu tienda.
• Cantidad: cantidad pedida.
• 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 rastrea datos relacionados, incluida la información de producto sobre los artículos que alguien compró, incluidos los nombres de los productos, las imágenes y la información de variante, que puedes usar en los emails de seguimiento de compra. Puedes filtrar y orientar los eventos de Pedido realizado en función de los siguientes criterios:

• Valor: Valor total del pedido (subtotal + envío - cualquier descuento).
• Artículos: Los nombres de los productos del pedido de alguien (por ejemplo, camiseta o pantalones). Si se pide varias veces, se mostrarán varios del mismo artículo.
• Categorías de artículos: el conjunto completo de categorías de los artículos del pedido de alguien (por ejemplo, camisetas, hombre, pantalones y oferta).
• Recuento de artículos: el número de artículos del pedido (por ejemplo, 2).
• Código de divisa: la divisa específica pagada por un artículo según el país (p. ej., USD, EUR).
• Con descuento: si a este artículo específico se le aplica un descuento (es decir, verdadero/falso).
• Cupón: El código de cupón aplicado.
• Artículos únicos: El artículo individual creado en un pedido (p. ej., camisetas, pantalones cortos). Si se piden varios productos, el artículo único solo se mostrará una vez.
• Categorías de artículos únicos: Las categorías en las que se agrupan los artículos únicos (p. ej., hombre, ofertas).
• 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 de abajo sobre cómo configurar esto.

Pedido Reembolsado

Este evento se registra cuando se reembolsa un pedido en Magento.

• Valor: Valor total del pedido (subtotal + envío - cualquier descuento).
• Cupón: El código de cupón aplicado.
• Código de divisa: la divisa específica pagada por un artículo según el país (p. ej., USD, EUR).
• Con descuento: Si se aplicó un descuento a este artículo específico (es decir, verdadero/falso).
• Categorías de artículos: el conjunto completo de categorías de los artículos del pedido de alguien (por ejemplo, camisetas, hombre, pantalones y oferta).
• Item Count: El número de artículos del pedido (por ejemplo, 2).
• Items: Los nombres de los productos del pedido de alguien (por ejemplo, camiseta o pantalones). Si se pide varias veces, se mostrarán varios del mismo artículo.
• Categorías únicas de artículos: las categorías en las que se agrupan los artículos únicos (p. ej., hombre, rebajas).
• Artículos únicos: el artículo individual creado en un pedido, p. ej.: camisetas, pantalones cortos. Si se piden varios productos, el elemento único solo se mostrará una vez.

Los ingresos, o el valor de Pedido realizado, se calculan de la siguiente manera: (precio de los pedidos + envío - descuentos). Para filtrar un segmento en función de $value, filtra el segmento mediante Ingresos.

Pago está disponible como propiedad de segundo nivel en el campo extra. No puedes filtrar propiedades de segundo nivel para la segmentación, pero puedes usar estos datos como una variable de evento en tus plantillas de email.

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 (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
• No se extraerá website_ID
• Las supresiones no se copian en 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 el perfil original se haya creado en Klaviyo, el grupo de clientes se actualizará en Klaviyo.

Sincroniza atributos de producto personalizados para los pedidos realizados

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

Encuentra los ID de producto personalizados en el panel de Administrador de Magento yendo a Catalog > Attributes > Manage Attributes y haciendo clic en el atributo.

Puedes encontrar el ID en la url de esta forma:

Verifica tus datos de pedidos sincronizados

Klaviyo importa todos tus datos de Magento. Para verificarlo, puedes comparar el número de pedidos en un día concreto 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 datos de los últimos 30 días de forma predeterminada. A continuación, puedes ver un ejemplo del gráfico de métricas que se muestra.

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

1. Haz clic en el nombre de la empresa en la parte inferior izquierda.
2. Haz clic en Configuración.
3. Selecciona Empresa.

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.

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.

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 Procesado

// 
// 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