Cómo integrar con Volusion

Objetivos del artículo

Aprende a integrar Volusion con Klaviyo. Después de completar estos pasos, podrás personalizar y segmentar correos electrónicos según los datos de pedidos sincronizados y las propiedades del cliente.

Desde Volusion, Klaviyo rastrea las métricas de producto pedidoy pedido realizado; con la adición de código extra, podemos rastrear la información de carrito abandonadotambién.

Antes de empezar

Volusion requiere una actualización de la contraseña de la cuenta de administrador de tu tienda de Volusion cada 90 días. Al hacer esta actualización en tu cuenta de Volusion, también debes hacerla en la integración de Volusion en tu cuenta de Klaviyo. También puedes crear una clave de API permanente siguiendo los pasos en la sección correspondiente de este artículo.

Agrega la integración de Volusion en Klaviyo

1. En Klaviyo, selecciona la pestaña Integraciones.
2. Selecciona Explorar aplicaciones.
3. Busca Volusion y haz clic en la tarjeta, a continuación, haz clic en Instalar.
4. En la siguiente página, ingresa la URL de la tienda, el correo electrónico de inicio de sesión y la clave de API/contraseña cifrada. Luego, haz clic en Conectar con Volusion.
   

5. En la página siguiente, verás una casilla para Agregar clientes nuevos de Volusion a una lista de Klaviyo. Si marcas esta casilla, puedes elegir una de tus listas en Klaviyo a la que se agregarán futuros clientes cuando realicen un pedido.
6. Por último, haz clic en Completar la configuración.

Desactivar el seguimiento web de correo electrónico en Klaviyo

1. La función de "seguimiento web de correos electrónicos a la web" en Klaviyo usa el seguimiento de clics para identificar a un usuario que llega a tu sitio web a través de un Klaviyo Email antes de que originalmente pudiéramos identificarlo (por ejemplo, cuando realiza una compra o se suscribe a tu lista de correos electrónicos).
2. Volusion no admite el formato de URL que usa nuestro seguimiento de clics y produce un error cuando un usuario intenta visitar tu tienda a través de uno de estos enlaces, así que esta función tendrá que desactivarse en Klaviyo para asegurarte de que los enlaces de tu correo electrónico lleven correctamente a tu tienda de Volusion.
3. Puedes desactivar este seguimiento en la configuración de la cuenta, en Nombre de la cuenta > Configuración > Correo electrónico > Atribución.
4. La única funcionalidad que se pierde al desactivar esta función es la capacidad de rastrear un nuevo perfil en el sitio web a través de un correo electrónico en el que hicieron clic. Mientras tengas el seguimiento de analíticas onsite de Klaviyo en el sitio web (que agregaremos en la siguiente sección), todavía podremos rastrear a los usuarios en cuanto obtengamos su dirección de correo electrónico, ya sea a través de una compra en la tienda o cuando se registren en una lista de correos electrónicos.

Agrega el seguimiento en el sitio a tu tienda de Volusion

Klaviyo ofrece dos fragmentos de seguimiento en el sitio para ayudarte a recopilar información valiosa sobre tus clientes:

• Con actividad en el sitio
  Este fragmento de código rastrea cuándo tus clientes visitan tu sitio. Este fragmento de código debe agregarse al sitio para que funcionen otros fragmentos de código, como Viewed Product.
• Producto visto
  Este fragmento hace un seguimiento de cuándo tus clientes ven productos específicos. Puedes hacer el seguimiento de este evento agregando el fragmento de código Viewed Product a tu tienda.

Agregar seguimiento con actividad en el sitio

Agrega el siguiente fragmento de código de Klaviyo.js para que aparezca en todas las páginas de tu sitio web. Esto habilitará el seguimiento de con actividad en el sitio y los formularios de Klaviyo. Asegúrate de reemplazar PUBLIC_API_KEY con tu clave de API pública de Klaviyo.

<script type="application/javascript" async="" src="https://static.klaviyo.com/onsite/js/PUBLIC_API_KEY/klaviyo.js"></script>
<script type="text/javascript"> 
//Script to initialize 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>

Agregar el seguimiento de productos vistos

Para habilitar el seguimiento de Viewed Product, tendrás que agregar el fragmento de código que aparece abajo a la página de plantilla de la tienda en el editor de archivos de Volusion, al que puedes acceder al hacer clic en Design > File Editor.

<script type="text/javascript">
// Check to see if the customer is on the product page before executing code.
    if ($("meta[property='og:type']").attr("content") == "product") {
        var klaviyo = window.klaviyo || [];
        // Function to track when a product is viewed
        var trackViewedProduct = function(item) {
            klaviyo.track("Viewed Product", item);
            klaviyo.trackViewedItem({
                "Title": item.ProductName,
                "ItemId": item.ProductID,
                "ImageUrl": item.ImageURL,
                "Url": item.URL,
                "Metadata": {
                    "Price": item.Price,
                    "Description": item.Description,
                    "CompareAtPrice": item.CompareAtPrice,
                    "YouSave": item.YouSave
                }
            });
        };
        var item = {}
        $.get(`/ProductDetails.asp?ProductCode=${global_Current_ProductCode}`, function(data) {
            var product_saleprice = $("table.colors_pricebox div.product_saleprice").length ?
                Number(`${$("table.colors_pricebox div.product_saleprice").text().trim().split("$")[1].split(".")[0]}.${$("table.colors_pricebox div.product_saleprice").text().trim().split("$")[1].split(".")[1].substring(0,2)}`) : null;
            var product_listprice = $("table.colors_pricebox div.product_listprice").length ?
                Number(`${$("table.colors_pricebox div.product_listprice").text().trim().split("$")[1].split(".")[0]}.${$("table.colors_pricebox div.product_listprice").text().trim().split("$")[1].split(".")[1].substring(0,2)}`) : null;
            var product_productprice = $("table.colors_pricebox div.product_productprice").length ?
                Number(`${$("table.colors_pricebox div.product_productprice").text().trim().split("$")[1].split(".")[0]}.${$("table.colors_pricebox div.product_productprice").text().trim().split("$")[1].split(".")[1].substring(0,2)}`) : null;
            var product_yousave = $("table.colors_pricebox div.product_yousave").length ?
                Number(`${$("table.colors_pricebox div.product_yousave").text().trim().split("$")[1].split(".")[0]}.${$("table.colors_pricebox div.product_yousave").text().trim().split("$")[1].split(".")[1].substring(0,2)}`) : 0;
            item = {
                "ProductName": $("meta[property='og:title']").attr("content"),
                "ProductID": global_Current_ProductCode,
                "Description": $("meta[property='og:description']").attr("content"),
                "ImageURL": $("meta[property='og:image']").attr("content"),
                "URL": $("meta[property='og:url']").attr("content"),
                "Price": product_saleprice ? product_saleprice : product_productprice,
                "CompareAtPrice": product_listprice ? product_listprice : product_productprice,
                "YouSave": product_yousave
            };
            trackViewedProduct(item);
        });
    } 
</script>

Agregar recordatorios de carrito abandonado

Volusion no ofrece una manera lista para usar de rastrear carritos abandonados mediante nuestra integración, pero hemos creado un script personalizado que puedes agregar a tu tienda de Volusion y que te permitirá usar esta función en Klaviyo. Esto requiere cierto conocimiento para agregar código a la plantilla de la tienda, así que si tienes un desarrollador, puedes enviarle este documento para que siga los pasos para agregar el código.

1. Tendrás que agregar el fragmento de código que aparece a continuación a la página de plantillas de la tienda en el Editor de archivos de Volusion, que puedes encontrar al hacer clic en Diseño > Editor de archivos.

<script type="text/javascript">
    // Check to see if the customer is on the checkout page before executing code.
    if (window.location.pathname == "/one-page-checkout.asp") {
        var klaviyo = window.klaviyo || [];
        // Function to track when a checkout is started.
        var trackStartedCheckout = function() {
            $.post('/AjaxCart.asp', function(data) {
                if (!data || !data.Products || !data.Products.length) {
                    return;
                }
                var items = [],
                    names = [],
                    skus = [];
                // Grab each product and its SKU/Name/Quantity/Price/Total price/Image url
                $.each(data.Products, function(i, record) {
                    var item_price = +(record.ProductPrice.replace(/[\$,]+/g, '')) / record.Quantity;
                    items.push({
                        SKU: record.ProductCode,
                        Name: record.ProductName,
                        Quantity: +record.Quantity,
                        ItemPrice: item_price,
                        RowTotal: item_price * record.Quantity,
                        ImageURL: record.ImageSource
                    });
                    names.push(record.ProductName);
                    skus.push(record.ProductCode);
                });
                // Push Started Checkout metric to Klaviyo with the customers data.
                klaviyo.track("Started Checkout", {
                    $value: +(data.Totals[0].CartTotal.replace(/[\$,]+/g, "")),
                    Items: items,
                    ProductNames: names,
                    SKUs: skus
                });
            }, 'json');
        };
        $(function() {
            // Grab the email form to get your customers email and tie the event to that email in Klaviyo.
            $('[name="OnePageCheckoutForm"] [name="Email"]').change(function(e) {
                var email = $(this).val();
                // Do some light validation. Klaviyo will do more validation when the data is received.
                if (email && /@/.test(email)) {
                    klaviyo.identify({
                        $email: email
                    });
                    trackStartedCheckout();
                }
            });
        });
} </script>

1. Este código solo podrá rastrear eventos de pago en adelante; no podrás completar de forma retroactiva los flujo de carrito abandonado dentro de Klaviyo.
2. Después de guardar este código en la tienda, Klaviyo comenzará automáticamente el seguimiento de una métrica de Started Checkout desde la cual puedes activar un flujo de carrito abandonado.

Monitorea la sincronización de Klaviyo

1. Una vez integrado con Volusion, Klaviyo necesitará tiempo para sincronizar tus datos antes de que estén listos para usarse. Puedes revisar el estado de esta sincronización si regresas a la pestaña Integraciones y buscas la integración de Volusion en la lista de Integraciones habilitadas.
2. Si hay un contorno gris, esto significa que las integraciones aún se están sincronizando. Cuanto más grande sea tu tienda, más tiempo puede tardar una sincronización. Cuando tus integraciones se muestren con un borde verde, todo estará listo.
3. Klaviyo importa todos tus datos históricos de Volusion cuando habilitas por primera vez la integración. Para verificarlo, puedes comparar la cantidad de pedidos de un día en particular con lo que aparece en la interfaz de Volusion y confirmar que coincidan. Por ejemplo, al explorar la métrica Placed Order (en Analytics > Métrica en Klaviyo), puedes pasar el cursor sobre el punto de datos de ayer o ver la tabla de datos debajo de la gráfica para saber cuántos pedidos se reportaron ayer.
4. Compara ese número con lo que está almacenado en Volusion de 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 de Volusion.
5. Para comprobar o actualizar la zona horaria de tu cuenta:
   • 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.

Datos sincronizados desde Volusion

Ve a Analytics > Métrics para encontrar todas las métricas en tu cuenta. Las métricas con un ícono de Volusion se sincronizan desde tus integraciones de Volusion. Las métricas y las propiedades del perfil de Volusion se sincronizan en el plazo de una hora después de que alguien hace un pedido.

Pedido realizado

Este evento se registra cuando un cliente completa el proceso de pago y crea un pedido en tu tienda de Volusion. El evento Pedido realizado incluye toda la información relevante sobre los artículos que alguien compró, incluidos nombres de productos, códigos de productos, imágenes e información de precios, para que puedas usar esa información en correos electrónicos de seguimiento de compra.

Producto Pedido

Este evento también se registra cuando un cliente realiza un pedido, pero se registra un evento por cada artículo del pedido. Por ejemplo, si alguien compra una playera y un par de pantalones, se registra un evento de Placed Order y dos eventos de Ordered Product: un evento para la playera y un evento para los pantalones.

El evento Producto pedido incluye información detallada sobre cada producto comprado. Esto es útil al crear segmentos de comportamiento basados en opciones de variante de producto y otra información detallada que no está disponible en el evento Placed Order. Puedes filtrar y dirigir los eventos de Producto Pedido en función de los siguientes criterios:

• Nombre
  El nombre o el título del producto en Volusion; por ejemplo, t-shirt.
• Código de producto
  El código de producto de tu producto dentro de Volusion.
• Cantidad
  La cantidad del artículo comprado en un pedido.

Datos de clientes sincronizados desde Volusion

Además de las métricas anteriores que Klaviyo sincroniza desde Volusion, también hay propiedades del 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 Volusion:

• Correo electrónico
• Nombre
• Apellido
• Ciudad
• Estado/región
• Código postal
• País
• Número de teléfono
• Fuente (Klaviyo hará seguimiento de los clientes de Volusion con una propiedad Fuente en su perfil configurada como "Volusion")

Guía de solución de problemas

Los datos de pedidos realizados de Volusion no se están elaborando informes en Klaviyo

Esto podría ser un problema con la configuración de la interfaz de programación de aplicaciones (API) de Volusion que permite exportar datos.

1. Para corregirlo, ve a la pestaña Inventory del panel de administración de Volusion. Selecciona Importar/Exportar en el menú desplegable.
   

2. Haz clic en API de Volusion para acceder a la página principal de la interfaz de programación de aplicaciones (API).
3. En la sección Generic, encontrarás la opción para Ejecutar la exportación de Generic/Orders de la tienda. Una vez que se ejecute la exportación, la página se actualizará.
   

4. Selecciona todas las columnas al hacer clic en la casilla de verificación en la columna llamada * y haz clic en Ejecutar.
   

5. Después de hacer clic en Ejecutar para exportar tus pedidos genéricos, se genera una URL de interfaz de programación de aplicaciones (API) en la parte superior de la página. Por ejemplo, la URL aparecería como: https://storename.com/net/WebService.aspx?Login=user@storename.com&EncryptedPassword=ABCDEFGHIJKLMNOPQRSTUVWXYZ123456789&EDI_Name=GenericOrder.
   

6. El valor que aparece entre "EncryptedPassword=" y "&EDI_Name=GenericOrders" (resaltado en la captura de pantalla anterior) funciona como tu clave de API. Usa esto para restablecer la configuración de integraciones desde la pestaña Integraciones del panel de Klaviyo.
7. Al finalizar, haz una prueba haciendo clic en Analítica > Métrica. Consulta la actividad reciente de la métrica Placed Order de Volusion para ver si se sincronizaron nuevos datos en Klaviyo. Si ves nuevos datos para la métrica Placed Order, ponte en contacto con nuestro equipo de soporte para ejecutar un llenado de brechas de los pedidos faltantes en Klaviyo o para obtener más ayuda.
8. Para obtener más información sobre cómo exportar datos con la interfaz de programación de aplicaciones (API) de Volusion, consulta soporte de Volusion.

Las personas ven un error de "Entrada no válida" cuando hacen clic en los enlaces de mis correos electrónicos

La función "email a seguimiento web" en Klaviyo usa el seguimiento de clics para vincular la actividad a una persona que llega a tu sitio web a través de un Klaviyo Email antes de que originalmente pudiéramos identificarla (por ejemplo, cuando hace una compra o se suscribe a tu lista de correos electrónicos).

Volusion no admite el formato de URL que usa nuestro seguimiento de clics y produce un error cuando un usuario intenta visitar tu tienda a través de uno de estos enlaces, así que esta función tendrá que desactivarse en Klaviyo para asegurarte de que los enlaces de tu correo electrónico lleven correctamente a tu tienda de Volusion.

Para corregir este problema, asegúrate de desactivar el seguimiento de correo electrónico a seguimiento web en Klaviyo, como se describe al principio de este artículo.

Cómo crear una clave de API permanente en Volusion

Normalmente, Volusion te pedirá que restablezcas tu clave de API cada 90 días cuando restableces la contraseña de tu cuenta, lo que hace que tengas que volver a configurar tu integración de Voluision en Klaviyo. Los siguientes pasos te permitirán crear una clave de API que no caduque; esto implica generar credenciales de API para una cuenta de administrador en la que nunca inicias sesión:

1. Desde el panel de administración de Volusion, ve a Clientes > Administradores y crea una nueva cuenta de administrador.
2. Ve a Inventario > Importar/Exportar y selecciona la pestaña Volusion interfaz de programación de aplicaciones (API).
3. En la sección genérica, haz clic en el enlace de Ayuda de integración de la API de Volusion.
4. Selecciona Exportar y selecciona el nuevo administrador que creaste en el menú desplegable.
5. Expande el cuadro "URL con cadena de consulta..." para encontrar tu URL permanente, inicio de sesión y contraseña cifrada (clave de API).

No inicies sesión con esta cuenta, se usará solo para el acceso a la interfaz de programación de aplicaciones (API). Iniciar sesión con esta cuenta hará que la contraseña caduque después de 90 días y tendrás que repetir estos pasos para generar una nueva clave de API permanente.

Resultado

Ya integraste Klaviyo con Volusion, agregaste el seguimiento en el sitio, revisaste los datos sincronizados y aprendiste a crear una clave de API permanente.

Recursos adicionales