Device Intelligence
Use o cside Device Intelligence para identificar visitantes, coletar sinais do navegador e detectar bots, VPNs, proxies e ambientes suspeitos.
O cside Device Intelligence coleta sinais de navegador e rede de sessões reais, transforma esses sinais em um token de sessão e deixa o seu backend recuperar os datapoints resultantes. Use para checagens de fraude, abuso de contas, medição de bots e inteligência de visitantes.
Device Intelligence é ativado por domínio gerenciado. Se você não vê dados de fingerprint, confirme que o domínio tem Device Intelligence ativado no cside.
Como funciona
- Confirme que Device Intelligence está ativado para o domínio gerenciado no cside
- Carregue o script de cside Device Intelligence no seu site
- Chame
sendClientTelemetry(externalIds?)no navegador - Envie o token de sessão retornado ao seu backend
- Recupere os datapoints do cside usando a Events API e uma chave de API de Device Intelligence apenas para backend
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 usando o bootstrap de navegador tolerante a falhas. 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
Thanks for your feedback!