Como integrar com o OpenCart

O que você vai aprender

Saiba como integrar o OpenCart com a Klaviyo. Após concluir essas etapas, você poderá personalizar e segmentar e-mails com base na compra e na atividade no site de cada cliente. A integração do OpenCart sincroniza de hora em hora.

Antes de começar

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

Adicione a integração do OpenCart

O processo de adicionar as integrações do OpenCart da Klaviyo tem várias etapas e exige que você realize ações tanto no OpenCart quanto na Klaviyo.

Para começar, atualmente a Klaviyo oferece suporte ao OpenCart 1.4.x e 1.5.x. Baixe o módulo OpenCart da Klaviyo aqui: https://www.klaviyo.com/media/downloads/OpenCartKlaviyo-1.1.0.tgz.

1. Extraia o arquivo na pasta raiz da sua instalação do OpenCart.
2. Faça login na seção de administração do OpenCart e vá para a página Extensões > Módulos.
3. Instale o módulo da Klaviyo e clique em Editar no módulo da Klaviyo.
4. A última etapa da instalação do OpenCart é copiar e colar o código PHP a seguir no final do `upload/index.php`. logo antes da linha `$response->getOutput();`:

// [Klaviyo] Save customer cart if it exists.
if ($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']
    );
  }
}

1. Na Klaviyo, selecione a aba Integrações.
2. Clique em Explorar aplicativos e procure por OpenCart; em seguida, clique no cartão. Em seguida, clique em Instalar.
3. Você será levado(a) a uma página de Configurações de integrações . Na página de configurações, insira a URL do seu site OpenCart e clique em Conectar ao OpenCart.
   

4. Na próxima página, copie a chave de 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 admin do OpenCart.
   

5. Se desejar, marque a configuração Adicionar novos clientes do OpenCart a uma lista do Klaviyo e, em seguida, selecione uma lista no menu suspenso.
6. De volta à Klaviyo, clique em Concluir configuração para começar a sincronizar dados.

Instalar o rastreamento no site da Klaviyo

Para rastrear a atividade no site no OpenCart, primeiro encontre sua chave de API pública do Klaviyo: faça login na sua conta, clique no nome da sua conta no canto inferior esquerdo e navegue até Configurações > chaves de API. Sua chave pública tem seis caracteres. Há dois tipos de rastreamento no site que você pode instalar:

• 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

Adicione o rastreamento de "com atividade no site"

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

1. Adicione o seguinte trecho de código ao modelo principal da sua 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 você usa ou logo antes da tag de fechamento </body>:
   

<script type="text/javascript" async="" src="https://static.klaviyo.com/onsite/js/PUBLIC_API_KEY/klaviyo.js></script>
<script type="text/javascript"> 
//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>

1. Certifique-se de substituir PUBLIC_API_KEY pela chave de API pública da sua conta da Klaviyo.
2. Se os visitantes ou clientes puderem criar contas na sua loja, adicione o snippet a seguir diretamente 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>

1. Dependendo dos tipos de modelo que você usa no seu site, a sintaxe de {% if user.is_logged_in %} e {{ user.email }} provavelmente é diferente. Usando a linguagem de modelo disponível, verifique se a pessoa que está visualizando a página atual está conectada. Se estiver, mostre o e-mail e o nome dela, se disponível. Se você não tiver informações de nome, remova essas duas linhas e a vírgula final após a linha do e-mail $email.

Adicionar 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, você vai querer adicionar rastreamento de eventos JavaScript para uma métrica de "Produto visualizado".

1. No modelo da sua página de produto, adicione o snippet a seguir:

<script type="text/javascript">
    var klaviyo = window.klaviyo || [];
    klaviyo.track("Viewed Product", {
      Title: '{{ product.title }}',
      ItemId: {{ product.id }},
      Categories: {{ category in product.categories|json }}, // The list of categories is an array of strings. 
      ImageUrl: '{{ product.image_url }}',
      Url: '{{ product.url }}',
      Metadata: {
        Brand: '{{ product.brand }}',
        Price: {{ product.price }},
        CompareAtPrice: {{ product.compare_at_price }} // If you have a compare at price. You could also include this for a sale or special price.
      }
  });
</script>

1. O snippet acima usa a sintaxe de placeholder {{ }}, que pode ser diferente na sua loja OpenCart. A parte importante é que os campos do produto são renderizados dinamicamente com base em qual página de produto você está visualizando.
2. Depois que o rastreamento de Viewed Product tiver sido configurado no seu site, os dados de Viewed Product devem começar a ser preenchidos na sua conta da Klaviyo conforme visitantes conhecidos navegarem pelas páginas de produtos.

Como funciona o rastreamento no site

Quando você adiciona o rastreamento web da Klaviyo ao seu site, só conseguimos rastrear a atividade de navegação de "navegadores conhecidos" — ou seja, navegadores que já visitaram e com interações pelo menos uma vez antes. Há duas formas principais de identificar um visitante do site para fins de rastreamento web:

• 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

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

Monitore a sincronização do Klaviyo

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

Para verificar suas integrações:

1. Acesse a guia Métricas da sua conta, em Análises. Aqui, você pode filtrar para ver todas as métricas do OpenCart. Encontre a métrica Placed Order do OpenCart e clique no ícone do Feed de atividades. Se a sua integrações tiver começado a sincronizar dados, você começará a ver eventos de Placed Order sendo preenchidos aqui.
2. Vamos sincronizar automaticamente todos os dados históricos de pedidos. Para verificar isso, você pode comparar o número de eventos em um dia específico no Klaviyo com o que aparece na sua interface do OpenCart e confirmar se eles correspondem.
3. Por exemplo, ao explorar a métrica Placed Order, você pode passar o mouse sobre o ponto de dados de ontem ou olhar 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 desde ontem e você deve ver que eles correspondem exatamente. Se não corresponderem, é bem provável que o fuso horário da sua conta da Klaviyo não corresponda ao fuso horário configurado no 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 Configurações.
   • Acesse a aba Organização .

Dados sincronizados do OpenCart

• Dados de vendas e pedidos
  Quais produtos foram comprados, incluindo detalhes e imagens do produto.
• Informações do cliente
  Nome, sobrenome, local e grupo de clientes.
• Dados de checkout iniciado
  Usados para acionar e-mails de carrinho abandonado. Isso é ativado pelo snippet de código PHP que você adicionou durante a integração.
• Dados de pedidos atendidos
  Usados para acompanhar quando os pedidos são enviados.
• Rastreamento no site
  Quando as pessoas visitam seu site

Para acessar suas métricas do OpenCart, navegue até Análises > Métricas na Klaviyo, onde você pode filtrar por OpenCart.

Por padrão, a Klaviyo sincroniza os seguintes status para as métricas de Placed Order e Fulfilled Order:

• Pedido feito: Pendente, Processado, Em processamento, Enviado, Concluído
• Pedido atendido: Enviado, Concluído

Recursos adicionais