Visão geral da análise web open source do HitKeep

O HitKeep é uma plataforma de análise que dá prioridade à privacidade, criada para equipas que querem controlar os seus dados e a forma como consultam relatórios. Podes usá-lo na cloud gerida nas regiões EU/US, ou executá-lo num único binário Go, com acesso controlado, formas claras de exportar dados e monitorização que recolhe apenas o que o dashboard precisa.

Experimenta a demonstração em direto →: explora um dashboard real com dados de exemplo, sem precisares de criar uma conta.

A maioria das opções de análise obriga-te a escolher logo à partida: usar uma plataforma de tecnologia publicitária alojada ou alojar uma stack com vários componentes.

O HitKeep simplifica essa decisão. Começa no HitKeep Cloud se quiseres lançar rapidamente um projeto-piloto em produção, ou segue o guia de instalação se estiveres a avaliar o HitKeep precisamente para controlar a infraestrutura.

Princípios fundamentais

1. Soberania dos dados

Nas instalações com alojamento próprio, os teus dados ficam no diretório de dados do HitKeep. Numa instalação com uma única equipa, isso corresponde a hitkeep.db; numa instalação com várias equipas, inclui também ficheiros DuckDB locais de cada tenant em tenants/*/hitkeep.db.

No HitKeep Cloud, os dados analíticos e os backups do espaço de trabalho ficam na região que escolheres ao criar a conta. O modelo de exportação é o mesmo: JSON, CSV, Parquet, NDJSON e XLSX estão disponíveis nas áreas do produto que os suportam, para que o teu histórico analítico continue portátil.

2. Baixo custo de infraestrutura

O HitKeep é executado num único binário Linux de cerca de 100 MB, com DuckDB e NSQ incorporados. Para conheceres a utilização de memória, consulta Factos e limites em vez de estimativas locais desatualizadas. Compara-o com uma stack típica de análise com alojamento próprio, que exige recursos dedicados para um servidor de base de dados, um broker de filas e a própria aplicação.

Executas a análise na AWS, GCP ou Hetzner? Como o HitKeep é um único processo, só tens de dimensionar uma instância. Não há um nó de base de dados separado para manter ativo, nenhuma cache gerida paga à hora nem custos de saída de dados entre serviços. Para equipas que executam a análise em infraestrutura cloud, isto reduz regularmente a despesa mensal com análise de um valor de dois dígitos para um valor de um só dígito.

3. A filosofia do “binário único”

Acreditamos que o alojamento próprio deve ser tão simples como executar um único comando.

1. Ingestão: Os pedidos chegam ao servidor HTTP em Go.
2. Buffering: Os eventos são publicados num tópico do NSQ incorporado em memória. Isto desacopla a API da velocidade de escrita na base de dados.
3. Armazenamento: Um consumidor interno escreve no DuckDB incorporado, uma base de dados OLAP de alto desempenho.

Tudo é compilado num único ficheiro: a base de dados, a fila e o servidor HTTP.

O que está incluído

Análise

• Monitorização de visualizações de página com um snippet leve e sem cookies
• Distribuição do tráfego por país, idioma, dispositivo, browser, sistema operativo e referenciador
• Uma página Overview para vários sites, destinada a operadores que gerem mais do que um site
• Gráficos do dashboard baseados em ECharts, com Today, Yesterday, 24h, 7d, 30d, outras predefinições e intervalos personalizados
• Análise de páginas no dashboard com Top Pages, Landing Pages e Exit Pages num único seletor ao nível do cartão
• Objetivos: monitorização de conversões baseadas em caminhos e eventos
• Funis: percursos de conversão em várias etapas, com análise de abandono
• Análise de comércio eletrónico: relatórios de receitas, produtos e origens inspirados no GA4
• Recomendações de oportunidades: sugestões guardadas de detetores determinísticos, com enriquecimento opcional por IA a partir de provas citadas
• Ask AI: assistente opcional da sessão do dashboard para perguntas de análise limitadas ao site, citações, pequenos gráficos e ações seguras no dashboard
• Análise de visibilidade de IA: acompanha pedidos de crawlers de IA e a correlação indicativa entre recolhas e visitas
• Análise de chatbots com IA: mede conversas com chatbots no site, transferências, citações e conversões assistidas
• Eventos automáticos: acompanha outbound_click, file_download e form_submit a partir de hk.js
• Atribuição por parâmetros UTM, recolhida automaticamente
• Campanhas QR: cria redirecionamentos QR dinâmicos para campanhas impressas e offline, adiciona parâmetros UTM ou personalizados, exporta o grafismo e compara aberturas dos códigos QR com visualizações de página monitorizadas
• Eventos personalizados a partir do browser ou do servidor

No dashboard, o cartão de páginas pode alternar entre Top Pages, Landing Pages e Exit Pages, para veres onde começam e terminam as sessões sem saíres da vista principal. O cartão de audiência pode alternar entre Countries e Languages, permitindo mudar entre distribuições geográficas e linguísticas sem acrescentar ruído ao mesmo ecrã.

Se os sistemas de IA estão a tornar-se parte da forma como as pessoas descobrem o teu conteúdo ou interagem com o teu produto, o HitKeep também trata esses dados como uma área de análise própria: as recolhas dos crawlers, as visitas posteriores com referência de IA e a utilização de chatbots no site mantêm-se deliberadamente separadas, para que descoberta, aquisição e desempenho dos assistentes não se confundam numa única métrica genérica.

Privacidade e conformidade

• Sem cookies por predefinição, embora ainda seja necessário avaliar as implicações do armazenamento no dispositivo ao abrigo da PECR / ePrivacy, porque o tracker público usa sessionStorage apenas para o ID de sessão opaco e o carimbo de data e hora
• Respeita os cabeçalhos Do Not Track (DNT)
• Dados com alojamento próprio guardados localmente no diretório de dados do HitKeep; dados analíticos e backups dos espaços de trabalho cloud guardados na região de alojamento escolhida
• Retenção de dados configurável por site
• Exportação de dados em JSON, CSV, Parquet, NDJSON ou XLSX, onde suportado (artigo 20.º do RGPD)
• Visão geral da conformidade para uma perspetiva adaptada a cada implantação

Segurança

• Autenticação de dois fatores: TOTP (aplicações de autenticação) e Passkeys (WebAuthn / chaves de hardware)
• Cookies JWT HTTP-only, com validade configurável
• Limites de pedidos rigorosos nos endpoints de autenticação, API e ingestão
• Exclusões de IP para filtrar o teu próprio tráfego e bots conhecidos
• Filtragem de bots e spam para spam de referenciadores listado pelo Matomo e redes abusivas listadas pelo Spamhaus

Controlo de acesso

• Funções ao nível da instância (Owner, Admin, Member)
• Permissões por site (Owner, Admin, Editor, Viewer)
• Clientes de API com tokens bearer para acesso programático
• Servidor MCP opcional para ferramentas de documentação e análise agregada apenas de leitura, através de tokens de clientes de API com âmbito definido
• Ask AI opcional para sessões de utilizadores no dashboard. É independente do MCP e não aceita tokens bearer de clientes de API.
• Dashboards partilháveis apenas de leitura para outras partes interessadas

Operações

• Relatórios por email: resumos programados e relatórios por site
• System Status and Settings: estado da execução, armazenamento, estado da cache, backups, atualização da base de dados de spam, testes de correio e registos de auditoria da instância
• Clustering com vários nós através de Memberlist (protocolo gossip)
• Sondas de integridade e prontidão para orquestradores
• Documentação OpenAPI incorporada em /api/docs/v1
• Integração oficial com WordPress que instala o tracker normal e disponibiliza controlos de eventos automáticos

Eficiência de custos

• Binário Linux de lançamento com cerca de 100 MB; a utilização de memória é descrita em Factos e limites
• Um único processo significa uma só instância para dimensionar, monitorizar e pagar
• Sem saída de dados entre serviços, nó de base de dados gerido ou réplicas em espera
• Funciona confortavelmente num VPS de $6 por mês em implantações com vários sites

Localização

• Interface do dashboard totalmente traduzida em inglês, alemão, espanhol, francês, italiano, neerlandês e português
• Preferência de idioma guardada no servidor e sincronizada entre dispositivos
• Mudança imediata de idioma, sem recarregar a página
• Contribuições da comunidade são bem-vindas: adiciona o teu idioma

Próximos passos

• Começa com o HitKeep Cloud
• Escolhe um caso de utilização
• Instala o HitKeep na tua infraestrutura
• Eventos automáticos
• Campanhas QR
• Assistente de análise Ask AI
• Servidor MCP oficial
• Referência de configuração
• Referência da API REST: inclui endpoints exclusivos da cloud identificados como tal em /api/cloud/*

Sobre o autor

O HitKeep é criado e mantido por Pascale Beier.

• Site: pascalebeier.de
• Email: mail@pascalebeier.de
• Perfis do HitKeep: LinkedIn, X, Bluesky

Podes entrar em contacto para consultoria, suporte ou simplesmente para dizer olá.