Cómo integrarse con Spree

Hola: 10 minutos de lectura
|
Actualizado 27 nov 2024, 15:59 EST
Qué aprenderás

Qué aprenderás

Aprenda a integrar Spree con Klaviyo. Una vez completados estos pasos, podrá personalizar y dirigir los 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, incluidos los productos adquiridos, las imágenes de los productos, los detalles de las variantes y los descuentos aplicados.
  • Información del cliente, incluyendo nombre y apellidos, ubicación y cómo encontró su tienda
  • Datos de pedidos cumplidos

Un parche de seguridad impulsado para las versiones 2.2.14, 2.3.13 de Spree, 2.4.10, y 3.0.4 obliga a que los parámetros de búsqueda se incluyan en la lista de permitidos. La propiedad updated_at de productos y pedidos no se incluía en la lista predeterminada de permitidos. La integración de Klaviyo se basa en este parámetro, y por lo tanto usted tendrá que empujar una actualización para allowlist esta propiedad para asegurarse de que su integración se ejecuta sin problemas. Si no permite la propiedad updated_at para los pedidos, es posible que los eventos de Pago iniciado no se sincronicen hasta que se realice un pedido.

Añadir la integración Spree en Klaviyo

Añadir la integración Spree en Klaviyo

  1. Para conectar Spree a su cuenta, navegue hasta Klaviyo y haga clic en el nombre de su cuenta en la esquina inferior izquierda, después seleccione Integraciones.
  2. Haz clic en Añadir integraciones, buscaSpree y haz clic en la tarjeta. Luego, haz clic en Instalar.
  3. En la página siguiente, tendrá que proporcionar la URL de su tienda y una clave API Spree / contraseña encriptada. Puede generar esta clave API en su administración de Spree navegando a Usuarios, eligiendo una cuenta y seleccionando Generar clave API.
  4. De vuelta en Klaviyo, pegue la URL de su tienda y la clave API/contraseña encriptada en las casillas.
  5. Si utiliza una API Spree versionada (v1), marque la casilla correspondiente.
  6. Haga clic en Conectar con Spree. 
  7. Si desea añadir los clientes que opten por recibir correo electrónico de su tienda Spree a una lista en Klaviyo, marque la casilla Añadir nuevos clientes de Spree a una lista de Klaviyo en la página siguiente. Tras marcar esta casilla, seleccione una lista a la que se añadirán los nuevos opt-ins.
  8. Cuando esté listo, haga clic en Completar configuración. Entonces debería ver un mensaje de éxito indicando que se ha integrado correctamente.
Instale el seguimiento in situ de Klaviyo

Instale el seguimiento in situ de Klaviyo

Para instalar el seguimiento in situ, que consta de dos eventos: Activo en el sitio y Producto visto, encuentre primero su clave de API pública. Acceda a su cuenta de Klaviyo y vaya a Nombre de cuenta > Configuración > Claves API. Su clave pública tiene seis caracteres. Copie de forma segura esta clave para utilizarla en el siguiente paso. 

Hay dos tipos de seguimiento in situ que puede aprovechar:

  • Activo en el sitio
    Esta métrica se rastrea cada vez que un navegador identificable visita su sitio web.
  • Producto visto
    Esta métrica se rastrea cada vez que un navegador identificable ve una página de producto en su sitio web.
"Activo en el sitio" seguimiento

"Activo en el sitio" seguimiento

Esta métrica se rastrea cada vez que un navegador identificable visita su sitio web.

  1. Para comenzar a realizar el seguimiento de la actividad Active on Site, añada el siguiente fragmento de código a la plantilla principal de su tienda para que se incluya en todas las páginas. Debe colocar este fragmento junto a otros scripts de análisis que utilice o justo antes de la etiqueta de cierre </body >.</body>
  2. Asegúrese de sustituir Clave Pública API por la Clave Pública API de su cuenta 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"> 
    //Inicializar el objeto Klaviyo al cargar la página
    !function(){if(!window.klaviyo){window._klOnsite=window._klOnsite||[];try{window.klaviyo=nuevo 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]=argumentos[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>
  3. Dependiendo de los tipos de plantillas que utilice para su sitio web, es probable que la sintaxis {% if user.is_logged_in %} y {{ user.email }} sean diferentes. Utilizando el idioma de plantilla disponible, desea comprobar si la persona que está viendo la página actual ha iniciado sesión. En caso afirmativo, deberá indicar su dirección de correo electrónico y su nombre, si están disponibles. Si no tiene información sobre el nombre, elimine esas dos líneas y la coma final después de la línea $email.
  4. Este código de seguimiento de Klaviyo le permitirá rastrear un Activo en Sitemetricpara que pueda 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 rastreará la actividad en el sitio de los navegadores conocidos.
  5. Para comprobar que su seguimiento in situ está configurado correctamente, vaya a una página de su tienda y añada ?utm_email=email@example.com al final la URL sustituyendo email@example.com por su dirección de correo electrónico. Después de recargar la página, busque en Klaviyo su dirección de correo electrónico. Debería ver que se ha creado un perfil y que ha seguido la actividad de su sitio. 
"Producto visto" seguimiento

"Producto visto" seguimiento

Si desea configurar un flujo de abandono de navegación o construir segmentos basados en datos de navegación de productos, querrá añadir el seguimiento de eventos JavaScript para una métrica de Producto Visto.

  1. En la plantilla de su página de producto, añada el siguiente fragmento:
    <script type="text/javascript">
     var klaviyo = window.klaviyo || [];
     klaviyo.track("Visto Producto", {
        Título: '{{ product.name }}',
        ItemId: {{ product.id }},
        Categorías: {{ category in product.categories|json }}, // La lista de categorías es una matriz de cadenas.
        ImageUrl: '{{ product.image_url }}',
        Url: '{{ product.permalink }}',
        Metadatos: {
        Marca: '{{ product.brand }}',
        Precio: {{ product.price }},
        En Venta: {{ product.on_sale }},
        Precio normal: {{ product.regular_price }},
        Precio de venta: {{ product.sale_price }}
     }
     });
    </script>
  2. El fragmento anterior utiliza la sintaxis de marcador de posición {{ }} que puede ser diferente para su tienda Spree. Lo importante es que los campos de producto se renderizan dinámicamente en función de la página de producto que esté viendo.
  3. Una vez configurado el seguimiento de productos vistos para su sitio, los datos de productos vistos deberían empezar a aparecer en su cuenta de Klaviyo a medida que los visitantes conocidos navegan por las páginas de sus productos.
Cómo funciona el seguimiento in situ

Cómo funciona el seguimiento in situ

Cuando añade el seguimiento in situ de Klaviyo a su sitio web, sólo podemos rastrear la actividad de navegación de los navegadores conocidos de "" , es decir, los navegadores que han visitado y participado al menos una vez antes. Hay dos formas principales de identificar a un visitante del sitio con fines de seguimiento in situ:

  • Si alguien, en algún momento, ha hecho clic a través de un correo electrónico Klaviyo a su sitio web
  • Si alguien, en algún momento, se ha suscrito/optado a través de un formulario de Klaviyo

Klaviyo no rastreará navegadores anónimos.

Supervise la sincronización de Klaviyo 

Supervise la sincronización de Klaviyo 

Para comprobar su integración:

  1. Haga clic en el menú desplegable de Análisis en Klaviyo y seleccione Métricas. Aquí puede filtrar para ver todas las métricas de Spree.
  2. Busque la orden métrica colocadade Spree y haga clic en el icono de alimentación de actividad. Si su integración ha comenzado a sincronizar los datos, empezará a ver que los eventos de Pedido realizado aparecen aquí.
  3. Sincronizaremos automáticamente todos los datos históricos de los pedidos. Para comprobarlo, puede comparar el número de eventos de un día concreto en Klaviyo con lo que aparece en su interfaz de Spree y confirmar que coinciden. Por ejemplo, al explorar la métrica Pedidos realizados, puede pasar el ratón por encima del punto de datos de ayer o consultar la tabla de datos situada debajo del gráfico para ver cuántos pedidos se registraron ayer.
  4. Compare ese número con el que está almacenado en Spree desde ayer y debería ver que coinciden exactamente. Si no lo hacen, lo más probable es que el problema sea que la zona horaria de su cuenta de Klaviyo no coincide con la zona horaria que ha establecido en Spree.
  5. Para comprobar la configuración de su zona horaria en Klaviyo:
    • Haga clic en el nombre de su cuenta en la parte inferior izquierda.
    • Seleccione y, a continuación, haga clic en Configuración > Organización.
    • Desplácese hasta Zona horaria.
  6. Una vez completada esta sincronización histórica, verá un borde verde claro alrededor de su integración Spree en la pestaña Integraciones.
Datos sincronizados desde Spree

Datos sincronizados desde Spree

La integración de Spree se sincroniza con Klaviyo cada hora.

A continuación encontrará una lista de las métricas que Spree sincroniza con Klaviyo. Puede ver todas las métricas Spree que se sincronizan en su cuenta en Analytics > Métricas

Pestaña de métricas en Klaviyo filtrada por Spree mostrando métricas como Pedido Cumplido y Producto Pedido

Pedido realizado 

Pedido realizado 

Esta métrica registra un evento cada vez que alguien realiza un pedido y lo paga correctamente. Corresponde a pedidos en Spree que están completos, lo que significa que un cliente ha completado todo el proceso de pago. Con esta métrica, podrá 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 puede crear correos electrónicos para volver a captar a antiguos clientes o enviar correos de agradecimiento a los que compran por primera vez. Puede filtrar y orientar los eventos de Pedido Colocado en función de los siguientes criterios:

  • IsDiscounted
    Si a un pedido se le ha aplicado un descuento, por ejemplo, verdadero o falso.
  • ItemNames
    Los nombres de los productos comprados en este evento.
Producto pedido

Producto pedido

Esta métrica es similar a la de Pedidos realizados, sin embargo se registra un evento por cada artículo que alguien pide. Por ejemplo, si alguien comprara una camiseta y un par de pantalones cortos, esto aparecería en Klaviyo como un evento Pedido realizado y dos eventos Producto pedido, uno para la camiseta y otro para el par de pantalones cortos. Esta métrica es útil para crear listas dirigidas a clientes que hayan comprado (o no hayan comprado) artículos específicos o artículos de categorías específicas. También puede utilizar la métrica Producto pedido como desencadenante de flujos para enviar correos electrónicos sobre productos relacionados que van juntos de forma natural, pero que algunos clientes aún no han comprado.

  • Categorías
    Las categorías a las que pertenece el producto solicitado, por ejemplo, Camisas, Hombre o Rebajas.
  • Nombre
    El nombre del producto adquirido, por ejemplo, Camiseta roja de hombre.
  • ProductId
    El id de su producto tal y como está configurado en su tienda, por ejemplo, 2022, 2023, 2024.
  • Cantidad
    La cantidad de un producto pedida.
  • SKU
    El SKU del producto tal y como está configurado en su tienda.
  • Variante Opción: Color
    El color del producto, si está disponible, por ejemplo, rojo o azul.
  • Variante Opción: Talla
    La talla del producto, si está disponible, por ejemplo, Mediana o Grande.
Pedido cumplido

Pedido cumplido

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, por lo que puede utilizar esta métrica como disparador para los correos electrónicos de confirmación de envío. Otro correo electrónico común basado en la métrica de pedido cumplido es el correo electrónico de reseña del producto, en el que se pide a los clientes que dejen una reseña de los artículos que han comprado recientemente. El uso de la métrica de Pedido Cumplido le permite programar estos correos electrónicos en función del momento en que alguien recibe su pedido, de modo que no tiene que preocuparse de enviarles un correo electrónico antes de que hayan recibido su paquete. Puede filtrar y orientar los eventos de Pedido Cumplido en función de los siguientes criterios:

  • IsDiscounted
    Si a un pedido se le ha aplicado un descuento, por ejemplo, verdadero o falso.
  • ItemNames
    Los nombres de los artículos comprados en este evento.
Pago iniciado

Pago iniciado

Esta métrica registra un evento cada vez que alguien inicia una compra y ha introducido su dirección de correo electrónico. El uso principal de esta métrica es el envío de correos electrónicos sobre carritos abandonados. Con Klaviyo, puede configurar fácilmente un flujo de correo electrónico para enviar un recordatorio del carrito si alguien empezó a realizar el pago pero no ha realizado el pedido al cabo de unas horas. El evento Pago iniciado contiene toda la información sobre el carro de alguien, por lo que puede mostrar los productos de su carro, así como imágenes de esos productos. Para los usuarios más avanzados, puede configurar dos flujos de carritos abandonados: uno para los clientes que compran por primera vez que incluya un código de descuento y otro para los compradores habituales que no lo incluya. Puede filtrar y orientar los eventos de Pago iniciado en función de los siguientes criterios:

  • IsDiscounted
    Si a un pedido se le ha aplicado un descuento, por ejemplo, verdadero o falso.
  • ItemNames
    Los nombres de los artículos comprados en este evento.
Datos del cliente

Datos del cliente

Además de las métricas que Klaviyo sincroniza desde Spree, también hay propiedades de los clientes que se añaden a cada perfil de Klaviyo. Puede utilizar 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

Resultado

Ya ha integrado su cuenta de Klaviyo con Spree, ha instalado el seguimiento in situ y ha revisado los datos sincronizados.

Recursos adicionales

Recursos adicionales

¿Te ha resultado útil este artículo?
Utiliza este formulario solo para enviar comentarios sobre el artículo. Más información sobre cómo contactar con el servicio de asistencia.

Descubre más de Klaviyo

Comunidad
Conecta con compañeros, socios y expertos de Klaviyo para inspirarte, compartir ideas y resolver todas tus dudas.
Formación en directo
Únete a una sesión en directo con expertos de Klaviyo para conocer las prácticas recomendadas, cómo configurar funciones clave y mucho más.
Asistencia

Accede al servicio de asistencia a través de tu cuenta.

Asistencia por correo electrónico (prueba gratuita y cuentas de pago) Disponible 24/7

Asistencia por chat/virtual
La disponibilidad varía según la ubicación y el tipo de plan