Analytics

O Capyshop vem com um sistema de analytics próprio pronto para uso — sem Google Analytics, sem scripts de tracking de terceiros, sem integração com gerenciador de consentimento para manter. Você tem visitantes, sessões, funis de conversão, fontes de tráfego, desempenho de produtos e insights sobre carrinhos abandonados direto na barra lateral do admin.

O Analytics fica em Analytics na barra lateral do admin, separado do Dashboard. Uma forma rápida de pensar nos dois:

Seção	Foco	Pergunta típica que responde
Dashboard	Visão operacional — pedidos, receita, estoque, cupons	"Como está hoje / este mês?"
Analytics	Comportamento do visitante e tendências de conversão — sessões, funil, etc.	"De onde vêm as vendas e por quê?"

Veja a página dedicada do Dashboard para o lado operacional.

Antes de começar

Algumas coisas importantes antes de começar a comparar números:

• Controlado por consentimento por padrão. O comportamento do visitante (page views, product views, add-to-cart, etc.) só é rastreado depois que o cliente aceita o banner de consentimento de cookies na sua loja. Compras e checkouts abandonados são sempre registrados — são eventos contratuais, não rastreamento comportamental.
• Sessões de admins são excluídas. Sessões de usuários administradores autenticados não contribuem para visitantes, sessões, page views ou qualquer outra métrica, então os dashboards refletem a atividade real dos clientes em vez de navegação ou testes internos.
• Caminhos de página são normalizados. A mesma página lógica é agrupada em um único caminho canônico — por exemplo, sem parâmetros de query usados apenas para tracking — para que os números de tráfego não se fragmentem em variantes cosméticas de URL.
• Totalmente compatível com GDPR. O Capyshop nunca armazena endereços IP brutos nem User-Agents. O tráfego de bots é detectado e filtrado antes de chegar ao banco de dados.
• A cadência de atualização é configurável. Por padrão, um job em segundo plano re-agrega as últimas 24 horas de eventos brutos a cada hora. O seu deployment pode estar ajustado de outra forma — a cadência exata da sua loja aparece logo abaixo do título "Analytics". Você sempre pode puxar os números mais recentes antes disso com o botão Refresh.
• A retenção é configurável. Por padrão, os eventos brutos são mantidos por 90 dias e os rollups diários agregados ficam armazenados para sempre, então comparações ano-a-ano continuam disponíveis. Ambos os valores podem ser ajustados por deployment.

A seção Analytics

Cada aba compartilha os mesmos controles no cabeçalho:

• Date range picker — padrão nos últimos 30 dias. Clique no seletor para escolher um preset ou um intervalo personalizado.
• Botão Refresh — executa o agregador novamente no servidor. Existe um cooldown de 10 segundos entre refreshes para que vários admins não sobrecarreguem o banco.

Aba Overview

A aba Overview mostra os cinco números mais importantes, além de um gráfico Visitors & Sessions sobre o intervalo de datas selecionado.

KPI	O que significa
Visitors	Pessoas únicas que visitaram sua loja neste intervalo de datas.
Sessions	Uma sessão é uma visita contínua. Um visitante pode ter várias sessões se voltar mais tarde.
Page Views	Total de páginas carregadas em todas as visitas.
Conversion Rate	Porcentagem de sessões que terminaram em compra. O número mais importante para a sua loja.
Bounce Rate	Porcentagem de sessões em que o visitante viu apenas uma página. Quanto menor, melhor — significa que as pessoas exploram a sua loja.

Cada KPI também exibe um delta "vs previous period" depois que você acumula histórico suficiente. As cores seguem a direção da métrica: "conversion rate up 12%" aparece em verde e "bounce rate up 12%" aparece em vermelho. Passe o mouse sobre qualquer KPI para ver um tooltip explicando como aquele número é calculado.

Aba Traffic

Três seções ajudam você a entender de onde vêm seus visitantes e o que eles olham:

• Traffic Sources — tabela segmentada por UTM source e medium (ex.: google / organic, facebook / cpc, newsletter / email). Sessões, compras e receita por fonte.
• Devices — gráfico de barras horizontal de sessões por tipo de dispositivo (mobile, desktop, tablet). Se a maior parte do seu tráfego for mobile, suas páginas de produto precisam funcionar bem em telas pequenas.
• Top Pages — quais URLs da sua loja recebem mais views, com contagem de visitantes únicos.

Dica: Para descobrir quais campanhas realmente funcionam, marque cada link de marketing que você compartilhar com parâmetros UTM. O Capyshop captura automaticamente — sem nenhuma configuração extra.

As tabelas de Traffic Sources, Top Pages, Products e Abandoned Carts usam paginação no servidor, mantendo a performance em lojas grandes — apenas as linhas que você está vendo são carregadas por vez.

Aba Products

Métricas por produto para os 50 principais por número de views:

Coluna	Significado
Product	Link de volta para a página de edição do produto para ajustes rápidos.
Views	Número de vezes que a página do produto foi aberta.
Add to Carts	Número de eventos de add-to-cart para este produto.
ATC Rate	Taxa de adição ao carrinho — com que frequência quem viu o produto adicionou ao carrinho. Útil para identificar produtos que chamam cliques mas não decisão.
Conversion Rate	Das pessoas que viram este produto, qual a porcentagem que realmente comprou.
Revenue	Receita total gerada por este produto no intervalo.

Aba Funnel

A aba Funnel mostra como os visitantes avançam pelas sete etapas da jornada de compra:

1. Visited store — primeira page view
2. Viewed product — abriu qualquer página de produto
3. Added to cart — clicou em "Add to cart"
4. Began checkout — iniciou o fluxo de checkout
5. Entered address — preencheu os dados de entrega
6. Picked shipping/payment — completou as opções de frete e pagamento
7. Completed purchase — pedido finalizado

Cada etapa que perde muita gente é uma oportunidade de melhoria. Comece pela etapa com maior perda — o gráfico de barras mais a lista de drop-off destacam as quedas grandes (vermelho quando a perda passa de 30%, âmbar entre 15–30%), então a pior etapa fica visível na hora.

Aba Abandoned Carts

Carrinhos abandonados são checkouts iniciados por um cliente mas nunca completados em 24 horas. Recuperá-los costuma ser a maior vitória rápida possível para uma loja pequena.

KPI	O que significa
Checkouts Started	Clientes que passaram do carrinho e entraram no fluxo de checkout.
Purchases	Pedidos concluídos no intervalo de datas.
Abandoned	Checkouts iniciados mas não completados em 24 horas.
Abandonment Rate	Porcentagem de checkouts iniciados que foram abandonados. Abaixo de 70% é saudável; acima de 85% indica atrito real no fluxo.
Lost Revenue	Receita estimada perdida nos carrinhos que expiraram sem conversão.

Abaixo dos KPIs, Recent abandoned carts lista cada carrinho abandonado com o cliente, quando aconteceu, quantos itens tinha e o valor. Essa é a sua lista curta para campanhas de recuperação (e-mail pessoal, retargeting, um pequeno cupom de desconto).

Privacidade e retenção de dados

O Capyshop foi construído pensando em GDPR desde o primeiro dia:

• Endereços IP brutos e User-Agents não são armazenados — apenas um tipo de dispositivo aproximado (mobile / desktop / tablet).
• O tráfego de bots é filtrado antes de chegar ao banco, então os números agregados refletem humanos reais.
• Os dados brutos de eventos são mantidos por 90 dias por padrão (configurável por deployment via ANALYTICS_RETENTION_DAYS). Os rollups diários agregados ficam para sempre, então tendências de longo prazo continuam disponíveis sem guardar dados pessoais.
• Quando uma conta de cliente é excluída, os eventos de analytics associados também são excluídos — o direito ao esquecimento é coberto pelo mesmo fluxo de admin do resto dos dados do cliente.

Se você tiver requisitos específicos de compliance (retenção mais curta, purga customizada), os padrões podem ser ajustados por deployment sem afetar os dashboards.