O que você vai aprender
- Quais campos são capturados em cada clique — país, dispositivo, navegador, referrer, tags UTM e flag de bot.
- O que nunca é armazenado: endereço IP completo, string User-Agent bruta ou cookies.
- Como um clique viaja do POP de borda pelo Redpanda até o dashboard de análise no ClickHouse.
Cada clique em um link curto da Elido gera um único evento de clique no ClickHouse. Saber o que está no evento — e o que não está — é a diferença entre dashboards rápidos e tickets de suporte frustrados.
O que registramos#
Para cada clique, armazenamos:
- Link ID — qual link curto foi clicado.
- Workspace ID — para isolamento multi-tenant em consultas.
- Timestamp — UTC, precisão de microssegundos.
- Country — derivado do IP do visitante via MaxMind GeoLite2. O IP em si não é armazenado.
- Device class — desktop / mobile / tablet, derivado do User-Agent.
- Browser family — Chrome, Firefox, Safari, etc. Sem granularidade ao nível da versão por padrão.
- Operating system family — Windows, macOS, Linux, iOS, Android.
- Referrer host —
t.co,linkedin.com, etc. Apenas o host, não o caminho. - Parâmetros UTM —
utm_source,utm_medium,utm_campaign,utm_content,utm_termse presentes no URL de destino ou anexados ao URL curto. - Bot flag — verdadeiro se o User-Agent corresponder à nossa lista de bots (Slackbot, Twitterbot, rastreadores de segurança).
O que não registramos#
- Endereço IP completo — descartado após a pesquisa geográfica.
- User-Agent string verbatim — extraímos os campos de família e descartamos a string bruta.
- Coordenadas de clique / movimento do mouse / tempo de permanência — somos um serviço de redirecionamento, não uma ferramenta de mapa de calor.
- Cookies no redirecionamento — não definimos nenhum.
O pipeline#
- O POP de borda (Hetzner FRA / OVH FRA / OVH SGP) processa o redirecionamento em menos de 20ms.
- O evento de clique é fire-and-forget no Redpanda — o redirecionamento não bloqueia por causa disso.
- O
click-ingesterconsome o tópico e insere em lotes no ClickHouse (~5s de atraso em estado estável). - A aba de análise do dashboard consulta o ClickHouse via
analytics-api.
Isso significa que um clique que você acabou de fazer não aparecerá no dashboard por alguns segundos. Se você estiver testando e não vir seu clique imediatamente, aguarde 30 segundos e atualize.
Retenção#
Os eventos de clique são retidos por 365 dias por padrão. Workspaces Pro+ podem configurar uma retenção mais curta (60 / 90 / 180 dias) para minimização de dados do GDPR. Workspaces Business podem estender a retenção para 7 anos para indústrias regulamentadas.
Após a retenção, excluímos a linha inteiramente — não existe 'soft-delete' ou arquivo agregado que ainda vincule eventos a um usuário.