Como fazer a integração com o Spree

O que você vai aprender

Saiba como integrar o Spree ao Klaviyo. Depois de concluir essas etapas, o senhor poderá personalizar e direcionar e-mails com base nas compras de cada cliente e na atividade do site. Aqui estão os dados que sincronizamos do Spree:

• Dados de vendas e pedidos, incluindo quais produtos foram comprados, imagens de produtos, detalhes de variantes e quaisquer descontos aplicados
• Informações sobre o cliente, incluindo nome e sobrenome, local e como ele encontrou sua loja
• Dados de pedidos atendidos

Adicionar a integração do Spree em Klaviyo

1. Para conectar o Spree à sua conta, navegue até o Klaviyo e clique no nome da sua conta no canto inferior esquerdo e, em seguida, selecione Integrações.
2. Clique em Add integrations (Adicionar integrações), procure oSpree e clique no cartão. Em seguida, clique em Install (Instalar).
3. Na próxima página, o senhor precisará fornecer o URL da sua loja e uma chave de API do Spree / senha criptografada. O senhor pode gerar essa chave de API no administrador do Spree navegando até Usuários, escolhendo uma conta e, em seguida, selecionando Gerar chave de API.
4. De volta ao Klaviyo, cole o URL da loja e a chave de API/senha criptografada nas caixas.
   
5. Se o senhor estiver usando uma API do Spree com versão (v1), marque a caixa correspondente.
6. Clique em Connect to Spree (Conectar ao Spree). 
7. Se o senhor quiser adicionar os clientes que optarem por receber e-mails de sua loja Spree a uma lista no Klaviyo, marque a caixa Adicionar novos clientes do Spree a uma lista do Klaviyo na próxima página. Depois de marcar essa caixa, selecione uma lista à qual os novos opt-ins serão adicionados.
8. Quando estiver pronto, clique em Complete setup (Concluir configuração). Em seguida, o senhor verá uma mensagem de sucesso indicando que a integração foi bem-sucedida.

Instalar o rastreamento no local do Klaviyo

Para instalar o rastreamento no local, que consiste em dois eventos - Ativo no site e Produto visualizado, primeiro encontre sua chave de API pública. Faça login na sua conta Klaviyo e acesse Account name > Settings > API keys. Sua chave pública tem seis caracteres. Copie essa chave com segurança para usá-la na próxima etapa. 

Há dois tipos de rastreamento no local que o senhor pode aproveitar:

• Active on 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 em seu site

"Active on Site" tracking

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

1. Para começar a rastrear a atividade Active on Site, adicione o seguinte trecho de código ao modelo principal de sua loja para que ele seja incluído em todas as páginas. O senhor deve colocar esse snippet com outros scripts de análise que usa ou logo antes da </body>tag de fechamento</body >.
2. Certifique-se 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"> 
   //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]=argumentos[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>

3. Dependendo dos tipos de modelos que o senhor usa em seu site, a sintaxe {% if user.is_logged_in %} e {{ user.email }} provavelmente é diferente. Usando a linguagem de modelo disponível, o senhor deseja verificar se a pessoa que está visualizando a página atual está conectada. Em caso afirmativo, o senhor deve enviar o e-mail e o nome, se disponíveis. Se o senhor não tiver informações de nome, remova essas duas linhas e a vírgula final após a linha de e-mail $email.
4. Esse código de rastreamento do Klaviyo permitirá que o senhor rastreie um Active no Sitemetricpara que possa ver e aproveitar os dados relacionados às visitas ao site e ao comportamento do visitante. Por meio dessa métrica, a Klaviyo rastreará a atividade no site para navegadores conhecidos.
5. Para testar se o rastreamento no local está configurado corretamente, acesse uma página em sua loja e adicione ?utm_email=email@example.com ao final do URL, substituindo email@example.com pelo seu endereço de e-mail. Depois de recarregar a página, procure seu endereço de e-mail no Klaviyo. O senhor verá que um perfil foi criado e monitorou a atividade do seu site. 

"Produto visualizado" tracking

Se quiser configurar um fluxo de abandono de navegação ou criar segmentos com base nos dados de navegação do produto, será necessário adicionar o rastreamento de eventos JavaScript para uma métrica Viewed Product.

1. No modelo da página do produto, adicione o seguinte snippet:

   <script type="text/javascript">
    var klaviyo = window.klaviyo || [];
    klaviyo.track("Viewed Produto", {
       Título: '{{ product.name }}',
       ItemId: {{ product.id }},
       Categories: {{ category in product.categories|json }}, // A lista de categorias é uma matriz de 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>

2. O snippet acima usa a sintaxe de espaço reservado {{ }}, que pode ser diferente para sua loja do Spree. A parte importante é que os campos de produto são renderizados dinamicamente com base na página de produto que o usuário está visualizando.
3. Depois que o rastreamento de produtos visual izados tiver sido configurado para o seu site, os dados de produtos visualizados deverão começar a ser preenchidos na sua conta da Klaviyo à medida que os visitantes conhecidos navegarem pelas páginas dos produtos.

Como funciona o rastreamento no local

Quando o senhor adiciona o rastreamento no local do Klaviyo ao seu site, só podemos rastrear a atividade de navegação de "navegadores conhecidos" - ou seja, navegadores que já visitaram e se envolveram pelo menos uma vez antes. Há duas maneiras principais de identificarmos um visitante do site para fins de rastreamento no local:

• Se alguém, em algum momento, clicou em um e-mail da Klaviyo para acessar seu site
• Se alguém, em algum momento, se inscreveu/optou por um formulário da Klaviyo

A Klaviyo não rastreará navegadores anônimos.

Monitorar a sincronização do Klaviyo 

Para verificar sua integração:

1. Clique no menu suspenso Analytics no Klaviyo e selecione Metrics. Aqui, o senhor pode filtrar para visualizar todas as métricas do Spree.
2. Localize o Placed Ordermetricdo Spree e clique no ícone Activity Feed. Se a sua integração tiver começado a sincronizar dados, o senhor começará a ver os eventos de Placed Order serem preenchidos aqui.
3. Sincronizaremos automaticamente todos os dados históricos dos pedidos. Para verificar isso, o senhor pode comparar o número de eventos em um determinado dia no Klaviyo com o que está na interface do Spree e confirmar se são iguais. Por exemplo, ao explorar a métrica Placed Order, 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 no Spree de ontem e o senhor verá que eles são exatamente iguais. Caso contrário, o problema provavelmente é que o fuso horário da sua conta Klaviyo não corresponde ao fuso horário definido no Spree.
5. Para verificar sua configuração de fuso horário no Klaviyo:
   • 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.
6. Quando essa sincronização histórica for concluída, o senhor verá uma borda verde clara em torno da integração com o Spree na guia Integrations (Integrações ).

Dados sincronizados do Spree

Abaixo está uma lista de métricas que o Spree sincroniza com o Klaviyo. O senhor pode visualizar todas as métricas do Spree que são sincronizadas com sua conta em Analytics > Metrics. 

Pedido feito 

Essa métrica registra um evento sempre que alguém faz um pedido e paga por ele com sucesso. Corresponde a pedidos no Spree que estão completos, o que significa que o cliente concluiu todo o processo de checkout. Com essa métrica, o senhor pode criar facilmente listas dinâmicas de pessoas com base no número de pedidos que elas fizeram ou no valor de sua vida útil. O senhor também pode criar e-mails para reengajar clientes antigos ou enviar e-mails de agradecimento a clientes que compraram pela primeira vez. O senhor pode filtrar e direcionar eventos de Placed Order com base nos seguintes critérios:

• IsDiscounted
  Se um pedido teve um desconto aplicado, por exemplo, verdadeiro ou falso.
• ItemNames
  Os nomes dos produtos comprados nesse evento.

Produto encomendado

Essa métrica é semelhante à métrica de pedidos feitos, mas um evento é registrado para cada item que alguém pede. Por exemplo, se alguém comprou uma camiseta e um par de shorts, isso apareceria no Klaviyo como um evento Placed Order e dois eventos Ordered Product, um para a camiseta e outro para o par de shorts. Essa métrica é útil para criar listas direcionadas a clientes que compraram (ou não compraram) itens específicos ou itens em categorias específicas. O senhor também pode usar a métrica Ordered Product como um acionador de fluxos para enviar e-mails sobre produtos relacionados que combinam naturalmente, mas que alguns clientes ainda não compraram.

• Categories
  As categorias às quais o produto solicitado pertence, por exemplo, Shirts (Camisas), Mens ( Homem ) ou Sale (Venda).
• Nome
  O nome do produto adquirido, por exemplo, camiseta vermelha masculina.
• ProductId
  O ID do seu produto, conforme definido em sua loja, por exemplo, 2022, 2023, 2024.
• Quantidade
  A quantidade de um produto pedido.
• SKU
  O SKU do produto, conforme definido em sua loja.
• Opção de variante: Color
  A cor do produto, se disponível, por exemplo, vermelho ou azul.
• Opção de variante: Size
  O tamanho do produto, se disponível, por exemplo, Médio ou Grande.

Pedido atendido

Essa métrica registra um evento quando o pedido de um cliente é enviado. O evento no Klaviyo inclui o número de rastreamento de todas as remessas, portanto, o senhor pode usar essa métrica como um acionador para e-mails de confirmação de remessa. Outro e-mail comum baseado na métrica de pedidos atendidos é o e-mail de avaliação do produto, em que o senhor pede aos clientes que deixem uma avaliação dos itens que compraram recentemente. O uso da métrica Fulfilled Order (Pedido atendido ) permite que o senhor cronometre esses e-mails com base no momento em que o cliente recebe o pedido, para que não tenha que se preocupar em enviar um e-mail antes que ele receba o pacote. O senhor pode filtrar e direcionar eventos de Pedidos atendidos com base nos seguintes critérios:

• IsDiscounted
  Se um pedido teve um desconto aplicado, por exemplo, verdadeiro ou falso.
• ItemNames
  Os nomes dos itens comprados nesse evento.

Início do checkout

Essa métrica registra um evento sempre que alguém inicia um checkout e insere seu endereço de e-mail. O principal uso dessa métrica é o envio de e-mails de carrinhos abandonados. Com o Klaviyo, o senhor pode configurar facilmente um fluxo de e-mail para enviar um lembrete de carrinho se alguém começou a finalizar a compra, mas não fez o pedido depois de algumas horas. O evento Started Checkout contém todas as informações sobre o carrinho de alguém, de modo que o senhor pode mostrar os produtos no carrinho, bem como as imagens desses produtos. Para usuários mais avançados, é possível configurar dois fluxos de carrinho abandonado: um para clientes de primeira viagem, que inclui um código de desconto, e outro para compradores recorrentes, que não inclui um código de desconto. O senhor pode filtrar e direcionar eventos de Checkout Iniciado com base nos seguintes critérios:

• IsDiscounted
  Se um pedido teve um desconto aplicado, por exemplo, verdadeiro ou falso.
• ItemNames
  Os nomes dos itens comprados nesse evento.

Dados do cliente

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

• E-mail
• Primeiro nome
• Sobrenome
• Cidade
• Estado/Região
• Código Postal
• País
• Número de telefone

Resultado

O senhor já integrou sua conta do Klaviyo ao Spree, instalou o rastreamento no local e analisou os dados sincronizados.

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