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, incluidos el nombre y el apellido, la ubicación y cómo encontró tu tienda
• 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 estás usando una interfaz de programación de aplicaciones (API) de Spree con versiones (v1), marca la casilla correspondiente.
6. Haz clic en Conectar con Spree.
7. Si quieres añadir a una lista en Klaviyo a los clientes que acepten recibir correos electrónicos de tu tienda de 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 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, que consta de dos eventos: Con actividad en el sitio y Producto visto, primero busca la clave de API pública. Inicia sesión en la cuenta de Klaviyo y ve a Nombre de la cuenta > Configuración > Claves de API. La 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:

• 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. Según 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 mostrar su correo electrónico y su nombre, si está disponible. Si no tienes información del nombre, elimina esas dos líneas y la coma final después de la línea de correo electrónico $email.
2. Este código de seguimiento de Klaviyo te permitirá hacer seguimiento de una métrica de Con actividad en el sitiopara que puedas ver y aprovechar datos relacionados con visitas al sitio y el comportamiento de las personas visitantes. A través de esta métrica, Klaviyo hará seguimiento de la actividad en el sitio para navegadores conocidos.
3. Para probar que el seguimiento en el sitio esté configurado correctamente, ve a una página de tu 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. Después de recargar la página, busca en Klaviyo tu dirección de correo electrónico. Deberías ver que se ha creado un perfil y que ha registrado la actividad del 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 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 la tienda Spree. La parte importante es que los campos de producto se renderizan dinámicamente en función de la página de producto que estés viendo.
2. Después de configurar el seguimiento de Viewed Product para el sitio, los datos de Viewed Product deberían empezar a completarse en la cuenta de Klaviyo a medida que los visitantes conocidos naveguen por las páginas de productos.

Cómo funciona el seguimiento en el sitio

Cuando añades el seguimiento en el sitio de Klaviyo a tu sitio, solo podemos rastrear la actividad de navegación de los "navegadores conocidos" (es decir, navegadores que han visitado y tenido interacciones al menos una vez antes). Hay dos maneras clave en las que podemos identificar a un visitante del sitio para fines del seguimiento en el 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

Klaviyo no hará seguimiento de navegadores anónimos.

Monitorea la sincronización de Klaviyo

Para comprobar la integración:

1. Haz clic en el menú desplegable Analytics en Klaviyo y selecciona métrica. Aquí puedes filtrar para ver todas las métricas de Spree.
2. Busca la métrica Placed Orderde Spree y haz clic en el icono de Actividad. Si tus integraciones comenzaron a sincronizar datos, aquí empezarás a ver eventos Placed Order.
3. Sincronizaremos automáticamente todos los datos históricos de pedidos. Para verificarlo, puedes comparar el número de eventos en un día específico en Klaviyo con lo que aparece en la interfaz de Spree y confirmar que coincidan. Por ejemplo, al explorar la métrica Placed Order, puedes pasar el cursor sobre el punto de datos de ayer o ver la tabla de datos debajo del gráfico para ver cuántos pedidos se reportaron ayer.
4. Compara ese número con lo 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 huso horario de la cuenta de Klaviyo no coincida con el huso horario configurado en Spree.
5. Para verificar la configuración de zona horaria en Klaviyo:
   • Haz clic en el nombre de tu cuenta en la parte inferior izquierda.
   • Selecciona y luego 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 la integración de Spree en la pestaña Integraciones.

Datos sincronizados desde Spree

A continuación, se muestra una lista de métricas que Spree sincroniza en Klaviyo. Puedes consultar todas las métricas de Spree que se sincronizan con la 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. Corresponde a los pedidos en Spree que están completos, lo que significa que un cliente completó todo el proceso de pago. Con esta métrica, puedes crear fácilmente listas dinámicas de personas según el número de pedidos que han realizado o su valor de vida. También puedes crear correos electrónicos para volver a captar a clientes anteriores o enviar correos electrónicos de agradecimiento por primera compra. Puedes filtrar y dirigir los eventos de Pedido realizado 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 Placed Order; sin embargo, se registra un evento por cada artículo que alguien pide. Por ejemplo, si alguien compró una playera y un par de shorts, esto aparecería en Klaviyo como un evento Placed Order y dos eventos Ordered Product: uno para la playera y otro para el par de shorts. Esta métrica es útil para crear listas dirigidas a clientes que compraron (o no compraron) artículos específicos o artículos en categorías específicas. También puedes usar la métrica Ordered Product como activador de flujos para enviar correos electrónicos sobre productos relacionados que combinan de forma natural, pero que algunos clientes aún no han comprado.

• Categorías
  Las categorías a las que pertenecen el producto pedido, por ejemplo, Camisas, Hombre u 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 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; por ejemplo, Mediano o Grande.

Pedido completado

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 un activador para correos electrónicos de confirmación de envío. Otro correo electrónico común basado en la métrica de Pedido completado es el correo electrónico de reseña del producto, en el que pides a los clientes que dejen una reseña de los artículos que compraron recientemente. Usar la métrica de Pedido completado te permite programar estos correos electrónicos en función de cuándo alguien recibe su pedido para que no tengas que preocuparte por enviarles un correo electrónico antes de que hayan recibido su paquete. Puedes filtrar y dirigir 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 cada vez que alguien inicia un proceso de pago y ha ingresado su dirección de correo electrónico. 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 comenzó a finalizar la compra, 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 una persona, por lo que puedes mostrar los productos en su carrito, así como imágenes de esos productos. Para usuarios más avanzados, puedes configurar dos flujos de carrito abandonado: uno para clientes nuevos 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.
• NombresDeArtículos
  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 de cliente que se agregan a cada perfil de Klaviyo. Puedes usar estas propiedades en segmentos y flujos. Estas son las propiedades que se sincronizan automáticamente desde Spree:

• 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