Como fazer a integração com o Spree

O que você vai aprender

Saiba como integrar o Spree com a Klaviyo. Depois de concluir essas etapas, você poderá personalizar e segmentar e-mails com base nas compras e na atividade de cada cliente no site. Estes são os dados que sincronizamos do Spree:

• Dados de vendas e pedidos, incluindo quais produtos foram comprados, imagens dos produtos, detalhes das variantes e quaisquer descontos aplicados
• Informações do cliente, incluindo nome, sobrenome e localidade
• Dados de pedido atendido

Adicione a integração da Spree na Klaviyo

1. Na Klaviyo, selecione a aba Integrações.
2. Clique em Explorar aplicativos, procure por Spree e clique no cartão. Em seguida, clique em Instalar.
3. Na próxima página, você precisará fornecer o URL da sua loja e uma chave de API do Spree/senha criptografada. Você pode gerar essa chave de API no admin do Spree acessando Usuários, escolhendo uma conta e, em seguida, selecionando Gerar chave de API.
4. De volta ao Klaviyo, cole a URL da loja e a chave de API/senha criptografada nas caixas.
   

5. Se você estiver usando uma API do Spree com versão (V1), marque Estou usando uma API do Spree com versão (V1).
6. Clique em Conectar-se à Spree.

A configuração de lista abaixo adiciona clientes sincronizados a partir de pedidos e finalizações de compra do Spree sem verificar o status de aceite de recebimento de e-mails no Spree. A participação na lista não estabelece consentimento para e-mail.

1. Opcional: para adicionar clientes do Spree sincronizados a uma lista do Klaviyo, marque Adicionar novos clientes do Spree a uma lista do Klaviyo na próxima página e, em seguida, selecione a lista.
2. Quando estiver tudo pronto, clique em Concluir configuração. Em seguida, você verá uma mensagem de sucesso indicando que a integração foi concluída com sucesso.

Instalar o rastreamento no site da Klaviyo

Para instalar o rastreamento no site de Com atividade no site e Produto visualizado, primeiro encontre sua chave de API pública. Faça login na sua conta Klaviyo e vá para Nome da conta > Configurações > chaves de API. Sua chave pública tem 6 caracteres. Copie esta chave com segurança para usar na próxima etapa.

Há dois tipos de rastreamento no site que você pode aproveitar:

• Ativo no Site
  Essa métrica é rastreada sempre que um navegador identificável visita seu site
• Viewed Product
  Essa métrica é rastreada sempre que um navegador identificável visualiza uma página de produto no seu site

Rastreamento "com atividade no site"

Essa métrica é rastreada sempre que um navegador identificável visita seu site.

1. Para começar a rastrear a atividade Com atividade no site, adicione o seguinte trecho de código ao seu modelo principal da loja para que ele seja incluído em todas as páginas. Você deve colocar esse trecho junto com outros scripts de análise que usa ou logo antes da tag </body> de fechamento.
2. Não se esqueça de substituir PUBLIC_API_KEY pela chave de API pública da sua conta 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"> 
//Initialize the 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>

1. Opcional: para identificar clientes quando eles fizerem login na sua loja, adicione uma chamada klaviyo.identify() com o endereço de e-mail do cliente conectado e, se disponível, nome e sobrenome. Use a linguagem de modelo da sua loja para incluir essa chamada apenas quando o visitante estiver conectado. Veja o guia de rastreamento no site para saber mais sobre rastreamento personalizado para usuários conectados.
2. Salve e publique o modelo da sua loja. Esse código de rastreamento registra eventos com atividade no site para navegadores conhecidos, para que você possa usar dados sobre visitas ao site e o comportamento dos visitantes no Klaviyo.
3. Para testar se o rastreamento no seu site está configurado corretamente, acesse uma página da sua loja e adicione ?utm_email=email@example.com ao final do URL, substituindo email@example.com pelo seu endereço de e-mail. Se o URL já contiver um ponto de interrogação, use &utm_email=email@example.com. Recarregue a página e depois pesquise seu endereço de e-mail na Klaviyo. Abra seu perfil e procure por um evento com atividade no site.

Rastreamento de "produto visualizado"

Se você quiser configurar um fluxo de carrinho abandonado ou criar segmentos com base em dados de navegação de produtos, adicione o rastreamento de eventos JavaScript para uma métrica Viewed Product.

1. No modelo da sua página de produto, adicione o exemplo a seguir após o snippet principal de rastreamento no site. Adapte os placeholders à sua loja antes de publicar:

<script type="text/javascript">
 var klaviyo = window.klaviyo || [];
 klaviyo.track("Viewed Product", {
    Title: '{{ product.name }}',
    ItemId: {{ product.id }},
    Categories: {{ category in product.categories|json }}, // The list of categories is an array of strings.
    ImageUrl: '{{ product.image_url }}',
    Url: '{{ product.permalink }}',
    Metadata: {
    Brand: '{{ product.brand }}',
    Price: {{ product.price }},
    OnSale: {{ product.on_sale }},
    RegularPrice: {{ product.regular_price }},
    SalePrice: {{ product.sale_price }}
 }
 });
</script>

1. Substitua os placeholders {{ }} por valores renderizados dinamicamente para o produto que está sendo visualizado, usando a linguagem de modelo da sua loja. Codifique em JSON strings e matrizes dinâmicas para que aspas em nomes de produtos não quebrem o JavaScript. Remova as aspas ao redor do exemplo ao inserir valores codificados em JSON. Renderize Categories como uma matriz de strings e renderize preços e status de promoção como valores válidos de JavaScript.
2. Salve e publique seu modelo de página de produto. Para testar, identifique seu navegador usando o teste de endereço de e-mail acima e, em seguida, acesse uma página de produto e verifique se há um evento Viewed Product no seu perfil da Klaviyo. Depois de configurados, esses dados serão preenchidos à medida que visitantes conhecidos navegarem pelas suas páginas de produto.

Ao adicionar detalhes do produto a um e-mail de carrinho abandonado, use os nomes das propriedades do seu próprio evento Viewed Product. No exemplo acima, o título do produto é Title, a imagem é ImageUrl e o preço é Metadata.Price.

Como funciona o rastreamento no site

A Klaviyo usa um navegador identificado para associar a atividade no site a um perfil. Uma visita anterior, por si só, não identifica um navegador. Há 2 maneiras comuns de a Klaviyo identificar um visitante do site:

• Se alguém tiver, em algum momento, clicado em um Klaviyo Email para acessar seu site
• Se alguém, em algum momento, se inscrever através de um formulário da Klaviyo

Quando o preenchimento retroativo da atividade de visitantes anônimos estiver habilitado, a Klaviyo pode armazenar eventos no site no navegador do visitante antes da identificação e adicioná-los ao perfil dele quando ele for identificado. Para isso, é necessário que o armazenamento local do navegador esteja disponível. Saiba mais sobre preenchimento retroativo da atividade de visitantes anônimos.

Monitore a sincronização do Klaviyo

Para verificar suas integrações:

1. Abra integrações, selecione Spree e, em seguida, selecione Data. Em dados históricos, revise o progresso da sincronização. Quando a importação terminar, o card confirma que seus dados históricos foram sincronizados.
2. Clique no menu suspenso Análises no Klaviyo e selecione métrica. Aqui, você pode filtrar para ver todas as métricas do Spree.
3. Abra a métrica Placed Order do Spree e selecione a guia Feed de atividades. Se a sua integração já começou a sincronizar dados, você verá eventos de Pedido feito aqui.
4. A Klaviyo importa automaticamente os dados históricos de pedidos. Depois que a importação for concluída, selecione a aba Gráfico para Pedido realizado. Escolha um Intervalo de datas que inclua o dia que você quer verificar, defina Visualizar por como Diário e defina Medição como Total. Por exemplo, passe o mouse sobre o ponto de dados de ontem ou use a tabela abaixo do gráfico para ver quantos pedidos foram registrados ontem.
5. Compare esse número com os pedidos concluídos no Spree para o mesmo dia. Para sincronizar, os pedidos precisam ter um endereço de e-mail válido do cliente e pelo menos 1 item. Se as contagens forem diferentes, confirme que a importação histórica foi concluída, aguarde a sincronização de hora em hora e verifique se os fusos horários do Klaviyo e do Spree correspondem.
6. Para verificar a configuração de fuso horário na Klaviyo:
   • Clique no nome da sua conta no canto inferior esquerdo.
   • Selecione Configurações > Conta.
   • Role para baixo até Fuso horário.

Dados sincronizados do Spree

Abaixo está uma lista de métricas que a Spree sincroniza com a Klaviyo. Você pode visualizar todas as métricas da Spree sincronizadas com a sua conta em Análises > Métricas.

Pedido Realizado

Esta métrica registra um evento quando um pedido no Spree é concluído, ou seja, quando um cliente conclui o processo de checkout. Ela não confirma se o pagamento foi bem-sucedido. Com esta métrica, você pode criar facilmente segmentos de pessoas com base no número de pedidos que fizeram ou no valor da vida útil. Você também pode criar e-mails para reengajar clientes antigos ou enviar e-mails de agradecimento ao cliente para compradores de primeira compra. Você pode filtrar e segmentar eventos de Pedido Realizado com base nos seguintes critérios:

• IsDiscounted
  Se um pedido teve um desconto aplicado, por exemplo: true ou false.
• ItemNames
  Os nomes dos produtos comprados neste evento.

Produto Encomendado

Esta métrica é semelhante à métrica Placed Order, porém um evento é registrado para cada unidade de um item que alguém pede. Por exemplo, se alguém comprou uma camiseta e um short, isso apareceria no Klaviyo como 1 evento Placed Order e 2 eventos Ordered Product: um para a camiseta e outro para o short. Esta métrica é útil para criar segmentos que direcionam clientes que compraram (ou não compraram) itens específicos ou itens em categorias específicas. Você também pode usar a métrica Ordered Product como um acionador de fluxos para enviar e-mails sobre produtos relacionados que combinam naturalmente entre si, mas que alguns clientes ainda não compraram.

• Categories
  As categorias às quais o produto pedido pertence, por exemplo, Camisas, Masculino ou Promoção.
• Nome
  O nome do produto comprado, por exemplo, Camiseta vermelha masculina.
• ProductId
  O ID do seu produto conforme ele é definido na sua loja, por exemplo: 2022, 2023, 2024.
• Quantidade
  A quantidade representada por este evento, que é 1. Um pedido de 3 unidades do mesmo produto cria 3 eventos Ordered Product.
• SKU
  O SKU do produto conforme ele está configurado na sua loja.
• Opção de variante: Cor
  A cor do produto, se disponível, por exemplo, Vermelho ou Azul.
• Opção de variante: Tamanho
  O tamanho do produto, se disponível, por exemplo, Médio ou Grande.

Pedido Atendido

Esta métrica registra um evento quando um pedido concluído é marcado como enviado no Spree. O evento no Klaviyo inclui o número de rastreamento de qualquer remessa, então você pode usar essa métrica como um gatilho para e-mails de confirmação de envio. Outro e-mail comum baseado na métrica Pedido atendido é o e-mail de avaliação do produto, em que você pede aos clientes para deixarem uma avaliação dos itens que compraram recentemente. Usar a métrica Pedido atendido permite programar esses e-mails a partir do envio, mas não confirma a entrega. Adicione um atraso que permita tempo para a entrega antes de enviar uma solicitação de avaliação do produto. Você pode filtrar e segmentar eventos de Pedido atendido com base nos seguintes critérios:

• IsDiscounted
  Se um pedido teve um desconto aplicado, por exemplo: true ou false.
• ItemNames
  Os nomes dos itens comprados neste evento.

Checkout Iniciado

Essa métrica registra um evento para um checkout com um endereço de e-mail de cliente válido e pelo menos 1 item. O principal uso dessa métrica é enviar e-mails de carrinho abandonado. Com a Klaviyo, você pode configurar facilmente um fluxo de e-mail para enviar um lembrete de carrinho se alguém tiver começado a finalizar a compra, mas não tiver feito um pedido após algumas horas. O evento Started Checkout contém todas as informações sobre o carrinho de alguém, então você pode mostrar os produtos no carrinho dessa pessoa, assim como as imagens desses produtos. Para usuários mais avançados, você pode configurar 2 fluxos de carrinho abandonado: um para clientes de primeira compra que inclui um código de desconto e outro para compradores recorrentes que não inclui um código de desconto. Você pode filtrar e segmentar eventos de Started Checkout com base nos seguintes critérios:

• IsDiscounted
  Se um pedido teve um desconto aplicado, por exemplo: true ou false.
• ItemNames
  Os nomes dos itens no carrinho de checkout.

dados do cliente

Além das métricas que a Klaviyo sincroniza do Spree, também há propriedades do cliente que são adicionadas aos perfis da Klaviyo quando disponíveis nos dados do pedido. Você pode usar essas propriedades em segmentos e fluxos. Estas são as propriedades sincronizadas do Spree. Os detalhes de nome, local e telefone vêm do endereço de cobrança do pedido:

• E-mail
• Nome
• Sobrenome
• Cidade
• Estado/Região
• CEP
• País
• Telefone

Resultado

Agora você integrou sua conta da Klaviyo à Spree, instalou o rastreamento no site e revisou seus dados sincronizados.

Recursos adicionais