Cómo integrar Volusion

Qué aprenderás

Aprende a integrar Volusion con Klaviyo. Después de completar estos pasos, podrás personalizar y orientar los emails en función de los datos de los pedidos sincronizados y las propiedades de los clientes.

Desde Volusion, Klaviyo realiza un seguimiento de las métricas Ordered Producty Placed Order; con la incorporación de algo de código adicional, también podemos hacer un seguimiento de la información de carrito abandonado.

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 de la sección correspondiente de este artículo.

Añade 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; después, haz clic en Instalar.
4. En la página siguiente, introduce la URL de tu tienda, el email de inicio de sesión y la clave de API/contraseña cifrada. Luego, haz clic en Conectarse a Volusion.
   

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

Desactivar el seguimiento web de email en Klaviyo

1. La función de «seguimiento web de email» en Klaviyo utiliza el seguimiento de clics para identificar a una persona usuaria que llega a tu sitio web a través de un Klaviyo Email antes de que podamos identificarla originalmente (por ejemplo, cuando realiza una compra o se suscribe a tu lista de email).
2. Volusion no admite el formato de URL que utiliza nuestro seguimiento de clics y genera un error cuando alguien intenta visitar tu tienda a través de uno de estos enlaces, así que estas funciones tendrán que desactivarse en Klaviyo para asegurarte de que los enlaces de tu email redirijan correctamente a tu tienda de Volusion.
3. Puedes desactivar este seguimiento en la configuración de tu cuenta, en Nombre de la cuenta > Configuración > Email > Atribución.
4. La única funcionalidad que se pierde al desactivar esta función es la posibilidad de rastrear un nuevo perfil en tu sitio web a través de un correo electrónico en el que hayas hecho clic. Mientras tengas el seguimiento de analytics onsite de Klaviyo en tu sitio web (que añadiremos en la siguiente sección), podremos seguir rastreando a los usuarios en cuanto obtengamos su dirección de email, ya sea a través de una compra en tu tienda o cuando se suscriban a una lista de email.

Añade el seguimiento en el sitio a tu tienda de Volusion

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

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

Añadir el seguimiento de Actividad en el Sitio

Añade el siguiente fragmento de Klaviyo.js para que aparezca en todas las páginas de tu sitio web. Esto habilitará el seguimiento de Activo en el sitio y los formularios de Klaviyo. Asegúrate de sustituir PUBLIC_API_KEY por 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>

Añadir el seguimiento de «Producto Visto»

Para habilitar el seguimiento de Viewed Product, tendrás que añadir el fragmento de código que aparece a continuación a la página de plantilla de tu tienda en el Editor de archivos de Volusion, al que puedes acceder haciendo 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>

Añadir recordatorios de carrito abandonado

Volusion no proporciona una forma predeterminada de hacer un seguimiento del carrito abandonado a través de nuestras integraciones, pero hemos creado un script personalizado que puedes añadir a tu tienda de Volusion y que te permitirá usar esta funciones en Klaviyo. Esto requerirá algunos conocimientos para añadir código a la plantilla de tu tienda, así que si tienes un desarrollador, puedes enviarle este documento para guiarlo a través de la incorporación del código.

1. Tendrás que añadir el fragmento de código siguiente a la página de plantilla de tu tienda en el editor de archivos de Volusion, al que puedes acceder haciendo 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á hacer un seguimiento de los eventos de pago de ahora en adelante; no podrás rellenar retroactivamente los flujos de carrito abandonado dentro de Klaviyo.
2. Tras guardar este código en tu tienda, Klaviyo empezará automáticamente a realizar un seguimiento de la métrica Started Checkout, con la que puedes activar un flujo de carrito abandonado.

Supervisa 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 comprobar el estado de esta sincronización volviendo a la pestaña Integraciones y buscando tu integración de Volusion en la lista de Integraciones habilitadas.
2. Si hay un contorno gris, significa que la integración todavía se está sincronizando. Cuanto más grande sea tu tienda, más puede tardar una sincronización. Cuando la integración se muestre con un borde verde, ya está todo listo.
3. Klaviyo importa todos tus datos históricos de Volusion cuando habilitas la integración por primera vez. Para verificarlo, puedes comparar el número de pedidos en un día concreto con lo que aparece en la interfaz de Volusion y confirmar que coinciden. Por ejemplo, al explorar la métrica Placed Order (en Analytics > Metrics en Klaviyo), puedes pasar el ratón por encima del punto de datos de ayer o mirar la tabla de datos debajo del gráfico para ver cuántos pedidos se registraron ayer.
4. Compara ese número con lo que está almacenado en Volusion desde ayer y deberías ver que coinciden exactamente. Si no es así, lo más probable es que el huso horario de tu cuenta de Klaviyo no coincida con el huso horario de Volusion.
5. Para comprobar o actualizar la zona horaria de tu cuenta, sigue estos pasos:
   • 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.

Datos sincronizados desde Volusion

Ve a Análisis > Métricas para encontrar todas las métricas de tu cuenta. Las métricas con el icono de Volusion se sincronizan desde tu integración de Volusion. Las métricas y las propiedades de perfil de Volusion se sincronizan en el plazo de una hora desde que alguien realiza 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 Placed Order incluye toda la información relevante sobre los artículos que alguien compró, incluidos los nombres de los productos, los códigos de producto, las imágenes y la información de precios, de modo que puedas usar esa información en emails de seguimiento de compras.

Producto Pedido

Este evento también se registra cuando un cliente realiza un pedido, pero se hace un seguimiento de un evento por cada artículo del pedido. Por ejemplo, si alguien compra una camiseta y un par de pantalones, se realiza un seguimiento de un evento Pedido realizado y de dos eventos Producto pedido: un evento para la camiseta y un evento para los pantalones.

El evento Producto pedido incluye información detallada sobre cada producto comprado. Esto resulta útil a la hora de crear segmentos de comportamiento basados en las opciones de variante del producto y otra información detallada que no está disponible en el evento Pedido Realizado. Puedes filtrar y orientar los eventos de Producto Pedido en función de los siguientes criterios:

• Nombre
  El nombre o título del producto en Volusion, p. ej., camiseta.
• Código de producto
  El código de producto de tu producto en Volusion.
• Quantity
  La cantidad del artículo comprado en un pedido.

Datos del cliente sincronizados desde Volusion

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

• Email
• Nombre
• Apellidos
• City
• Estado o región
• Zip Code
• Country
• Phone Number
• Fuente (Klaviyo hará seguimiento de los clientes de Volusion con una propiedad Source en su perfil establecida como "Volusion")

Solución de problemas

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

Esto puede deberse a un problema con la configuración de la API de Volusion que permite exportar datos.

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

2. Haz clic en Volusion API para acceder a la página principal de la API.
3. En la sección Genérico, encontrarás la opción Ejecutar para exportar Genérico/Pedidos de tu tienda. Una vez ejecutada la exportación, la página se actualizará.
   

4. Selecciona todas las columnas haciendo clic en la casilla de verificación de 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 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 volver a establecer tu configuración de integraciones desde la pestaña Integraciones de tu panel de Klaviyo.
7. Al finalizar, haz la prueba haciendo clic en Analytics > Metrics. Consulta la actividad reciente de la métrica Placed Order de Volusion para ver si se han sincronizado nuevos datos en Klaviyo. Si ves nuevos datos para la métrica Placed Order, ponte en contacto con nuestro equipo de asistencia para ejecutar un relleno de vacíos de los pedidos que falten en Klaviyo o para obtener más ayuda.
8. Para obtener más información sobre la exportación de datos mediante la API de Volusion, consulta el soporte de Volusion.

La gente ve el error «Entrada no válida» al hacer clic en mis enlaces de email

La función de "email to seguimiento web" en Klaviyo usa el seguimiento de clics para vincular la actividad con un usuario que llega a tu sitio web a través de un Klaviyo Email antes de que pudiéramos identificarlo originalmente (por ejemplo, cuando realiza una compra o se suscribe a tu lista de emails).

Volusion no admite el formato de URL que utiliza nuestro seguimiento de clics y genera un error cuando alguien intenta visitar tu tienda a través de uno de estos enlaces, así que estas funciones tendrán que desactivarse en Klaviyo para asegurarte de que los enlaces de tu email redirijan correctamente a tu tienda de Volusion.

Para solucionar este problema, asegúrate de desactivar el seguimiento web de email en Klaviyo, tal 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 restablezcas la contraseña de tu cuenta, lo que hace que tengas que volver a configurar tus integraciones de Voluision en Klaviyo. Los siguientes pasos te permitirán crear una clave de API que no caduque; 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 Customers > Administrators y crea una cuenta de administrador nueva.
2. Ve a Inventario > Importar/Exportar y selecciona la pestaña API de Volusion.
3. En la sección General, haz clic en el enlace de Ayuda para la 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á únicamente para el acceso a la API. Al iniciar sesión con esta cuenta, la contraseña caducará después de 90 días y tendrás que repetir estos pasos para generar una nueva clave de API permanente.

Resultado

Ya has integrado Klaviyo con Volusion, has añadido el seguimiento en el sitio, has revisado tus datos sincronizados y has aprendido a crear una clave de API permanente.

Recursos adicionales