Configuração de análises de e-commerce

Configure análises para sua loja de e-commerce com eventos de produtos personalizados, atribuição de receita e funis de conversão.

Visão geral das análises de e-commerce

Ao adicionar o script de rastreamento do Zenovay e enviar alguns eventos personalizados da sua loja, você pode analisar:

O que você rastreia	Como
Visualizações de página e sessões	Automático após a instalação do script
Visualizações de produtos, ações do carrinho	Eventos personalizados via zenovay('track', ...)
Receita e pedidos	Um provedor de pagamento conectado (Stripe, PayPal ou Paddle) ou zenovay('revenue', ...)
Funis de conversão	A aba Journeys ou zenovay('defineFunnel', ...)
Jornada do cliente	Caminho para compra na aba Journeys

Não há um "modo de e-commerce" separado para ativar. Você instala o script de rastreamento padrão e então envia eventos de loja com a API JavaScript.

Configuração específica da plataforma

Shopify

Instale o script de rastreamento em seu tema e então envie eventos de loja.

1. No seu admin do Shopify, vá para Online Store → Themes
2. Em seu tema ativo, clique em Actions → Edit code
3. Abra Layout/theme.liquid
4. Cole o script de rastreamento logo antes da tag de fechamento </head>:

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

Para enviar eventos de produto e pedido, adicione um pequeno script após que se integre aos modelos de produto e checkout do seu tema e chame a API Zenovay:

// Visualização de produto (por exemplo, em um modelo de produto)
zenovay('track', 'product_viewed', {
  product_id: '{{ product.id }}',
  product_name: '{{ product.title }}',
  price: {{ product.price | divided_by: 100.0 }},
  currency: '{{ shop.currency }}'
});

// Adicionar ao carrinho (conecte ao seu manipulador de adicionar ao carrinho)
zenovay('track', 'add_to_cart', {
  product_id: variantId,
  quantity: 1,
  price: price
});

// Compra (na página de confirmação de pedido/obrigado)
zenovay('revenue', orderTotal, currency, {
  order_id: orderId
});

WooCommerce

Adicione o script de rastreamento e ganchos de eventos ao functions.php do seu tema (ou um plugin de snippets de código):

// Adicionar script de rastreamento Zenovay
add_action('wp_head', function() {
  ?>
  <script
    defer
    data-tracking-code="YOUR_TRACKING_CODE"
    src="https://api.zenovay.com/z.js">
  </script>
  <?php
});

// Rastrear visualizações de produtos
add_action('woocommerce_after_single_product', function() {
  global $product;
  ?>
  <script>
    zenovay('track', 'product_viewed', {
      product_id: '<?php echo $product->get_id(); ?>',
      product_name: '<?php echo esc_js($product->get_name()); ?>',
      price: <?php echo $product->get_price(); ?>,
      category: '<?php echo esc_js(wc_get_product_category_list($product->get_id())); ?>'
    });
  </script>
  <?php
});

// Rastrear compras
add_action('woocommerce_thankyou', function($order_id) {
  $order = wc_get_order($order_id);
  ?>
  <script>
    zenovay('revenue', <?php echo $order->get_total(); ?>, '<?php echo $order->get_currency(); ?>', {
      order_id: '<?php echo $order_id; ?>'
    });
  </script>
  <?php
});

BigCommerce

Adicione a Storefront → Script Manager:

<script
  data-tracking-code="YOUR_TRACKING_CODE"
  src="https://api.zenovay.com/z.js">
</script>
<script>
  // Rastreamento de produto BigCommerce
  document.addEventListener('DOMContentLoaded', function() {
    if (typeof BCData !== 'undefined' && BCData.product_attributes) {
      zenovay('track', 'product_viewed', {
        product_id: BCData.product_attributes.sku,
        product_name: BCData.product_attributes.name,
        price: BCData.product_attributes.price.without_tax.value
      });
    }
  });
</script>

Loja personalizada

Para qualquer plataforma, instale o script e chame a API do seu próprio código:

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

// Visualização de produto
function trackProductView(product) {
  zenovay('track', 'product_viewed', {
    product_id: product.id,
    product_name: product.name,
    price: product.price,
    category: product.category,
    currency: 'USD'
  });
}

// Adicionar ao carrinho
function trackAddToCart(product, quantity) {
  zenovay('track', 'add_to_cart', {
    product_id: product.id,
    product_name: product.name,
    quantity: quantity,
    price: product.price,
    cart_value: getCartTotal()
  });
}

// Remover do carrinho
function trackRemoveFromCart(product) {
  zenovay('track', 'remove_from_cart', {
    product_id: product.id,
    product_name: product.name
  });
}

// Iniciar checkout
function trackCheckoutStart(cart) {
  zenovay('track', 'checkout_started', {
    cart_value: cart.total,
    item_count: cart.items.length
  });
}

// Compra concluída — use a API de receita para que conte para atribuição
function trackPurchase(order) {
  zenovay('revenue', order.total, order.currency, {
    order_id: order.id,
    tax: order.tax,
    shipping: order.shipping
  });
}

Eventos personalizados de e-commerce

zenovay('track', name, properties) aceita qualquer nome de evento e qualquer objeto de propriedade. Os nomes abaixo são uma convenção útil, não um esquema fixo. Mantenha a consistência para que seus funis e relatórios se alinhem.

Evento sugerido	Propriedades úteis
product_viewed	product_id, product_name, price, category
add_to_cart	product_id, quantity, price, cart_value
remove_from_cart	product_id, quantity
checkout_started	cart_value, item_count
Compra	use zenovay('revenue', amount, currency, { order_id })

Propriedades do produto

{
  product_id: "SKU-123",
  product_name: "Blue T-Shirt",
  price: 29.99,
  currency: "USD",
  category: "Apparel/T-Shirts",
  variant: "Large/Blue",
  brand: "Acme",
  quantity: 1
}

Configurar funis de conversão

Os funis estão localizados na aba Journeys do painel de um site.

1. Abra o painel do seu site (Domains → selecione seu site)
2. Abra a aba Journeys e então a subaba Funnels
3. Clique em Add Funnel e defina os passos

Cada passo pode ser uma página ou um evento personalizado. Um funil de compra típico:

Passo	Evento/Página
1	Produto visualizado
2	Adicionado ao carrinho
3	Checkout iniciado
4	Compra concluída

Você também pode definir um funil no código, que o cria automaticamente na primeira vez que é visto:

zenovay('defineFunnel', 'checkout_flow', [
  { name: 'Product', event: 'product_viewed' },
  { name: 'Cart', event: 'add_to_cart' },
  { name: 'Checkout', event: 'checkout_started' }
]);

A subaba Goals na mesma aba Journeys permite que você crie objetivos de conversão individuais (por exemplo, uma compra concluída) com o botão Add Goal.

Relatórios de receita

Os relatórios de receita e atribuição estão localizados na aba Revenue do painel de um site.

Conecte um provedor de pagamento

A forma mais confiável de rastrear receita é conectar seu provedor de pagamento para que Zenovay possa vincular pedidos a sessões de visitantes.

1. Abra o painel do seu site
2. Vá para Settings → Revenue (configurações específicas do domínio)
3. Conecte Stripe, PayPal ou Paddle e salve

Se você não conseguir conectar um provedor, envie receita do cliente com zenovay('revenue', amount, currency, metadata).

O que a aba Revenue mostra

• Total Revenue: soma dos pedidos registrados
• Orders: contagem de transações
• AOV: valor médio do pedido
• Revenue by source: quais fontes de tráfego geraram receita
• Attribution: receita distribuída entre os canais na jornada do cliente

A atribuição suporta vários modelos (incluindo primeiro toque, último toque e linear). Os relatórios de receita exigem um plano Pro ou superior.

Análise do carrinho

Uma vez que você envie eventos add_to_cart e de receita de forma consistente, você pode criar funis relacionados ao carrinho e descobrir onde os compradores abandonam entre o carrinho e a compra.

// Carrinho atualizado
zenovay('track', 'cart_updated', {
  cart_value: 149.99,
  item_count: 3
});

// Carrinho visualizado
zenovay('track', 'cart_viewed', {
  cart_value: 149.99,
  item_count: 3
});

Teste sua configuração

Verificar rastreamento

1. Abra sua loja
2. Carregue o script em modo de depuração adicionando data-debug="true" à tag do script, ou execute zenovay('debug') no console do navegador
3. Execute ações:
   • Visualize um produto
   • Adicione ao carrinho
   • Inicie o checkout
   • Conclua uma compra de teste
4. Observe o console do navegador para mensagens do Zenovay
5. Confirme que a atividade aparece no seu painel do Zenovay

Compra de teste

1. Use um pagamento de teste se disponível
2. Conclua um checkout completo
3. Confirme que o pedido aparece na aba Revenue
4. Verifique se é atribuído à fonte correta

Problemas comuns

A receita não está sendo exibida

• Confirme que o evento revenue dispara na página de confirmação do pedido (ou que seu provedor de pagamento está conectado)
• Verifique que o valor é um número
• Certifique-se de que o evento dispara após o script ser carregado

Os produtos não são rastreados

• Verifique que o evento product_viewed dispara
• Verifique que product_id é consistente entre eventos
• Certifique-se de que o script está em todas as páginas de produtos

O abandono do carrinho parece errado

• Rastreie checkout_started de forma consistente
• Dispare o evento de receita apenas uma vez por pedido
• Não rastreie reembolsos como novas compras

Melhores práticas

1. Use IDs de produto consistentes

   • O mesmo ID em todos os eventos
   • SKU ou ID de banco de dados funcionam bem

2. Inclua dados de transação importantes

   • Montante e moeda
   • ID do pedido para deduplicação

3. Rastreie a jornada completa

   • Da primeira compra até a conclusão
   • Envie os eventos correspondentes em cada passo

4. Teste completamente

   • Verifique primeiro em staging
   • Teste todos os tipos de produtos
   • Confirme a precisão do funil

Próximas etapas

• Rastreamento de receita de e-commerce
• Otimização de conversão
• Análise de abandono de carrinho