Como fazer a integração com a Volusion

O que você vai aprender

Saiba como integrar o Volusion com o Klaviyo. Depois de concluir essas etapas, o senhor poderá personalizar e direcionar e-mails com base nos dados de pedidos sincronizados e nas propriedades do cliente.

A partir da Volusion, a Klaviyo rastreia as métricas Ordered Product e Placed Order; com a adição de algum código extra, podemos rastrear também as informações do Abandoned Cart.

Antes de começar

A Volusion exige uma atualização da senha da conta de administrador de sua loja Volusion a cada 90 dias. Ao fazer essa atualização na sua conta do Volusion, o senhor também deve fazer essa atualização na integração do Volusion na sua conta da Klaviyo. Também é possível criar uma chave de API permanente seguindo as etapas da seção correspondente deste artigo.

Adicionar a integração da Volusion no Klaviyo

1. Para habilitar Klaviyo's Volusion integrações, navegue até Klaviyo e clique no nome da sua conta no canto inferior esquerdo e, em seguida, selecione integrações > Add integrações.
2. Pesquise Volusion, clique no cartão e, em seguida, clique em Install (Instalar).
3. Na próxima página, insira o URL da loja, o e-mail de login e a chave/senha criptografada da API. Em seguida, clique em Connect to Volusion (Conectar à Volusion).
   
4. Na próxima página, o senhor verá uma caixa de seleção para Add new Volusion customers to a Klaviyo list (Adicionar novos clientes Volusion a uma lista Klaviyo). Se o senhor marcar essa caixa, poderá escolher uma de suas listas no Klaviyo à qual os futuros clientes serão adicionados quando fizerem um pedido.
5. Por fim, clique em Complete setup (Concluir configuração).

Desativar o rastreamento de e-mail para a Web no Klaviyo

1. O recurso "email to web tracking" da Klaviyo usa o rastreamento de cliques para identificar um usuário que chega ao seu site por meio de um e-mail da Klaviyo antes de podermos identificá-lo originalmente (como quando ele faz uma compra ou se inscreve na sua lista de e-mails).
2. O Volusion não é compatível com o formato de URL que nosso rastreamento de cliques usa e produz um erro quando um usuário tenta visitar sua loja por meio de um desses links. Portanto, esse recurso terá que ser desativado no Klaviyo para garantir que os links em seu e-mail sigam para sua loja Volusion corretamente.
3. O senhor pode desativar esse rastreamento nas configurações de sua conta em Account name (Nome da conta) > Settings (Configurações) > Email > Attribution (Atribuição).
4. A única funcionalidade perdida com a desativação desse recurso é a capacidade de rastrear um novo perfil em seu site por meio de um e-mail em que o usuário clicou. Desde que o senhor tenha a análise de rastreamento no local do Klaviyo em seu site (que adicionaremos na próxima seção), ainda poderemos rastrear os usuários assim que obtivermos o endereço de e-mail deles por meio de uma compra em sua loja ou quando eles se inscreverem em uma lista de e-mails.

Adicione rastreamento no local à sua loja Volusion

A Klaviyo fornece dois snippets de rastreamento no local para ajudá-lo a coletar informações valiosas sobre seus clientes:

• Active on Site
  Esse snippet rastreia quando seus clientes visitam seu site. Esse snippet deve ser adicionado ao site para que outros snippets, como Viewed Product, funcionem.
• Viewed Product
  Esse snippet rastreia quando seus clientes visualizam produtos específicos. O senhor pode rastrear esse evento adicionando o snippet de código Viewed Product à sua loja.

Adicionar rastreamento Active on Site

Adicione o seguinte snippet do Klaviyo.js para que ele apareça em todas as páginas do seu site. Isso habilitará o rastreamento Active on Site e os formulários do Klaviyo. Certifique-se de substituir PUBLIC_API_KEY por sua chave de API pública do Klaviyo.

<script type="application/javascript" async="" src="https://static.klaviyo.com/onsite/js/PUBLIC_API_KEY/klaviyo.js"></script>
<script type="text/javascript"> //Script para inicializar o objeto Klaviyo no carregamento da página !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 produtos visualizados

Para ativar o Viewed Product tracking, o senhor precisará adicionar o trecho de código abaixo à página de modelo da sua loja no File Editor da Volusion, que pode ser encontrado clicando em Design > File Editor.

<script type="text/javascript">
// Verificar se o cliente está na página do produto antes de executar o código.
    if ($("meta[property='og:type']").attr("content") == "product") {
        var klaviyo = window.klaviyo || [];
        // Função para rastrear quando um produto é visualizado
        var trackViewedProduct = function(item) {
            klaviyo.track("Viewed Product", item);
            klaviyo.trackViewedItem({
                "Título": item.ProductName,
               "ItemId": item.ProductID,
               "ImageUrl": item.ImageURL,
               "Url": item.URL,
               "Metadados": {
                    "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>

Adicionar lembretes de carrinho abandonado

A Volusion não oferece uma forma pronta para uso de rastrear carrinhos abandonados por meio de nossa integração, mas criamos um script personalizado que pode ser adicionado à sua loja Volusion e que permitirá que você use esse recurso no Klaviyo. Isso exigirá algum conhecimento sobre como adicionar código ao modelo da sua loja. Portanto, se o senhor tiver um desenvolvedor, poderá enviar a ele este documento para orientá-lo na adição do código.

1. O senhor precisará adicionar o trecho de código abaixo à página de modelo da sua loja no File Editor da Volusion, que pode ser encontrado clicando em Design > File Editor.

   <script type="text/javascript">
       // Verifique se o cliente está na página de checkout antes de executar o código.
       Se (window.location.pathname == "/one-page-checkout.asp") {
           var klaviyo = window.klaviyo || [];
           // Função para rastrear quando um checkout é iniciado.
           var trackStartedCheckout = function() {
               $.post('/AjaxCart.asp', function(data) {
                   if (!data || !data.Products || !data.Products.length) {
                       return;
                   }
                   var items = [],
                       names = [],
                       skus = [];
                   // Pegar cada produto e sua url SKU/Name/Quantity/Price/Total price/Image
                   $.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);
                   });
                   // Enviar a métrica Started Checkout para o Klaviyo com os dados dos clientes.
                   klaviyo.track("Started Checkout", {
                       $value: +(data.Totals[0].CartTotal.replace(/[\$,]+/g, "")),
                       Items: items,
                       ProductNames: names,
                       SKUs: skus
                   });
               }, 'json');
           };
           $(function() {
               // Pegue o formulário de e-mail para obter o e-mail dos clientes e vincule o evento a esse e-mail no Klaviyo.
               $('[name="OnePageCheckoutForm"] [name="Email"]').change(function(e) {
                   var email = $(this).val();
                   // Fazer alguma validação leve. A Klaviyo fará mais validações quando os dados forem recebidos.
                   Se (e-mail && /@/.test(e-mail)) {
                       klaviyo.identify({
                           $email: email
                       });
                       trackStartedCheckout();
                   }
               });
           });
   } 
   </script>

2. Esse código só poderá rastrear eventos de checkout daqui para frente; o senhor não poderá preencher novamente os fluxos de carrinho abandonado dentro do Klaviyo. 
3. Depois de salvar esse código em sua loja, o Klaviyo começará a rastrear automaticamente uma métrica de Checkout Iniciado, a partir da qual o senhor poderá acionar um fluxo de carrinho abandonado.

Monitorar a sincronização do Klaviyo

1. Uma vez integrado à Volusion, o Klaviyo precisará de tempo para sincronizar seus dados antes de estar pronto para ser usado. O senhor pode verificar o status dessa sincronização navegando de volta para a guia Integrations (encontrada clicando no nome da sua conta no canto inferior esquerdo) e procurando a integração do Volusion na lista de Integrações ativadas.
2. Se houver um contorno cinza, isso significa que a integração ainda está sendo sincronizada. Quanto maior for sua loja, mais tempo pode levar uma sincronização. Quando sua integração for exibida com uma borda verde, o senhor estará pronto para começar.
3. O Klaviyo importa todos os dados históricos do Volusion quando o senhor ativa a integração pela primeira vez. Para verificar isso, o senhor pode comparar o número de pedidos em um determinado dia com o que está na interface da Volusion e confirmar se eles correspondem. Por exemplo, ao explorar a métrica Placed Order (em Analytics > Metrics in Klaviyo), o senhor pode passar o mouse sobre o ponto de dados de ontem ou examinar a tabela de dados abaixo do gráfico para ver quantos pedidos foram relatados ontem.
4. Compare esse número com o que está armazenado na Volusion de ontem e o senhor verá que eles são exatamente iguais. Se isso não acontecer, o problema provavelmente é que o fuso horário da sua conta da Klaviyo não corresponde ao fuso horário da Volusion.
5. Para verificar ou atualizar o fuso horário de sua conta: 
   • Clique no nome de sua conta no canto inferior esquerdo.
   • Selecione e clique em Settings (Configurações) > Organization (Organização).
   • Role para baixo até Timezone.

Dados sincronizados da Volusion

Navegue até Analytics > Metrics para encontrar todas as métricas em sua conta. As métricas com um ícone da Volusion são sincronizadas a partir de sua integração com a Volusion. As métricas e as propriedades de perfil da Volusion são sincronizadas dentro de uma hora após a realização de um pedido.

Pedido feito

Esse evento é rastreado quando um cliente conclui o processo de checkout e cria um pedido em sua loja Volusion. O evento Placed Order inclui todas as informações relevantes sobre os itens que alguém comprou, inclusive nomes de produtos, códigos de produtos, imagens e informações de preços, para que o senhor possa usar essas informações nos e-mails de acompanhamento da 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 comprar uma camiseta e uma calça, será rastreado um evento de Pedido feito e dois eventos de Produto pedido - um evento para a camiseta e um evento para a calça.

O evento Ordered Product inclui informações detalhadas sobre cada produto comprado. Isso é útil ao criar segmentos comportamentais com base em opções de variantes de produtos e outras informações detalhadas que não estão disponíveis no evento Placed Order. O senhor pode filtrar e direcionar eventos Ordered Product com base nos seguintes critérios:

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

Dados do cliente sincronizados com a Volusion

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

• E-mail
• Primeiro nome
• Sobrenome
• Cidade
• Estado/Região
• Código Postal
• País
• Número de telefone
• Source (A Klaviyo rastreará os clientes da Volusion com uma propriedade Source em seu perfil definida como "Volusion")

Solução de problemas

Os dados do Volusion Placed Order não estão sendo reportados no Klaviyo

Isso pode ser um problema com as configurações da API da Volusion que permitem que os dados sejam exportados.

1. Para corrigir isso, navegue até a guia Inventory (Inventário ) do painel de administração da Volusion. Selecione Import/Export no menu suspenso.
   
2. Clique em Volusion API para acessar a página principal da API.
3. Na seção Generic, o senhor encontrará a opção de Executar a exportação de Generic/Orders da sua loja. Quando a exportação for executada, a página será atualizada.
   
4. Selecione todas as colunas clicando na caixa de seleção da coluna chamada * e clique em Run (Executar).
   
5. Depois de clicar em Run (Executar ) para exportar seus Generic Orders (Pedidos genéricos), um URL de API é gerado na parte superior da página. Por exemplo, o URL seria exibido 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 API Key. Use isso para restabelecer suas configurações de integração na guia Integrations (Integrações) do painel do Klaviyo. 
7. Após a conclusão, teste clicando em Analytics > Metrics. Veja a atividade recente da métrica Volusion Placed Order para ver se algum dado novo foi sincronizado no Klaviyo. Se o senhor vir novos dados para a métrica Placed Order, entre em contato com nossa equipe de suporte para executar um preenchimento de lacunas para pedidos ausentes no Klaviyo ou para obter mais assistência.
8. Para obter informações adicionais sobre como exportar dados usando a API da Volusion, consulte o suporte da Volusion.

As pessoas veem um erro "Invalid Input" quando clicam nos links do meu e-mail

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

O Volusion não é compatível com o formato de URL que nosso rastreamento de cliques usa e produz um erro quando um usuário tenta visitar sua loja por meio de um desses links. Portanto, esse recurso terá que ser desativado no Klaviyo para garantir que os links em seu e-mail sigam para sua loja Volusion corretamente.

Para corrigir esse problema, certifique-se de desativar o rastreamento de e-mail para a Web no Klaviyo, conforme descrito no início deste artigo.

Como criar uma chave de API permanente na Volusion

Normalmente, a Volusion exige que o usuário redefina sua chave de API a cada 90 dias quando redefine a senha da sua conta, o que faz com que o usuário precise reconfigurar a integração da Voluision no Klaviyo. As etapas a seguir permitirão que o senhor crie uma chave de API que não expira; isso envolveu a geração de credenciais de API para uma conta de administrador na qual o senhor nunca faz login:

1. No painel de administração da Volusion, acesse Customers (Clientes) > Administrators (Administradores ) e crie uma nova conta de administrador.
2. Navegue até Inventory > Import/Export e selecione a guia Volusion API.
3. Na seção Generic, clique no link para Volusion API Integration Help.
4. Selecione Export (Exportar ) e selecione o novo administrador que o senhor criou no menu suspenso.
5. Expanda a caixa "URL with Query String..." para encontrar seu URL permanente, login e senha criptografada (API Key).

Não faça login com essa conta, pois ela será usada apenas para acesso à API. Ao fazer login com essa conta, a senha expirará após 90 dias e o senhor precisará refazer essas etapas para gerar uma nova chave de API permanente.

Resultado

O senhor já integrou o Klaviyo à Volusion, adicionou o rastreamento no local, analisou os dados sincronizados e aprendeu a criar uma chave de API permanente.

Recursos adicionais

• Com que frequência as integrações sincronizam a referência
• Precisa de mais ajuda para se integrar ao Klaviyo? Confira as agências parceiras da Klaviyo