Pangeia Metrics

Manual da Plataforma

Guia completo de uso com onboarding, tracking, dashboard e configurações.

1. O que a plataforma faz

O Pangeia Metrics coleta eventos de navegação via pixel/script e transforma em métricas de produto: tráfego, origem, comportamento, funil e retenção.

  • Escopo por domínio verificado: cada usuário só vê seus próprios projetos.
  • Filtro por projeto, país, device e browser.
  • Comparação de períodos, KPIs e gráficos de leitura rápida.

2. Primeiros passos

  1. Faça login com Pangeia ID.
  2. Abra /settings e adicione seu domínio.
  3. Valide propriedade por arquivo, meta tag ou DNS TXT.
  4. Instale o script de tracking no site.
  5. Acompanhe os dados em /dashboard.

Dica: validar o domínio raiz libera automaticamente os subdomínios.

3. Como instalar tracking

Inclua o script no HTML do seu site:

<script src="https://metrics.pangeialabs.com/js/stats.js" defer></script>

O script envia o siteId como window.location.hostname. Esse hostname precisa estar no seu escopo verificado.

Exemplo prático

Se você validou pangeialabs.com, também terá acesso a app.pangeialabs.com, funding.pangeialabs.com, etc.

4. Como ler o dashboard

  • KPI principal: acessos, usuários únicos e média por bucket.
  • KPI avançado: ativos agora, engajamento, top origem.
  • Tecnologia: distribuição por device e browser.
  • Conteúdo: top páginas e top referrers.
  • Comportamento: funil por sessões e retenção D1/D7/D30.

Use comparação de período para detectar tendência real e evitar leitura por ruído.

5. Configurações de projeto

  • Validação de domínio: garante que só o proprietário acesse métricas.
  • Funil customizado: etapas por regras de URL e por disparo JS (ex.: Checkout|/checkout,/cart,js:checkout_started).
  • Relatório diário: toggle por domínio para ativar/desativar, com envio SMTP e botão de teste manual.

Funil em linguagem simples

Pense no funil como uma fila de etapas. A cada etapa, uma parte das pessoas avanca e outra parte desiste.

  1. Interesse: entrou em paginas de descoberta (ex.: planos/precos).
  2. Checkout: iniciou a compra.
  3. Conversao: concluiu a acao final (compra/cadastro).

Com isso, voce enxerga exatamente onde esta perdendo mais gente e qual etapa precisa de ajuste.

Exemplo de funil

Interesse|/pricing,/planos
Checkout|/checkout,/carrinho,js:checkout_started
Conversao|/obrigado,/success

Para disparar uma etapa manualmente no frontend, use window.pangeiaMetrics.trackFunnel("checkout_started") apos carregar o stats.js.

Funil via JS

Use o funil via JavaScript quando a conversao nao depende de trocar de rota, como abertura de modal, clique em botao, envio de formulario AJAX ou passo interno de checkout em SPA.

Na configuracao do projeto, adicione uma regra com prefixo js: na etapa que voce quer medir.

Lead|/contato,js:lead_opened
Checkout|/checkout,js:checkout_started
Conversao|/obrigado,js:purchase_completed

No frontend, depois que o stats.js estiver carregado, dispare o evento com o mesmo nome definido na regra:

window.pangeiaMetrics.trackFunnel("checkout_started");
window.pangeiaMetrics.trackFunnel("purchase_completed");

Se preferir, tambem pode usar diretamente o nome da etapa. Exemplo: uma etapa chamada Checkout tambem sera contabilizada por window.pangeiaMetrics.trackFunnel("Checkout").

Como ler os numeros

Exemplo: 1.000 pessoas em Interesse, 300 em Checkout e 90 em Conversao.

  • Interesse → Checkout: 30% avancaram.
  • Checkout → Conversao: 30% avancaram.
  • Conversao final do funil: 9%.

Se a maior queda estiver no Checkout, normalmente o problema esta no processo de pagamento (friccao, formulario longo, erro, preco inesperado).

6. FAQ rápido

Não aparece dado no dashboard

Confira se o domínio está validado e se o script de tracking foi instalado no host correto.

Subdomínio não aparece

Valide o domínio raiz (ex.: exemplo.com) para liberar *.exemplo.com.

Filtro “todos os projetos”

Use para visão agregada. Para análise profunda, selecione um projeto específico.