Skip to main content
Ativar Device Intelligence
Language

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.

Novas ativações encerradas

O Device Intelligence não está disponível para novas ativações. Os times que já usam o Device Intelligence, incluindo times gratuitos, pagos, enterprise e em teste, mantêm o acesso e podem continuar gerenciando o plano e as chaves de API. Os novos times começam apenas com a segurança client-side.

Ativar Device Intelligence

Novas ativações do Device Intelligence estão encerradas. Estas etapas se aplicam a equipes que já têm acesso. Mantenha o Device Intelligence ativado em Install Device Intelligence, com pelo menos um domínio gerenciado e não suspenso. Consulte a disponibilidade e as configurações de coleta.

  • O time precisa de pelo menos um domínio gerenciado e não suspenso antes de você poder ativá-lo. O script só roda nos domínios coletores do time, então ativar um time sem domínio não coleta nada.
  • A ativação exige um reconhecimento explícito de que Device Intelligence coleta dados pessoais (PII) dos visitantes, incluindo endereço IP, localização aproximada e sinais de hardware e navegador. Você é responsável por uma base legal, pelos avisos de privacidade e por qualquer consentimento exigido pelo GDPR, pela CCPA e por outras leis aplicáveis.

Depois de ativado, todo domínio gerenciado do time pode coletar fingerprints. Não existe ativação por domínio.

Interromper a coleta

Desativar o Device Intelligence no dashboard altera a configuração da equipe; isso não remove o código do site. Para interromper a coleta no navegador, remova a inicialização do pacote ou o bootstrap de todos os pontos de implantação: aplicativo, modelos HTML, Cloudflare Worker, código personalizado do Framer ou Webflow e scripts servidos por um domínio próprio. Publique as alterações e confirme que o navegador não carrega nem envia mais telemetria do Device Intelligence.

Como funciona

  1. Ative Device Intelligence para o time no cside
  2. Instale o pacote npm ou carregue o script de cside Device Intelligence no seu site
  3. Chame sendClientTelemetry(externalIds?) no navegador
  4. Envie o token de sessão retornado ao seu backend
  5. 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. As regras embutidas e o Identity graph usam userId como chave, então passe-o quando tiver um.

Configuração recomendada

Para apps construídas com um bundler, instale @cside.dev/device-intelligence. O pacote inclui o código de coleta, então não há nenhum script remoto para carregar ou bloquear, e ele devolve um sendClientTelemetry tipado. Este é o método padrão no painel.

Quando você injeta o script no HTML, use a configuração de DNS para servi-lo a partir do 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. Carregue-o cedo no documento com o bootstrap de navegador tolerante a falhas.

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 - Veredito de bot, probabilidade, confiança, agente de bot identificado e as razões por trás da classificação

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

Próximos passos

Was this page helpful?