Cómo integrar Spree

Qué aprenderás

Aprende a integrar Spree con Klaviyo. Después de completar estos pasos, podrás personalizar y dirigir los emails 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, incluidos los productos que se compraron, las imágenes de los productos, los detalles de las variantes y los descuentos aplicados
• Información del cliente, incluido el nombre y los apellidos, la ubicación y cómo encontraron tu tienda
• Datos de pedidos procesados

Añade 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. A continuación, haz clic en Instalar.
3. En la página siguiente, tendrás que proporcionar la URL de tu tienda y una clave de API de Spree/contraseña cifrada. Puedes generar esta clave de API en el administrador de Spree. Para ello, ve a Users, elige una cuenta y, a continuación, selecciona Generate API Key.
4. De vuelta en Klaviyo, pega la URL de tu tienda y la clave de API/contraseña cifrada en las casillas.
   

5. Si utilizas una API de Spree con versiones (v1), marca la casilla correspondiente.
6. Haz clic en Conectarse a Spree.
7. Si quieres añadir a una lista de Klaviyo a los clientes que se suscriban para recibir email desde tu tienda Spree, marca la casilla Añadir nuevos clientes de Spree a una lista de Klaviyo en la página siguiente. Después de marcar esta casilla, selecciona una lista a la que se añadirán las nuevas suscripciones.
8. Cuando lo tengas todo listo, haz clic en Completar configuración. A continuación, deberías ver un mensaje de éxito que indica que la integración se ha realizado correctamente.

Instala el seguimiento en el sitio de Klaviyo

Para instalar el seguimiento en el sitio, que consta de dos eventos (Activo en el sitio y Producto visto), primero busca tu clave de API pública. Inicia sesión en tu cuenta de Klaviyo y ve a Nombre de la cuenta > Configuración > clave de API. Tu clave pública tiene seis caracteres. Copia esta clave de forma segura para usarla en el siguiente paso.

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

• Activo en el sitio
  Se hace un seguimiento de esta métrica cada vez que un navegador identificable visita tu sitio web
• Producto visto
  Esta métrica se registra cada vez que un navegador identificable visualiza una página de producto en tu sitio web

Seguimiento de «Active on Site»

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

1. Para empezar a hacer el seguimiento de la actividad Active on Site, 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 junto con otros scripts de analítica que uses o justo antes de la etiqueta de cierre </body>.
2. Asegúrate de sustituir Public API Key por la clave de API pública de tu 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. En función de los tipos de plantillas que uses para tu sitio web, es probable que la sintaxis de {% if user.is_logged_in %} y {{ user.email }} sea diferente. Con el lenguaje de plantillas disponible, debes comprobar si la persona que está viendo la página actual ha iniciado sesión. Si es así, debes incluir su email y su nombre, si está disponible. Si no tienes información sobre el nombre, elimina esas dos líneas y la coma final después de la línea de $email del email.
2. Este código de seguimiento de Klaviyo te permitirá hacer el seguimiento de una métrica Activo en el sitiopara que puedas ver y aprovechar los datos relacionados con las visitas al sitio y el comportamiento de los visitantes. A través de esta métrica, Klaviyo hará un seguimiento de la actividad en el sitio para navegadores conocidos.
3. Para probar que tu seguimiento en el sitio está configurado correctamente, ve a una página de tu tienda y añade ?utm_email=email@example.com al final de la URL, sustituyendo email@example.com por tu dirección de email. Después de volver a cargar la página, busca tu dirección de email en Klaviyo. Deberías ver que se ha creado un perfil y que ha registrado la actividad de tu sitio.

Seguimiento de «Producto visto»

Si quieres configurar un flujo de abandono de navegación o crear segmentos basados en datos de navegación por los productos, tendrás que añadir el seguimiento de eventos de JavaScript para una métrica Producto visto.

1. En la plantilla de tu página de producto, añade el siguiente fragmento:

<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. El fragmento de código anterior usa la sintaxis de marcador de posición {{ }}, que puede ser diferente para tu tienda de Spree. Lo importante es que los campos de producto se renderizan de forma dinámica en función de la página de producto que estés viendo.
2. Después de configurar el seguimiento de Viewed Product para tu sitio, los datos de Viewed Product deberían empezar a aparecer en tu cuenta de Klaviyo a medida que los visitantes conocidos naveguen por las páginas de tus productos.

Cómo funciona el seguimiento en el sitio

Cuando añades el seguimiento en el sitio de Klaviyo a tu sitio, solo podemos hacer un seguimiento de la actividad de navegación de los "navegadores conocidos", es decir, navegadores que hayan visitado e interactuado al menos una vez antes. Hay dos formas clave en las que podemos identificar a un visitante del sitio para fines de seguimiento en el sitio:

• Cuando una persona, en un momento determinado, hace clic en un enlace dentro de un Klaviyo Email con dirección a tu sitio web
• Cuando una persona, en un momento determinado, se suscribe o registra mediante un formulario de Klaviyo

Klaviyo no hará seguimiento de los navegadores anónimos.

Supervisa la sincronización de Klaviyo

Para comprobar tus integraciones:

1. Haz clic en el menú desplegable Análisis en Klaviyo y selecciona Métricas. Aquí puedes aplicar un filtro para ver todas las métricas de Spree.
2. Busca la métrica Placed Orderde Spree y haz clic en el icono de feed de actividad. Si tus integraciones han empezado a sincronizar datos, empezarás a ver cómo se completan aquí los eventos Placed Order.
3. Sincronizaremos automáticamente todos los datos históricos de pedidos. Para verificarlo, puedes comparar el número de eventos de un día concreto en Klaviyo con lo que haya en tu interfaz de Spree y confirmar que coinciden. Por ejemplo, al explorar la métrica Pedido realizado, puedes pasar el cursor sobre el punto de datos de ayer o consultar la tabla de datos debajo del gráfico para ver cuántos pedidos se registraron ayer.
4. Compara ese número con el que está almacenado en Spree desde ayer y deberías ver que coinciden exactamente. Si no es así, lo más probable es que el problema sea que la zona horaria de tu cuenta de Klaviyo no coincide con la zona horaria de Spree que has establecido.
5. Para comprobar tu configuración de zona horaria en Klaviyo:
   • Haz clic en el nombre de tu cuenta en la parte inferior izquierda.
   • Selecciona y, a continuación, haz clic en Configuración > Organización.
   • Desplázate hacia abajo hasta Zona horaria.
6. Cuando se complete esta sincronización histórica, verás un borde verde claro alrededor de tus integraciones de Spree en la pestaña integraciones.

Datos sincronizados desde Spree

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

Pedido Realizado

Esta métrica registra un evento cada vez que alguien realiza un pedido y lo paga correctamente. Se corresponde con los pedidos de Spree que están completos, lo que significa que un cliente ha completado todo el proceso de pago. Con esta métrica, puedes crear fácilmente listas dinámicas de personas en función del número de pedidos que hayan realizado o de su valor de vida. También puedes crear emails para volver a captar a antiguos clientes o enviar emails de agradecimiento a los clientes por su primera compra. Puedes filtrar y orientar los eventos de Placed Order en función de los siguientes criterios:

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

Producto Pedido

Esta métrica es similar a la métrica Placed Order; sin embargo, se registra un evento por cada artículo que alguien pide. Por ejemplo, si alguien compró una camiseta y un par de pantalones cortos, esto aparecería en Klaviyo como un evento Placed Order y dos eventos Ordered Product, uno para la camiseta y otro para el par de pantalones cortos. Esta métrica es útil para crear listas dirigidas a 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 Ordered Product como activador para flujos que envíen emails sobre productos relacionados que combinan naturalmente, pero que algunos clientes aún no han comprado.

• Categorías
  Las categorías a las que pertenecen los productos pedidos, por ejemplo, Camisas, Hombre u Oferta.
• Name
  El nombre del producto comprado (por ejemplo, Camiseta roja de hombre).
• ProductId
  El id de tu producto tal como está configurado en tu tienda, por ejemplo, 2022, 2023, 2024.
• Quantity
  La cantidad de un 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, p. ej., Mediano o Grande.

Pedido Procesado

Esta métrica registra un evento cuando se envía el pedido de un cliente. El evento en Klaviyo incluye el número de seguimiento de cualquier envío, así que puedes usar esta métrica como activador para emails de confirmación de envío. Otro email habitual basado en la métrica Pedido completado es el email de reseña del producto, en el que pides a los clientes que dejen una reseña de los artículos que han comprado recientemente. Usar la métrica Fulfilled Order te permite programar estos emails en función de cuándo alguien recibe su pedido, para que no tengas que preocuparte por enviarle un email antes de que haya recibido su paquete. Puedes filtrar y orientar los eventos de Pedido completado en función de los siguientes criterios:

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

Pago iniciado

Esta métrica registra un evento cada vez que alguien inicia el proceso de compra y ha introducido su dirección de email. El uso principal de esta métrica es enviar emails de carrito abandonado. Con Klaviyo, puedes configurar fácilmente un flujo de email para enviar un recordatorio del carrito si alguien inició el proceso de compra pero no ha realizado un pedido después de unas horas. El evento Checkout iniciado contiene toda la información sobre el carrito de una persona, así que puedes mostrar los productos de su carrito, así como imágenes de esos productos. Para usuarios más avanzados, puedes configurar dos flujos de carrito abandonado: uno para clientes que compran por primera vez que incluye un código de descuento, y otro para compradores recurrentes que no incluye un código de descuento. Puedes filtrar y orientar los eventos de Proceso de compra iniciado en función de los siguientes criterios:

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

Datos de clientes

Además de las métricas que Klaviyo sincroniza desde Spree, también hay propiedades del cliente que se añaden a cada perfil de Klaviyo. Puedes usar estas propiedades en segmentos y flujos. Estas son las propiedades que se sincronizan automáticamente desde Spree:

• Email
• Nombre
• Apellidos
• City
• Estado o región
• Zip Code
• Country
• Phone Number

Resultado

Ahora has integrado tu cuenta de Klaviyo con Spree, has instalado el seguimiento en el sitio y has revisado tus datos sincronizados.

Recursos adicionales