Tudo que você precisa para rodar o Pangeia Metrics.

Visão geral

O que o Pangeia Metrics faz

O Pangeia Metrics coleta pageviews e eventos do seu site através de um script leve e transforma isso em métricas de produto prontas para decisão: tráfego, origem, dispositivo, funil e retenção — com autenticação via Pangeia ID e dados hospedados no Brasil.

Comece aqui

Primeiros passos

1. Entre com Pangeia IDClique em "Entrar com Pangeia ID" na home ou em /login.
2. Adicione seu domínioAbra Configurações e cadastre o domínio que você quer medir.
3. Valide a propriedadeEscolha um método: arquivo em /.well-known, meta tag na home ou registro DNS TXT.
4. Instale o scriptCole a tag de tracking no HTML do site (veja a próxima seção).
5. Acompanhe no DashboardOs dados aparecem assim que o script começa a enviar hits.

Tracking

Instalar o script

Inclua a tag abaixo no HTML do seu site, de preferência perto do fechamento do </body> ou com defer:

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

O script envia o siteId como window.location.hostname. Esse hostname precisa estar cadastrado e verificado em Configurações para os dados aparecerem no dashboard. O endpoint de coleta é sempre https://metrics.pangeialabs.com/stats por padrão, mesmo que o arquivo stats.js seja servido por outro host ou CDN.

Apontar para outro endpoint (avançado)

Só é necessário se você tiver um motivo específico para customizar o destino da coleta. Duas formas equivalentes:

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

<script>
  window.pangeiaMetricsConfig = {
    endpoint: "https://metrics.pangeialabs.com/stats"
  };
</script>
<script src="https://metrics.pangeialabs.com/js/stats.js" defer></script>

Tracking

Funil por JavaScript

O funil é registrado exclusivamente pelo script do site cliente. Depois que stats.js carregar, chame trackFunnel com o nome da etapa em qualquer momento — clique em botão, abertura de modal, envio de formulário, passo de checkout em SPA:

window.pangeiaMetrics.trackFunnel("Lead");
window.pangeiaMetrics.trackFunnel("Checkout");
window.pangeiaMetrics.trackFunnel("Compra concluída");

O texto dentro dos parênteses é exatamente o nome que aparece no gráfico de funil do dashboard. Não é preciso cadastrar etapas em Configurações — o dashboard agrupa os eventos pelo nome enviado e conta sessões distintas que dispararam cada etapa no período/filtros selecionados.

Como ler os números

Exemplo ilustrativo: 1.000 sessões dispararam Lead, 300 dispararam Checkout e 90 dispararam Compra concluída no mesmo período.

• Lead → Checkout: 30% avançaram.
• Checkout → Compra concluída: 30% avançaram.
• Conversão final do funil: 9%.

Dashboard

Como usar o dashboard

Configurações

Domínios & verificação

Em Configurações, cadastre cada domínio que você quer medir e escolha um método de validação:

Depois de publicar a evidência, clique em verificar. O domínio muda para verificado e libera acesso aos dados no dashboard — junto com todos os seus subdomínios. O mesmo domínio pode ser cadastrado por mais de uma conta; cada conta só ganha acesso quando a própria entrada for verificada. Remover um projeto desvincula o acesso da sua conta, mas não apaga os hits/estatísticas já coletados.

Configurações

Relatório diário por email

Cada domínio verificado tem um único toggle para ativar ou desativar o relatório diário. O envio usa o email da conta autenticada como destino e roda automaticamente todo dia. Cada card também permite disparar um teste manual imediato, e mostra o último estado conhecido do envio — lastSentAt, lastRecipient e, se algo falhar, lastError — direto na interface.

Plataforma

Segurança & privacidade

• Autenticação obrigatóriaDashboard, configurações e APIs de métricas exigem login via Pangeia ID.
• Sem API pública abertaCORS público existe só para o coletor (/stats) e o script (/js/stats.js). Endpoints internos rejeitam extração de terceiros.
• Dados escopados por domínioCada conta só acessa métricas de domínios que ela mesma validou e verificou.
• Webhook assinadoEventos de conta do Pangeia ID são validados por HMAC SHA-256, com idempotência por evento.
• Infraestrutura no BrasilColeta e armazenamento operam sem depender de nuvem estrangeira.

Ajuda

Perguntas frequentes