Cómo realizar la integración con Spree

Objetivos del artículo

Aprende a integrar Spree con Klaviyo. Después de completar estos pasos, podrás personalizar y dirigir correos electrónicos en función de las compras y la actividad en el sitio web de cada cliente. Estos son los datos que sincronizamos desde Spree:

• Datos de ventas y pedidos, incluido qué productos se compraron, imágenes de productos, detalles de la variante y cualquier descuento aplicado
• Información del cliente, incluyendo nombre, apellido y ubicación
• Datos de pedidos completados

Agrega la integración de Spree en Klaviyo

1. En Klaviyo, selecciona la pestaña Integraciones.
2. Haz clic en Explorar aplicaciones, busca Spree y haz clic en la tarjeta. Entonces haz clic en Instalar.
3. En la página siguiente, deberás proporcionar el URL de la tienda y una clave de API de Spree/contraseña cifrada. Puedes generar esta clave de API en el administrador de Spree yendo a Usuarios, eligiendo una cuenta y luego seleccionando Generar clave de API.
4. De vuelta en Klaviyo, pega la URL de la tienda y la clave de API/contraseña cifrada en los cuadros.
   

5. Si usas una interfaz de programación de aplicaciones (API) de Spree con versiones (V1), selecciona Estoy usando una interfaz de programación de aplicaciones (API) de Spree con versiones (V1).
6. Haz clic en Conectar con Spree.

La siguiente configuración de lista agrega a los clientes sincronizados desde pedidos y pagos en Spree sin verificar su estado de aceptación para recibir correos electrónicos en Spree. Pertenecer a una lista no establece el consentimiento para recibir correos electrónicos.

1. Opcional: Para agregar clientes sincronizados de Spree a una lista de Klaviyo, marca Agregar nuevos clientes de Spree a una lista de Klaviyo en la siguiente página y, luego, selecciona la lista.
2. Cuando estés listo, haz clic en Finalizar configuración. Después deberías ver un mensaje de éxito que indica que la integración se realizó correctamente.

Instalar el seguimiento en el sitio de Klaviyo

Para instalar el seguimiento en el sitio para Con actividad en el sitio y Producto visto, primero encuentra tu clave de API pública. Inicia sesión en tu cuenta de Klaviyo y ve a Nombre de la cuenta > Configuración > Claves de API. Tu clave pública tiene 6 caracteres. Copia esta clave de forma segura para usarla en el siguiente paso.

Hay 2 tipos de seguimiento en el sitio que puedes aprovechar:

• Con actividad en el sitio
  Esta métrica se registra cada vez que un navegador identificable visita tu sitio web
• Producto visto
  Esta métrica se registra cada vez que un navegador identificable ve una página de producto en tu sitio web

Seguimiento de "con actividad en el sitio"

Esta métrica se registra cada vez que un navegador identificable visita tu sitio web.

1. Para empezar a hacer seguimiento a la actividad Activo en el sitio, añade el siguiente fragmento de código a la plantilla principal de tu tienda para que se incluya en todas las páginas. Debes colocar este fragmento ya sea junto con otros scripts de analítica que uses o justo antes de la etiqueta de cierre </body>.
2. Asegúrate de reemplazar PUBLIC_API_KEY por la clave de API pública de la cuenta de Klaviyo:

<script type="text/javascript" async="" src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=PUBLIC_API_KEY"></script>
<script type="text/javascript"> 
//Initialize the Klaviyo object on page load
!function(){if(!window.klaviyo){window._klOnsite=window._klOnsite||[];try{window.klaviyo=new Proxy({},{get:function(n,i){return"push"===i?function(){var n;(n=window._klOnsite).push.apply(n,arguments)}:function(){for(var n=arguments.length,o=new Array(n),w=0;w<n;w++)o[w]=arguments[w];var t="function"==typeof o[o.length-1]?o.pop():void 0,e=new Promise((function(n){window._klOnsite.push([i].concat(o,[function(i){t&&t(i),n(i)}]))}));return e}}})}catch(n){window.klaviyo=window.klaviyo||[],window.klaviyo.push=function(){var n;(n=window._klOnsite).push.apply(n,arguments)}}}}(); </script>

1. Opcional: Para identificar a los clientes cuando inician sesión en tu tienda, agrega una llamada a klaviyo.identify() con la dirección de correo electrónico del cliente que inició sesión y, si está disponible, nombre y apellido. Usa el lenguaje de plantilla de tu tienda para incluir esta llamada solo cuando el visitante haya iniciado sesión. Consulta la guía de seguimiento en el sitio para obtener más información sobre el seguimiento personalizado para usuarios que han iniciado sesión.
2. Guarda y publica la plantilla de la tienda. Este código de seguimiento registra eventos de con actividad en el sitio para navegadores conocidos, para que puedas usar datos sobre visitas al sitio y el comportamiento de los visitantes en Klaviyo.
3. Para comprobar que el seguimiento en el sitio esté configurado correctamente, ve a una página de la tienda y agrega ?utm_email=email@example.com al final de la URL, reemplazando email@example.com por tu dirección de correo electrónico. Si la URL ya contiene un signo de interrogación, usa &utm_email=email@example.com en su lugar. Vuelve a cargar la página y luego busca tu dirección de correo electrónico en Klaviyo. Abre el perfil y revisa si hay un evento con actividad en el sitio.

seguimiento de "Producto visto"

Si quieres configurar un flujo de abandono de la navegación o crear segmentos basados en datos de navegación de productos, te conviene agregar el seguimiento de eventos de JavaScript para una métrica de Producto visto.

1. En la plantilla de la página de producto, agrega el siguiente ejemplo después del fragmento principal de seguimiento en el sitio. Adapta los marcadores de posición a tu tienda antes de publicar:

<script type="text/javascript">
 var klaviyo = window.klaviyo || [];
 klaviyo.track("Viewed Product", {
    Title: '{{ product.name }}',
    ItemId: {{ product.id }},
    Categories: {{ category in product.categories|json }}, // The list of categories is an array of strings.
    ImageUrl: '{{ product.image_url }}',
    Url: '{{ product.permalink }}',
    Metadata: {
    Brand: '{{ product.brand }}',
    Price: {{ product.price }},
    OnSale: {{ product.on_sale }},
    RegularPrice: {{ product.regular_price }},
    SalePrice: {{ product.sale_price }}
 }
 });
</script>

1. Reemplaza los marcadores de posición {{ }} con valores renderizados de forma dinámica para el producto que se está viendo, usando el lenguaje de plantilla de la tienda. Codifica en JSON cadenas y arreglos dinámicos para que las comillas en los nombres de los productos no rompan el JavaScript. Quita las comillas que rodean el ejemplo al insertar valores codificados en JSON. Renderiza Categories como un arreglo de cadenas y renderiza los precios y el estado de oferta como valores válidos de JavaScript.
2. Guarda y publica la plantilla de la página de producto. Para probarlo, identifica tu navegador con la prueba de dirección de correo electrónico anterior y luego visita una página de producto y revisa tu perfil de Klaviyo para ver un evento de Producto visto. Una vez configurados, estos datos se completarán conforme los visitantes conocidos naveguen por las páginas de producto.

Al agregar detalles del producto a un correo electrónico de abandono de la navegación, usa los nombres de propiedad de tu propio evento Viewed Product. En el ejemplo anterior, el título del producto es Title, la imagen es ImageUrl y el precio es Metadata.Price.

Cómo funciona el seguimiento en el sitio

Klaviyo usa un navegador identificado para asociar la actividad en el sitio con un perfil. Una visita anterior por sí sola no identifica un navegador. Hay 2 formas comunes en que Klaviyo puede identificar a un visitante del sitio:

• Si en algún momento alguien hizo clic en un Klaviyo Email que lleva a tu sitio web
• Si en algún momento alguien se suscribió o se registró mediante un formulario de Klaviyo

Cuando el rellenado de actividad de visitantes anónimos está habilitado, Klaviyo puede almacenar eventos en el sitio en el navegador del visitante antes de la identificación y agregarlos a su perfil una vez que se identifiquen. Esto requiere que el almacenamiento local del navegador esté disponible. Obtén más información sobre el rellenado de actividad de visitantes anónimos.

Monitorea la sincronización de Klaviyo

Para comprobar la integración:

1. Abre integraciones, selecciona Spree y luego selecciona Datos. En datos históricos, revisa el progreso de sincronización. Cuando finalice la importación, la tarjeta confirma que los datos históricos se sincronizaron.
2. Haz clic en el menú desplegable Analytics en Klaviyo y selecciona métrica. Aquí puedes filtrar para ver todas las métricas de Spree.
3. Abre la métrica Placed Order de Spree y luego selecciona la pestaña Feed de actividad. Si la integración comenzó a sincronizar datos, verás eventos de Pedido realizado aquí.
4. Klaviyo importa automáticamente los datos históricos de pedidos. Cuando se complete esa importación, selecciona la pestaña Gráfico de Pedido realizado. Elige un rango de fechas que incluya el día que quieres revisar, configura Ver por en Diario y configura Medición en Total. Por ejemplo, coloca el cursor sobre el punto de datos de ayer o usa la tabla debajo del gráfico para ver cuántos pedidos se registraron ayer.
5. Compara ese número con los pedidos completados en Spree del mismo día. Los pedidos necesitan una dirección de correo electrónico válida del cliente y al menos 1 artículo para sincronizarse. Si los conteos son distintos, confirma que la importación histórica haya finalizado, considera la sincronización por hora y verifica que las zonas horarias de Klaviyo y Spree coincidan.
6. Para verificar la configuración de zona horaria en Klaviyo:
   • Haz clic en el nombre de tu cuenta en la parte inferior izquierda.
   • Selecciona Configuración > Cuenta.
   • Desplázate hacia abajo hasta Zona horaria.

Datos sincronizados desde Spree

A continuación se muestra una lista de métricas que Spree sincroniza en Klaviyo. Puedes ver todas las métricas de Spree que se sincronizan en la cuenta en Análisis > Métricas.

Pedido realizado

Esta métrica registra un evento cuando se completa un pedido en Spree, es decir, cuando un cliente ha completado el proceso de pago. No confirma que el pago se haya realizado correctamente. Con esta métrica, puedes crear fácilmente segmentos de personas en función de la cantidad de pedidos que han realizado o de su valor de vida. También puedes crear emails para volver a interactuar con clientes anteriores o enviar emails de agradecimiento a clientes que compran por primera vez. Puedes filtrar y dirigir los eventos de Placed Order en función de los siguientes criterios:

• IsDiscounted
  Si se aplicó un descuento a un pedido; por ejemplo, true o false.
• ItemNames
  Los nombres de los productos comprados en este evento.

Producto Pedido

Esta métrica es similar a la métrica Pedido realizado; sin embargo, se registra un evento por cada unidad de un artículo que alguien pide. Por ejemplo, si alguien compró una playera y un par de shorts, esto aparecería en Klaviyo como 1 evento de Pedido realizado y 2 eventos de Producto pedido: uno para la playera y otro para el par de shorts. Esta métrica es útil para crear segmentos que se enfoquen en clientes que compraron (o no compraron) artículos específicos o artículos de categorías específicas. También puedes usar la métrica Producto pedido como disparador de flujos para enviar correos electrónicos sobre productos relacionados que combinan de forma natural, pero que algunos clientes todavía no han comprado.

• Categorías
  Las categorías a las que pertenece el producto pedido, por ejemplo: Camisas, Hombre o Oferta.
• Nombre
  El nombre del producto comprado, por ejemplo, Camiseta roja para hombre.
• ProductId
  El id del producto tal como está configurado en la tienda, por ejemplo, 2022, 2023, 2024.
• Cantidad
  La cantidad representada por este evento, que es 1. Un pedido de 3 unidades del mismo producto crea 3 eventos de producto pedido.
• SKU
  El SKU del producto tal como está configurado en tu tienda.
• Opción de variante: color
  El color del producto, si está disponible; por ejemplo, rojo o azul.
• Opción de variante: tamaño
  El tamaño del producto, si está disponible; por ejemplo, Mediano o Grande.

Pedido completado

Esta métrica registra un evento cuando un pedido completado se marca como enviado en Spree. El evento en Klaviyo incluye el número de seguimiento de cualquier envío, por lo que puedes usar esta métrica como activador para correos electrónicos de confirmación de envío. Otro correo electrónico común basado en la métrica Pedido completado es el correo electrónico de reseña de producto, en el que pides a los clientes que dejen una reseña de los artículos que compraron recientemente. Usar la métrica Pedido completado te permite programar estos correos electrónicos a partir del envío, pero no confirma la entrega. Agrega un retraso que deje tiempo para la entrega antes de enviar una solicitud de reseña de producto. Puedes filtrar y orientar los eventos de Pedido completado en función de los siguientes criterios:

• IsDiscounted
  Si se aplicó un descuento a un pedido; por ejemplo, true o false.
• NombresDeArtículos
  Los nombres de los artículos comprados en este evento.

Proceso de Pago Iniciado

Esta métrica registra un evento para un proceso de pago con una dirección de correo electrónico de cliente válida y al menos 1 artículo. El uso principal de esta métrica es enviar correos electrónicos de carrito abandonado. Con Klaviyo, puedes configurar fácilmente un flujo de correo electrónico para enviar un recordatorio del carrito si alguien inició el proceso de pago, pero no ha realizado un pedido después de unas horas. El evento Proceso de pago iniciado contiene toda la información sobre el carrito de alguien, por lo que puedes mostrar los productos en su carrito, así como imágenes de esos productos. Para usuarios más avanzados, puedes configurar 2 flujos de carrito abandonado: uno para clientes primerizos que incluya un código de descuento, y otro para compradores recurrentes que no incluya un código de descuento. Puedes filtrar y orientar los eventos de Proceso de pago iniciado en función de los siguientes criterios:

• IsDiscounted
  Si se aplicó un descuento a un pedido; por ejemplo, true o false.
• ItemNames
  Los nombres de los artículos en el carrito de compra.

datos de clientes

Además de las métricas que Klaviyo sincroniza desde Spree, también hay propiedades de cliente que se agregan a los perfiles de Klaviyo cuando están disponibles en los datos del pedido. Puedes usar estas propiedades en segmentos y flujos. Estas son las propiedades que se sincronizan desde Spree. Los detalles de nombre, ubicación y teléfono provienen de la dirección de facturación del pedido:

• Correo electrónico
• Nombre
• Apellido
• Ciudad
• Estado/región
• Código postal
• País
• Número de teléfono

Resultado

Ya integraste la cuenta de Klaviyo con Spree, instalaste el seguimiento en el sitio y revisaste los datos sincronizados.

Recursos adicionales