Como integrar com a Volusion

O que você vai aprender

Saiba como integrar o Volusion com a Klaviyo. Após concluir essas etapas, você poderá personalizar e segmentar e-mails com base em dados sincronizados de pedidos e propriedades do cliente.

Na Volusion, a Klaviyo rastreia as métricas Produto Encomendadoe Pedido Realizado; com a adição de um código extra, também podemos rastrear informações de Carrinho abandonado.

Antes de começar

A Volusion exige uma atualização da senha da conta de administrador da sua loja Volusion a cada 90 dias. Ao fazer essa atualização na sua conta da Volusion, você também precisa fazer essa atualização na integração da Volusion na sua conta da Klaviyo. Você também pode criar uma chave de API permanente seguindo as etapas na seção correspondente deste artigo.

Adicionar a integração da Volusion na Klaviyo

1. Na Klaviyo, selecione a aba Integrações.
2. Selecione Explorar aplicativos.
3. Procure por Volusion e clique no cartão. Em seguida, clique em Instalar.
4. Na próxima página, insira o URL da sua loja, o e-mail de login e a chave de API/senha criptografada. Em seguida, clique em Conectar-se à Volusion.
   

5. Na próxima página, você verá uma caixa de seleção para Adicionar novos clientes do Volusion a uma lista do Klaviyo. Se você marcar essa caixa, poderá escolher uma das suas listas no Klaviyo à qual os clientes futuros serão adicionados quando fizerem um pedido.
6. Por fim, clique em Concluir configuração.

Desative o rastreamento web de e-mails na Klaviyo

1. O recurso de "rastreamento de e-mail para rastreamento web" na Klaviyo usa o rastreamento de cliques para identificar um usuário que chega ao seu site por meio de um Klaviyo Email antes de conseguirmos identificá-lo originalmente (por exemplo, quando ele faz uma compra ou se inscreve na sua lista de e-mail).
2. A Volusion não é compatível com o formato de URL que nosso rastreamento de cliques usa e gera um erro quando alguém tenta acessar sua loja por um desses links. Por isso, esse recursos precisa ser desativado na Klaviyo para garantir que os links no seu e-mail direcionem corretamente para sua loja na Volusion.
3. Você pode desativar esse rastreamento nas configurações da sua conta em Nome da conta > Configurações > E-mail > Atribuição.
4. A única funcionalidade perdida ao desativar esse recurso é a capacidade de rastrear um novo perfil no seu site por meio de um e-mail em que ele clicou. Desde que você tenha as análises de rastreamento no site da Klaviyo no seu site (que vamos adicionar na próxima seção), ainda conseguiremos rastrear usuários assim que recebermos o endereço de e-mail deles, seja por uma compra na sua loja, seja quando eles se inscreverem em uma lista de e-mail.

Adicione rastreamento no site à sua loja Volusion

A Klaviyo oferece dois snippets de rastreamento no site para ajudar você a coletar informações valiosas sobre seus clientes:

• Com atividade no Site
  Este snippet rastreia quando seus clientes visitam seu site. Esse snippet deve ser adicionado ao site para que outros snippets, como Produto visualizado, funcionem.
• Produto visualizado
  Este snippet rastreia quando seus clientes visualizam produtos específicos. Você pode rastrear esse evento adicionando o snippet de código Produto visualizado à sua loja.

Adicionar rastreamento com atividade no site

Adicione o snippet a seguir do Klaviyo.js para que ele apareça em todas as páginas do seu site. Isso vai ativar o rastreamento Com atividade no site e os formulários do Klaviyo. Substitua PUBLIC_API_KEY pela sua chave de API pública da 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>

Adicionar rastreamento de produto visualizado

Para ativar o rastreamento de Produto visualizado, você precisará adicionar o snippet de código abaixo à página de modelo da sua loja no Editor de arquivos do Volusion, que você pode encontrar clicando em 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>

Adicione lembretes de carrinho abandonado

A Volusion não oferece uma forma pronta para rastrear carrinho abandonado por meio das nossas integrações, mas criamos um script personalizado que você pode adicionar à sua loja Volusion, o que permitirá usar esse recursos na Klaviyo. Isso exigirá algum conhecimento sobre como adicionar código ao modelo da sua loja. Portanto, se você tiver um desenvolvedor, pode enviar este documento para ele seguir o passo a passo de como adicionar o código.

1. Você precisará adicionar o snippet de código abaixo à página do modelo da sua loja no Editor de Arquivos da Volusion, que você pode encontrar clicando em Design > Editor de Arquivos.

<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 só poderá rastrear eventos de checkout daqui para frente; você não poderá preencher retroativamente os fluxos de carrinho abandonado dentro do Klaviyo.
2. Depois de salvar esse código na sua loja, a Klaviyo vai começar automaticamente a rastrear a métrica Started Checkout, a partir da qual você pode acionar um fluxo de carrinho abandonado.

Monitore a sincronização do Klaviyo

1. Depois de integrar com a Volusion, a Klaviyo precisará de um tempo para sincronizar seus dados antes que eles estejam prontos para uso. Você pode verificar o status dessa sincronização voltando para a aba Integrações e procurando sua integração da Volusion na lista de Integrações ativadas.
2. Se houver um contorno cinza, isso significa que a integração ainda está sincronizando. Quanto maior a sua loja, mais tempo uma sincronização pode levar. Quando a integração aparecer com uma borda verde, você já pode começar.
3. A Klaviyo importa todos os seus dados históricos da Volusion quando você ativa a integração pela primeira vez. Para verificar isso, você pode comparar o número de pedidos em um determinado dia com o que está na interface da Volusion e confirmar se correspondem. Por exemplo, ao explorar a métrica Placed Order (em Analytics > Metrics na Klaviyo), você pode passar o mouse sobre o ponto de dados de ontem ou ver a tabela de dados abaixo do gráfico para conferir quantos pedidos foram registrados ontem.
4. Compare esse número com o que está armazenado no Volusion desde ontem, e você verá que eles correspondem exatamente. Se não corresponderem, o problema provavelmente é que o fuso horário da sua conta do Klaviyo não corresponde ao fuso horário do Volusion.
5. Para conferir ou atualizar o fuso horário da sua conta:
   • Clique no nome da sua conta no canto inferior esquerdo.
   • Selecione e clique em Configurações > Organização.
   • Role até Fuso horário.

Dados sincronizados do Volusion

Acesse Análises > Métricas para encontrar todas as métricas na sua conta. As métricas com um ícone do Volusion são sincronizadas da sua integração do Volusion. As métricas e as Propriedades do perfil do Volusion são sincronizadas em até uma hora depois que alguém faz um pedido.

Pedido Realizado

Este evento é rastreado quando um cliente conclui o processo de checkout e cria um pedido na sua loja Volusion. O evento Placed Order inclui todas as informações relevantes sobre os itens que alguém comprou, incluindo nomes de produtos, códigos de produtos, imagens e informações de preço, para que você possa usar essas informações em e-mails de acompanhamento de compra.

Produto Encomendado

Esse evento também é rastreado quando um cliente faz um pedido, mas um evento é rastreado para cada item do pedido. Por exemplo, se alguém compra uma camiseta e uma calça, um evento Pedido feito é rastreado e dois eventos Produto pedido — um evento para a camiseta e um evento para a calça.

O evento Produto pedido inclui informações detalhadas sobre cada produto comprado. Isso é útil ao criar segmentos comportamentais com base em opções de variantes do produto e outras informações detalhadas que não estão disponíveis no evento Pedido realizado. Você pode filtrar e segmentar eventos de Pedido Realizado com base nos seguintes critérios:

• Nome
  O nome ou título do produto no Volusion, por exemplo, camiseta.
• Código do produto
  O código do produto para o seu produto na Volusion.
• Quantity
  A quantidade do item comprado em um pedido.

Dados de clientes sincronizados do Volusion

Além das métricas acima que a Klaviyo sincroniza do Volusion, também há propriedades do cliente que são adicionadas a cada perfil da Klaviyo. Você pode usar essas propriedades em segmentos e fluxos. Veja as propriedades sincronizadas automaticamente da Volusion:

• E-mail
• Nome
• Sobrenome
• Cidade
• Estado/Região
• CEP
• País
• Telefone
• Fonte (a Klaviyo vai rastrear clientes do Volusion com uma propriedade Fonte no perfil definida como "Volusion")

Solução de problemas

Os dados de pedido feito do Volusion não estão aparecendo nos relatórios no Klaviyo

Isso pode ser um problema nas suas configurações de API da Volusion que permitem que os dados sejam exportados.

1. Para corrigir isso, navegue até a guia Inventário do seu painel de administração do Volusion. Selecione Importar/Exportar no menu suspenso.
   

2. Clique em Volusion API para acessar a página principal da API.
3. Na seção Genérico, você encontrará a opção de Executar a exportação dos Genérico/Pedidos da sua loja. Depois que a exportação for executada, a página será atualizada.
   

4. Selecione todas as colunas clicando na caixa de seleção na coluna chamada * e clique em Executar.
   

5. Depois de clicar em Executar para exportar seus pedidos genéricos, um URL de API é gerado na parte superior da página. Por exemplo, o URL apareceria como: https://storename.com/net/WebService.aspx?Login=user@storename.com&EncryptedPassword=ABCDEFGHIJKLMNOPQRSTUVWXYZ123456789&EDI_Name=GenericOrder.
   

6. O valor que aparece entre "EncryptedPassword=" e "&EDI_Name=GenericOrders" (destacado na captura de tela acima) serve como sua chave de API. Use isso para restabelecer suas configurações de integrações na guia Integrações do seu painel da Klaviyo.
7. Ao concluir, teste clicando em Análises > Métricas. Veja a atividade recente da métrica Pedido feito do Volusion para conferir se algum dado novo foi sincronizado no Klaviyo. Se você vir novos dados para a métrica Pedido feito, entre em contato com nossa equipe de suporte para executar um preenchimento de lacunas para pedidos ausentes no Klaviyo ou para qualquer outra ajuda.
8. Para mais informações sobre como exportar dados usando a API da Volusion, consulte o suporte da Volusion.

As pessoas veem um erro de "Entrada inválida" ao clicar nos links do meu e-mail

O recurso de "email para rastreamento web" na Klaviyo usa rastreamento de cliques para associar a atividade a um usuário que chega ao seu site por meio de um Klaviyo Email antes de conseguirmos identificá-lo (como quando ele faz uma compra ou se inscreve na sua lista de e-mail).

A Volusion não é compatível com o formato de URL que nosso rastreamento de cliques usa e gera um erro quando alguém tenta acessar sua loja por um desses links. Por isso, esse recursos precisa ser desativado na Klaviyo para garantir que os links no seu e-mail direcionem corretamente para sua loja na Volusion.

Para corrigir esse problema, desative o rastreamento web de e-mail na Klaviyo conforme descrito no início deste artigo.

Como criar uma chave de API permanente no Volusion

Normalmente, a Volusion exigirá que você redefina sua chave de API a cada 90 dias quando você redefinir a senha da sua conta, fazendo com que você precise reconfigurar suas integrações do Voluision no Klaviyo. As etapas a seguir permitirão que você crie uma chave de API sem expiração; isso envolveu gerar credenciais de API para uma conta de administrador em que você nunca faz login:

1. No painel de administração do Volusion, vá para Customers > Administrators e crie uma nova conta de administrador.
2. Navegue até Inventário > Importar/Exportar e selecione a guia API Volusion.
3. Na seção Genérica, clique no link de Ajuda para integração da API da Volusion.
4. Selecione Exportar e selecione o novo administrador que você criou no menu suspenso.
5. Expanda a caixa "URL com string de consulta..." para encontrar seu URL permanente, login e senha criptografada (chave de API).

Não faça login com esta conta; ela será usada apenas para acesso à API. Fazer login com essa conta fará com que a senha expire após 90 dias, e você precisará repetir essas etapas para gerar uma nova chave de API permanente.

Resultado

Agora você já integrou o Klaviyo ao Volusion, adicionou o rastreamento no site, revisou seus dados sincronizados e aprendeu a criar uma chave de API permanente.

Recursos adicionais