Fingerprinting

O cside fingerprinting coleta sinais de navegador e rede de sessões reais, transforma esses sinais em um token de sessão e permite que o seu backend recupere os datapoints resultantes. Use para checagens de fraude, abuso de contas, medição de bots e inteligência de visitantes.

Como funciona

1. Adicione o script de cside fingerprinting ao seu site
2. Chame sendClientTelemetry(externalIds?) no navegador
3. Envie o token de sessão retornado ao seu backend
4. Recupere os datapoints do cside usando a Events API

externalIds é opcional. Use-o quando quiser anexar os seus próprios identificadores de conta, sessão, pedido ou usuário ao fingerprint.

Configuração recomendada

Use a configuração de DNS para usar o seu próprio domínio sempre que possível. A cside oferece isso para evitar preocupações de privacidade relacionadas a domínios de terceiros, fazer o script parecer first-party para o navegador e impedir que bloqueadores de anúncios do navegador ou bloqueios client-side interfiram no script ou afetem a precisão das detecções.

Em produção, prefira uma integração direta que carregue cedo no documento. Google Tag Manager é útil para validação rápida, mas não garante a ordem de carregamento dos scripts.

Categorias de datapoints

A Events API pode retornar:

• Identificação - visitor ID, confidence, first seen e last seen
• Navegador e dispositivo - User-Agent, sistema operacional, locale, fuso horário, plataforma, plugins, canvas, WebGL, WebGPU, áudio, armazenamento e permissões
• Rede e inteligência de IP - Endereço IP, proximidade, VPN, proxy, Tor e sinais de blocklist
• Ambiente - Modo anônimo, tampering, máquina virtual, developer tools, replay e dispositivos com alta atividade
• Bots e automação - Categoria de bot, indicadores de navegador headless e sinais de automação

A referência completa de campos fica na Events API.

Próximos passos

• Configurar fingerprinting
• Usar Cloudflare Workers
• Recuperar datapoints
• Detectar agentes de IA e bots
• Ler a referência da Events API