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: visualizações, usuários únicos e média de visualizações.
  • 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: etapas registradas diretamente no site com window.pangeiaMetrics.trackFunnel("Checkout").
  • 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: voce dispara quando a pessoa demonstra interesse.
  2. Checkout: voce dispara quando a pessoa inicia a compra.
  3. Conversao: voce dispara quando a pessoa conclui a acao final.

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

Exemplo de funil

window.pangeiaMetrics.trackFunnel("Interesse");
window.pangeiaMetrics.trackFunnel("Checkout");
window.pangeiaMetrics.trackFunnel("Conversao");

O texto dentro dos parenteses e o nome que aparece no grafico de funil do dashboard.

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.

Nao precisa configurar regras no projeto. No frontend, depois que o stats.js estiver carregado, dispare o evento com o nome desejado:

window.pangeiaMetrics.trackFunnel("Lead");
window.pangeiaMetrics.trackFunnel("Checkout");
window.pangeiaMetrics.trackFunnel("Compra concluida");

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.