Umami Analytics: Guia Completo de Analytics Auto-Hospedado (2026)

Umami é uma plataforma de analytics web open-source focada em privacidade que fornece uma alternativa limpa ao Google Analytics. Com um script de rastreamento de menos de 2KB, conformidade GDPR nativa e propriedade total dos dados, Umami tornou-se a escolha preferida para desenvolvedores que querem insights sem a complexidade ou preocupações de privacidade das analytics tradicionais.

Por Que Umami em Vez do Google Analytics?

Google Analytics 4 (GA4) é poderoso mas vem com compensações significativas que fazem muitos desenvolvedores procurarem alternativas:

Fator	Google Analytics 4	Umami
Privacidade	Coleta PII, requer banners de consentimento	Sem cookies, sem PII, compatível com GDPR por padrão
Tamanho do script	~45KB	~2KB
Curva de aprendizado	Íngreme (completamente redesenhado do UA)	Mínima, painel intuitivo
Propriedade dos dados	Servidores do Google, termos deles	Seu servidor, seus dados
Custo	Grátis mas você é o produto	Grátis (auto-hospedado) ou $9/mês (cloud)
Bloqueadores de anúncios	Bloqueado pela maioria	Funciona com domínio auto-hospedado

Quando Escolher Umami

• Você quer simplicidade: Visualizações de página, referências, dispositivos—o essencial sem se afogar em dados
• Privacidade importa: Sem banners de cookies, sem complexidade de gestão de consentimento
• Performance importa: Script de 2KB vs 45KB tem impacto real nos Core Web Vitals
• Você quer propriedade dos dados: Auto-hospede e mantenha tudo sob seu controle
• Sites focados em desenvolvedores: Audiências técnicas geralmente bloqueiam GA de qualquer forma

Recursos do Umami v3

Umami v3 (lançado em novembro de 2025) trouxe melhorias significativas:

Analytics Básico

Métricas do painel:
├── Visitantes (únicos)
├── Visualizações de página (total)
├── Taxa de rejeição
├── Duração da sessão (média)
├── Páginas por sessão
└── Visitantes em tempo real

Fontes de tráfego:
├── Referências
├── Parâmetros UTM (fonte, meio, campanha)
├── Tráfego direto
└── Plataformas sociais

Rastreamento de Eventos

Rastreie interações personalizadas além das visualizações de página:

<!-- Usando atributos data (sem JavaScript necessário) -->
<button data-umami-event="signup-click">Cadastrar</button>

<button data-umami-event="download" data-umami-event-file="whitepaper.pdf">
  Baixar PDF
</button>

Auto-Hospedagem com Docker

A forma mais fácil de implantar Umami é com Docker Compose.

Requisitos

• Servidor com Docker e Docker Compose
• PostgreSQL 12+ (v3 removeu suporte ao MySQL)
• Domínio com SSL (use Caddy, nginx, ou túnel Cloudflare)

Configuração do Docker Compose

# docker-compose.yml
version: '3'
services:
  umami:
    image: ghcr.io/umami-software/umami:postgresql-latest
    ports:
      - "3000:3000"
    environment:
      DATABASE_URL: postgresql://umami:${POSTGRES_PASSWORD}@db:5432/umami
      DATABASE_TYPE: postgresql
      APP_SECRET: ${APP_SECRET}
    depends_on:
      db:
        condition: service_healthy
    restart: unless-stopped

  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: umami
      POSTGRES_USER: umami
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    volumes:
      - umami-db:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  umami-db:

Adicionando Rastreamento ao Seu Site

Instalação Básica

<!-- Adicione antes de fechar </head> -->
<script
  defer
  src="https://analytics.seudominio.com/script.js"
  data-website-id="seu-website-id"
></script>

Migração do Google Analytics

Mudar do GA4 para Umami é simples já que são aditivos—você pode executar ambos durante a transição.

O Que Você Vai Perder

• Dados históricos do GA (exporte antes de remover)
• Integração com Google Ads
• Modelos de atribuição avançados

O Que Você Vai Ganhar

• Site mais rápido (script menor)
• Sem necessidade de banners de consentimento
• Propriedade total dos dados
• Interface mais limpa e simples
• Dados mais precisos (menos bloqueio)

Umami fornece as analytics essenciais que a maioria dos sites realmente precisa sem a complexidade e preocupações de privacidade das soluções empresariais. Para desenvolvedores e proprietários de sites conscientes da privacidade, geralmente é a escolha certa.