Fundamentos técnicos
Arquitetura, bases de dados, domínios personalizados, eventos personalizados, objetivos, funis e acesso API.
Arquitetura
Separados por design
O Eurolytics separa a ingestão de eventos do painel. O serviço de ingestão é um binário Go stateless que aceita eventos, classifica o tráfego e escreve para o ClickHouse. O painel é uma aplicação Next.js 14 que lê do ClickHouse e gere contas via PostgreSQL. Os dois não partilham dependências em runtime.
INTERNET
┌──────────────┴──────────────┐
▼ ▼
events.eurolytics.app eurolytics.app
Go + SQLite WAL Next.js + Postgres
└──────────┬──────────────────┘
▼
ClickHouse
Camada de Dados
ClickHouse para velocidade, PostgreSQL para estrutura
ClickHouse
Base de dados OLAP colunar otimizada para analytics de séries temporais
- Todos os dados de pageview e eventos
- Agregações e consultas de tendências
- Particionado por site_id para consultas rápidas
PostgreSQL
Base de dados relacional para metadados estruturados
- Contas de utilizador e autenticação
- Configurações de sites e membros de equipa
- Objetivos, funis e definições de conversão
- Definições de padrões de bots para sincronização do classificador
Rastreio
Eventos personalizados, objetivos e funis
Para além de pageviews, o Eurolytics rastreia eventos personalizados que defina — registos, compras, cliques em botões ou qualquer outra coisa. Crie Objetivos nas definições do seu site para rastrear taxas de conversão, e construa Funis (2-8 passos) para ver onde os visitantes abandonam em fluxos de múltiplas páginas.
eurolytics('signup_complete', {
plan: 'pro',
source: 'landing_page'
})
Domínios
Domínios de rastreio personalizados via CNAME
Aponte um subdomínio como analytics.yoursite.com para o nosso endpoint de ingestão via CNAME. Os pedidos são servidos a partir do seu próprio domínio, o que garante uma medição mais completa e precisa.
Configure em Definições → Domínio de Rastreio. A verificação DNS está integrada — adicione o registo CNAME e o Eurolytics confirma-o automaticamente.
API
Acesso programático
O Eurolytics disponibiliza acesso API para consultar dados analytics, gerir sites e criar objetivos programaticamente. Pode exportar dados via painel em formato JSON a qualquer momento.
Perguntas frequentes
Qual é o tamanho do script de rastreio?
Apenas 1.2KB comprimido. Isto é minúsculo pelos padrões modernos — menor do que uma miniatura de imagem. O script carrega de forma assíncrona e tem zero impacto na velocidade da sua página ou nos Core Web Vitals. Perfeito para sites de alto desempenho.
Disponibilizam uma API?
Sim. A Stats API permite consultar estatísticas agregadas, séries temporais e desagregações com uma chave API Bearer, e a API v1 pode criar sites e obter snippets de rastreio programaticamente. Há também um endpoint MCP, para que assistentes de IA possam adicionar sites, obter o código de rastreio e consultar estatísticas diretamente. Crie chaves API nas Definições.
Suportam domínios personalizados (CNAME)?
Sim, suportamos domínios de rastreio personalizados via CNAME. Aponte um subdomínio (p. ex., analytics.oseudominio.com) para events.eurolytics.app, verifique o DNS em Definições → Domínio de rastreio, e os seus snippets passam automaticamente a usar o domínio first-party para uma medição mais precisa.
Posso rastrear eventos personalizados?
Sim. Pode definir eventos personalizados (registos, compras, etc.) no painel e o nosso tracker JavaScript envia-os automaticamente. Crie Objetivos em Definições → Objetivos e o Eurolytics começará a rastrear e exibir conversões.
Que bases de dados utilizam?
ClickHouse para analytics (consultas OLAP rápidas, otimizado para séries temporais) e PostgreSQL para metadados (contas de utilizador, configurações de sites, membros de equipa). Mantivemos deliberadamente estes separados para que a ingestão possa funcionar independentemente.
Pronto para começar?
Gratuito durante a beta. Sem necessidade de cartão de crédito.
