Como fazer a integração com o OpenCart

O que você vai aprender

Saiba como integrar o OpenCart com o Klaviyo. Depois de concluir essas etapas, o senhor poderá personalizar e direcionar e-mails com base na compra de cada cliente e na atividade do site. A integração com o OpenCart é sincronizada a cada hora.

Antes de começar 

Observe que o Klaviyo não sincroniza seu catálogo do OpenCart.

Adicionar a integração do OpenCart

O processo de adicionar a integração do OpenCart do Klaviyo é de várias etapas e requer ações no OpenCart e no Klaviyo.

Para começar, o Klaviyo atualmente suporta o OpenCart 1.4.x e 1.5.x. Faça o download do módulo Klaviyo OpenCart aqui: https://www.klaviyo.com/media/downloads/OpenCartKlaviyo-1.1.0.tgz.

1. Descompacte o arquivo na raiz da instalação do OpenCart.
2. Faça login na seção de administração do OpenCart e a cesse a página Extensions > Modules (Extensões Módulos ).
3. Instale o módulo Klaviyo e clique em Edit para o módulo Klaviyo.
4. A última coisa a fazer com a instalação do OpenCart é copiar e colar o seguinte código PHP no final do arquivo `upload/index.php`, logo antes da linha `$response->getOutput();`:

   // [Klaviyo] Salve o carrinho do cliente se ele existir.
   Se ($registry->get('cart')->hasProducts()) {
     $registry->get('load')->model('module/klaviyo');
   
     if ($registry->get('customer')->isLogged()) {
       $registry->get('model_module_klaviyo')->saveCustomerCart(
         session_id(),
         $registry->get('customer')->getId(),
         $session->data['cart']
       );
     } else if (array_key_exists('guest', $session->data)) {
       $registry->get('model_module_klaviyo')->saveGuestCart(
         session_id(),
         $session->data['guest'],
         $session->data['cart']
       );
     }
   }

5. Faça login na sua conta Klaviyo, clique no nome da sua conta no canto inferior esquerdo e selecione Integrations (Integrações).
6. Clique em Add integrations (Adicionar integrações ) e procure o OpenCart, depois clique no cartão. Em seguida, clique em Install (Instalar).
7. O senhor será levado a uma página de configurações de integração . Na página de configurações, digite o URL do seu site OpenCart e clique em Connect to OpenCart (Conectar ao OpenCart).
   
8. Na próxima página, copie a chave da API em Klaviyo OpenCart Module e cole-a nas configurações do módulo Klaviyo no OpenCart. Salve as configurações do módulo Klaviyo no administrador do OpenCart.
   
9. Se desejar, marque a configuração Add new OpenCart customers to a Klaviyo list (Adicionar novos clientes do OpenCart a uma lista do Klaviyo) e selecione uma lista no menu suspenso.
10. De volta ao Klaviyo, clique em Complete setup para iniciar a sincronização dos dados.

Instalar o rastreamento no local do Klaviyo

Para rastrear a atividade no local no OpenCart, primeiro encontre sua chave de API pública da Klaviyo fazendo login na sua conta, clicando no nome da conta no canto inferior esquerdo e navegando até Settings > API Keys. Sua chave pública tem seis caracteres. Há dois tipos de rastreamento no local que o senhor pode instalar:

• 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

Adicionar "Active on Site" tracking

Essa métrica é rastreada sempre que um navegador identificável visita seu site. Para começar a rastrear a atividade do Active on Site:

1. 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 junto com outros scripts de análise que usa ou logo antes da </body>tag de fechamento</body >:
   

   <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>
   

2. Certifique-se de substituir PUBLIC_API_KEY pela chave de API pública da sua conta Klaviyo.
3. Se os visitantes ou clientes puderem criar contas para sua loja, adicione o seguinte snippet logo abaixo do primeiro snippet:

   <script type="text/javascript">
     var klaviyo = window.klaviyo || [];
     {% if user.is_logged_in %}
     klaviyo.identify({
       $email: '{{ user.email }}',
       $first_name: '{{ user.first_name }}',
       $last_name: '{{ user.last_name }}'
       });
     {% endif %}
   </script>

4. 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.

Adicionar "Produto visualizado" rastreamento

Se quiser configurar um fluxo de abandono de navegação ou criar segmentos com base em dados de navegação de produtos, o senhor deverá 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.title }}',
         ItemId: {{ product.id }},
         Categories: {{ category in product.categories|json }}, // A lista de categorias é uma matriz de strings. 
         ImageUrl: '{{ product.image_url }}',
         Url: '{{ product.url }}',
         Metadata: {
           Brand: '{{ product.brand }}',
           Price: {{ product.price }},
           CompareAtPrice: {{ product.compare_at_price }} // Se o senhor tiver um compare at price. O senhor também pode incluir isso para uma venda ou preço especial.
         }
     });
   </script>

2. O snippet acima usa a sintaxe do espaço reservado {{ }}, que pode ser diferente para sua loja OpenCart. 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 da Web da 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 da Web:

• 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

O tempo necessário para sincronizar todos os dados históricos de clientes e pedidos de sua loja OpenCart depende do tamanho da loja. Quando essa sincronização histórica for concluída, o senhor verá uma borda verde ao redor da integração do OpenCart em Enabled Integrations (Integrações ativadas).

Para verificar sua integração:

1. Navegue até a guia Metrics (Métricas ) de sua conta, localizada em Analytics. Aqui, o senhor pode filtrar para visualizar todas as métricas do OpenCart. Encontre a métrica Placed Order do OpenCart 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.
2. 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 OpenCart e confirmar se são iguais.
3. 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 OpenCart 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 para o OpenCart.

5. Para conferir ou atualizar o fuso horário da sua conta:

   • Clique no nome da sua organização no canto inferior esquerdo.

   • Selecione Settings.
   • Vá para a guia Organização . 

Dados sincronizados do OpenCart

• Dados de vendas e pedidos
  Quais produtos foram comprados, incluindo detalhes e imagens dos produtos.
• Informações sobre o cliente
  Nome, sobrenome, local e grupo de clientes.
• Dados de checkout iniciados
  Usado para acionar e-mails de carrinho abandonado. Isso é ativado pelo trecho de código PHP que o senhor adicionou ao fazer a integração.
• Dados de pedidos atendidos
  Usado para rastrear quando os pedidos são enviados.
• Rastreamento no local
  Quando as pessoas visitam seu site

Para acessar suas métricas do OpenCart, navegue até Analytics > Metrics no Klaviyo, onde o senhor pode filtrar por OpenCart.

Por padrão, o Klaviyo sincroniza os seguintes status para as métricas de Pedido feito e Pedido atendido:

• Pedido feito: Pending, Processed, Processing, Shipped, Complete
• Pedido atendido: Enviado, concluído

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