Analytics. Every click, mapped in real time.

click_id (UUID), link_id, workspace_id, occurred_at (timestamp UTC), country_iso2, região, cidade, device_type (móvel/tablet/desktop), os, navegador, referrer_domain, utm_source, utm_medium, utm_campaign, utm_term, utm_content, referer (URL completa, anulável). O esquema está em /docs/api-reference sob 'Click events'. É estável; as adições são retrocompatíveis; as remoções recebem um aviso de depreciação de 90 dias.

A resolução geográfica ao nível da cidade depende da faixa de IP. NAT de nível de operadora, VPN e alguns proxies corporativos resolvem apenas para o nível de região ou país — não podemos resolver uma cidade a partir de um IP NAT compartilhado. Usamos MaxMind GeoIP2 City; a precisão é alta para IPs residenciais, mas menor para operadoras móveis e faixas de IP empresariais. Relatamos o que podemos resolver; não adivinhamos.

Se o parâmetro de consulta click_id for removido antes da conversão (checkout de várias etapas, roteador SPA, redirecionamentos que não encaminham parâmetros de consulta), o POST de conversão para o endpoint do Elido não tem nenhum clique para corresponder e a atribuição falha silenciosamente. Teste seu fluxo de checkout: clique em um link curto, verifique se o click_id aparece no POST de conversão final. Se não aparecer, adicione o encaminhamento de parâmetros de consulta no seu fluxo de checkout. Esta é a lacuna de atribuição mais comum — não o pixel, mas a perda de parâmetros de consulta na sessão de checkout.

Tipicamente inferior a 5 segundos. O caminho é: o clique atinge a borda (edge) → evento disparar-e-esquecer para o Redpanda → o consumidor click-ingester lê do Redpanda e grava no ClickHouse. O consumidor funciona continuamente com confirmação automática. Se o pipeline ficar atrasado (pico de tráfego intenso, problema de infraestrutura), o tópico do Redpanda retém eventos por 7 dias. Monitoramos o atraso do consumidor; o alerta dispara com um atraso de 60 segundos. As atualizações do dashboard em tempo real consultam a API de analytics a cada 30 segundos.

O DSN se conecta a uma visualização do ClickHouse por workspace que mostra todos os cliques para todos os links em seu workspace. Você filtra por domínio, link_id ou tag em seu SQL. Se desejar visualizações por domínio, crie-as em sua própria ferramenta de BI usando uma cláusula WHERE. Atualmente não fornecemos subusuários por domínio no ClickHouse.

Eventos de clique são coletados sem cookies. Tipo de dispositivo, OS e navegador são inferidos a partir do User-Agent. O IP é usado para resolução geográfica e depois descartado — não armazenamos IPs brutos em eventos de clique. A geolocalização ao nível da cidade é armazenada; se isso contar como dados pessoais sob sua interpretação do GDPR (localização derivada de IP), configure seu workspace para resolver a geolocalização apenas por país. A resolução apenas por país é uma configuração de workspace no plano Business.

Free: retenção de 90 dias, detalhamento por país + dispositivo, contagem de cliques por link. Pro: retenção de 12 meses, detalhamento geográfico/dispositivo/referenciador/UTM completo, mapa de calor de hora do dia, atribuição de conversão. Business: retenção de 24 meses, visualizações de coorte + retenção, DSN do ClickHouse, firehose Kafka, exportação agendada para BigQuery/Snowflake/S3.

Sim — o analytics em nível de campanha agrega todos os links marcados em uma campanha. Os rollups em nível de pasta estão disponíveis via API (soma de cliques em links em uma pasta por intervalo de datas). A visualização de campanha do dashboard mostra o total de cliques, taxa de conversão, distribuição UTM e detalhamento por link para a campanha. Ainda não há um 'dashboard de analytics de pasta' na UI — isso está no roadmap.