Pangeia Metrics

Manual da Plataforma

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

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 (ex.: Checkout|/checkout,/cart).
  • Relatório diário: toggle por domínio para ativar/desativar.

Exemplo de funil

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

6. Endpoints principais

GET  /api/period
GET  /api/filters
GET  /api/heatmap
GET  /api/projects
POST /api/projects
POST /api/projects/<domain>/verify
PUT  /api/projects/<domain>/funnel
PUT  /api/projects/<domain>/email-report

Exemplo de request

curl -X PUT "https://SEU-DOMINIO/api/projects/pangeialabs.com/email-report" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true}'

7. 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.