Integração com Shopify

Acompanhe o desempenho da sua loja Shopify com analytics focados em privacidade. Obtenha visibilidade completa das jornadas dos clientes, desempenho de produtos e atribuição de receita.

---

Início rápido

Escolha seu método de instalação preferido:

---

Método 1: App Shopify (Recomendado)

Instalação

1. Visite o app do Zenovay na Shopify App Store
2. Clique em Add app
3. Revise as permissões e clique em Install
4. Conecte sua conta Zenovay ou crie uma nova
5. Conclua o assistente de configuração

O que é instalado

O app automaticamente:

• Adiciona o script de rastreamento ao seu tema
• Configura o rastreamento de eventos de e-commerce
• Configura o rastreamento do checkout e da página de agradecimento
• Ativa a atribuição da jornada do cliente

Atualizações

O app Shopify se atualiza automaticamente quando novos recursos são lançados. Nenhuma ação necessária.

---

Método 2: Instalação manual no tema

Passo 1: Adicionar o script de rastreamento

1. Acesse Online Store → Themes
2. Clique em Actions → Edit code
3. Abra theme.liquid (em Layout)
4. Adicione antes de </head>:

<!-- Zenovay Analytics -->
<script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>

Passo 2: Adicionar rastreamento de e-commerce

Crie um novo arquivo de snippet snippets/zenovay-ecommerce.liquid:

{% comment %}
  Zenovay eCommerce Tracking
  Include this in theme.liquid before </body>
{% endcomment %}

<script>
  window.zenovayEcommerce = window.zenovayEcommerce || {};

  {% if template contains 'product' %}
    // Rastrear visualizações de produto
    window.zenovayEcommerce.product = {
      id: '{{ product.id }}',
      name: '{{ product.title | escape }}',
      price: {{ product.price | money_without_currency | remove: ',' }},
      currency: '{{ shop.currency }}',
      category: '{{ product.type | escape }}',
      vendor: '{{ product.vendor | escape }}'
    };

    document.addEventListener('DOMContentLoaded', function() {
      if (window.zenovay) {
        window.zenovay('track', 'product_viewed', window.zenovayEcommerce.product);
      }
    });
  {% endif %}

  {% if template contains 'collection' %}
    // Rastrear visualizações de coleção
    window.zenovayEcommerce.collection = {
      id: '{{ collection.id }}',
      name: '{{ collection.title | escape }}',
      products_count: {{ collection.products_count }}
    };

    document.addEventListener('DOMContentLoaded', function() {
      if (window.zenovay) {
        window.zenovay('track', 'collection_viewed', window.zenovayEcommerce.collection);
      }
    });
  {% endif %}
</script>

Inclua o snippet em theme.liquid antes de </body>:

{% render 'zenovay-ecommerce' %}

Passo 3: Rastrear "Adicionar ao carrinho"

Adicione ao handler do botão de adicionar ao carrinho do seu tema ou crie snippets/zenovay-cart.liquid:

<script>
document.addEventListener('DOMContentLoaded', function() {
  // Ouvir eventos de adicionar ao carrinho
  document.querySelectorAll('[data-add-to-cart], .add-to-cart, form[action*="/cart/add"]').forEach(function(form) {
    form.addEventListener('submit', function(e) {
      var product = window.zenovayEcommerce?.product;
      if (product && window.zenovay) {
        window.zenovay('track', 'add_to_cart', {
          product_id: product.id,
          product_name: product.name,
          price: product.price,
          currency: '{{ shop.currency }}',
          quantity: 1
        });
      }
    });
  });
});
</script>

---

Método 3: Shopify Plus (Checkout Extensibility)

Os lojistas do Shopify Plus podem rastrear eventos de checkout usando a extensibilidade de checkout.

Rastreamento na página de agradecimento

Adicione em Settings → Checkout → Order status page → Additional scripts:

{% if first_time_accessed %}
<script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>
<script>
  document.addEventListener('DOMContentLoaded', function() {
    if (window.zenovay) {
      window.zenovay('track', 'purchase', {
        transaction_id: '{{ order.name }}',
        order_id: '{{ order.id }}',
        revenue: {{ checkout.total_price | money_without_currency | remove: ',' }},
        currency: '{{ checkout.currency }}',
        tax: {{ checkout.tax_price | money_without_currency | remove: ',' }},
        shipping: {{ checkout.shipping_price | money_without_currency | remove: ',' }},
        items: [
          {% for line_item in checkout.line_items %}
          {
            product_id: '{{ line_item.product_id }}',
            name: '{{ line_item.title | escape }}',
            price: {{ line_item.final_price | money_without_currency | remove: ',' }},
            quantity: {{ line_item.quantity }}
          }{% unless forloop.last %},{% endunless %}
          {% endfor %}
        ]
      });

      // Identificar o cliente (opcional)
      {% if checkout.email %}
      window.zenovay('identify', {
        email: '{{ checkout.email }}'
      });
      {% endif %}
    }
  });
</script>
{% endif %}

Checkout Extensibility (App Block)

Para rastreamento completo no checkout com Shopify Plus:

1. Instale o app Shopify do Zenovay
2. Acesse Settings → Checkout → Customize
3. Adicione o app block Zenovay Tracking
4. Posicione-o no fluxo de checkout

---

Eventos automáticos

O Zenovay rastreia automaticamente estes eventos do Shopify:

---

Rastreamento de eventos personalizados

Rastreie eventos adicionais específicos da sua loja:

Ações de lista de desejos

// Quando o usuário adiciona à lista de desejos
window.zenovay('track', 'wishlist_add', {
  product_id: '12345',
  product_name: 'Nome do Produto',
  price: 29.99
});

// Quando o usuário remove da lista de desejos
window.zenovay('track', 'wishlist_remove', {
  product_id: '12345'
});

Interações com produtos

// Navegação na galeria de imagens
window.zenovay('track', 'product_image_viewed', {
  product_id: '12345',
  image_index: 2
});

// Guia de tamanhos aberto
window.zenovay('track', 'size_guide_opened', {
  product_id: '12345'
});

// Seção de avaliações visualizada
window.zenovay('track', 'reviews_viewed', {
  product_id: '12345',
  reviews_count: 47
});

Eventos promocionais

// Cupom aplicado
window.zenovay('track', 'coupon_applied', {
  coupon_code: 'SAVE20',
  discount_value: 20.00
});

// Inscrição na newsletter
window.zenovay('track', 'newsletter_signup', {
  source: 'popup'
});

---

Atribuição de receita

Conecte as compras às suas fontes:

Rastreamento de UTM

O Zenovay captura automaticamente os parâmetros UTM:

https://yourstore.com/products/item?utm_source=instagram&utm_medium=paid&utm_campaign=summer_sale

Veja a receita por:

• Fonte: Google, Instagram, E-mail, etc.
• Meio: organic, paid, referral, email
• Campanha: Campanhas de marketing específicas
• Conteúdo: Variações de teste A/B

Rastreamento próprio (first-party)

Para lojas que usam bypass de bloqueadores de anúncios, use o rastreamento próprio:

// Em theme.liquid
<script defer
  data-tracking-code="YOUR_TRACKING_CODE"
  data-api-url="/api/_z/"
  src="/api/_z/script.js">
</script>

---

Análise da jornada do cliente

Rastreie o caminho completo da primeira visita à compra:

Vinculação de sessões

O Zenovay vincula automaticamente as sessões quando os clientes:

• Criam uma conta
• Concluem o checkout
• Se inscrevem na newsletter

Identificação de clientes

Identifique os clientes explicitamente para rastreamento entre dispositivos:

{% if customer %}
<script>
  document.addEventListener('DOMContentLoaded', function() {
    if (window.zenovay) {
      window.zenovay('identify', {
        email: '{{ customer.email }}',
        userId: '{{ customer.id }}',
        name: '{{ customer.name | escape }}'
      });
    }
  });
</script>
{% endif %}

---

Métricas no painel

Principais métricas disponíveis no seu painel do Zenovay:

Métricas de e-commerce

Análise de funil

Visualize seu funil de conversão:

1. Visita à loja → Visualização de produto
2. Visualização de produto → Adicionar ao carrinho
3. Adicionar ao carrinho → Checkout iniciado
4. Checkout iniciado → Compra

Identifique onde os clientes desistem e otimize essas páginas.

---

Solução de problemas

Script não carregando

Sintomas: Sem dados no painel do Zenovay

Soluções:

1. Verifique o console do navegador em busca de erros
2. Confirme que o código de rastreamento está correto
3. Certifique-se de que o script está em theme.liquid, não em um template
4. Verifique se bloqueadores de anúncios estão bloqueando (use o rastreamento próprio)

Visualizações de página duplicadas

Sintomas: A contagem de visualizações de página é o dobro do esperado

Soluções:

1. Certifique-se de que o script de rastreamento foi adicionado apenas uma vez
2. Verifique se há tanto o app quanto a instalação manual
3. Remova o rastreamento de templates individuais se já estiver em theme.liquid

Eventos de compra ausentes

Sintomas: Transações não rastreadas

Soluções:

1. Para Shopify Plus: Adicione o script aos scripts adicionais do checkout
2. Confirme que a condição first_time_accessed está sendo usada
3. Verifique se o script da página de status do pedido está sendo executado

Eventos não correspondem à receita

Sintomas: A receita rastreada não bate com a do Shopify

Soluções:

1. Certifique-se de que a conversão de moeda está correta
2. Verifique transações ausentes (timing do script)
3. Confirme que a extração de preço remove os símbolos de moeda

---

Configuração de privacidade

Integração com consentimento de cookies

Se estiver usando uma plataforma de gerenciamento de consentimento:

// Carregar o script de rastreamento após o consentimento
document.addEventListener('cookieconsent:accepted', function() {
  var s = document.createElement('script');
  s.defer = true;
  s.src = 'https://api.zenovay.com/z.js';
  s.dataset.trackingCode = 'YOUR_TRACKING_CODE';
  document.head.appendChild(s);
});

Conformidade com GDPR

O Zenovay prioriza a privacidade:

• Nenhum dado pessoal coletado sem consentimento
• Sem rastreamento entre sites
• Dados armazenados na UE (configurável)
• Respeita os cabeçalhos Do Not Track

Veja o Guia de conformidade com GDPR para configuração detalhada.

---

Desempenho

Carregamento do script

O script do Zenovay é:

• Diferido: Não bloqueia a renderização da página
• Leve: < 5KB comprimido
• Em cache: Distribuído globalmente via CDN

Impacto nos Core Web Vitals

---

Boas práticas

1. Use o app Shopify quando possível para atualizações automáticas
2. Ative o rastreamento próprio para maior precisão dos dados
3. Rastreie eventos personalizados para interações importantes
4. Configure metas de conversão para ações-chave
5. Revise os funis semanalmente para identificar oportunidades de otimização

---

Recursos relacionados

• Guia de rastreamento de e-commerce
• Funis de conversão
• Atribuição de receita
• Rastreamento próprio
• Solução de problemas

---

Precisa de ajuda? Entre em contato com [email protected] ou visite nosso Central de Ajuda.