Skip to main content
Activar Device Intelligence
Language

Device Intelligence

Use cside Device Intelligence para identificar visitantes, recopilar señales del navegador y detectar bots, VPNs, proxies y entornos sospechosos.

cside Device Intelligence recopila señales de navegador y red de sesiones reales, las convierte en un token de sesión y permite que su backend recupere los datapoints resultantes. Úselo para controles de fraude, abuso de cuentas, medición de bots e inteligencia de visitantes.

Nuevas activaciones cerradas

Device Intelligence no está disponible para nuevas activaciones. Los equipos que ya usan Device Intelligence, incluidos los equipos gratuitos, de pago, enterprise y de prueba, conservan su acceso y pueden seguir gestionando su plan y sus claves de API. Los equipos nuevos comienzan solo con la seguridad del lado del cliente.

Activar Device Intelligence

Las nuevas activaciones de Device Intelligence están cerradas. Estos pasos se aplican a equipos que ya tienen acceso. Mantén Device Intelligence activado en Install Device Intelligence, con al menos un dominio gestionado y no suspendido. Consulta la disponibilidad y configuración de recopilación.

  • El equipo necesita al menos un dominio gestionado y no suspendido antes de poder activarlo. El script solo se ejecuta en los dominios de recopilación del equipo, así que activar un equipo sin ninguno no recopila nada.
  • La activación requiere reconocer explícitamente que Device Intelligence recopila datos personales (PII) de los visitantes, incluidos la dirección IP, la ubicación aproximada y señales de hardware y navegador. Usted es responsable de contar con una base legal, de las divulgaciones de privacidad y de cualquier consentimiento exigido por el RGPD, la CCPA y otras leyes aplicables.

Una vez activado, todos los dominios gestionados del equipo pueden recopilar fingerprints. No existe un interruptor por dominio.

Detener la recopilación

Desactivar Device Intelligence en el panel cambia la configuración del equipo; no elimina el código de tu sitio. Para detener la recopilación en el navegador, elimina la inicialización del paquete o el bootstrap de cada punto de despliegue: la aplicación, las plantillas HTML, Cloudflare Worker, el código personalizado de Framer o Webflow y los scripts servidos desde un dominio propio. Publica los cambios y comprueba que el navegador ya no cargue ni envíe telemetría de Device Intelligence.

Cómo funciona

  1. Active Device Intelligence para el equipo en cside
  2. Instale el paquete npm o cargue el script de cside Device Intelligence en su sitio
  3. Llame a sendClientTelemetry(externalIds?) desde el navegador
  4. Envíe el token de sesión devuelto a su backend
  5. Recupere los datapoints desde cside con la Events API y una clave API de Device Intelligence solo para backend

externalIds es opcional. Úselo cuando quiera adjuntar sus propios identificadores de cuenta, sesión, pedido o usuario al fingerprint. Las reglas integradas y el Identity graph se basan en userId, así que páselo cuando lo tenga.

Configuración recomendada

Para aplicaciones construidas con un bundler, instale @cside.dev/device-intelligence. Incluye el código de recopilación en el bundle, así que no hay ningún script remoto que cargar o bloquear, y devuelve un sendClientTelemetry con tipos. Es el método predeterminado en el dashboard.

Cuando en su lugar inyecte el script en el HTML, use la configuración DNS para servirlo desde su propio dominio siempre que sea posible. cside ofrece esto para evitar inquietudes de privacidad relacionadas con dominios de terceros, hacer que el script parezca first-party para el navegador y evitar que los bloqueadores de anuncios del navegador o el bloqueo client-side interfieran con el script o afecten la precisión de las detecciones. Cárguelo temprano en el documento con el bootstrap del navegador tolerante a fallos.

Categorías de datapoints

La Events API puede devolver:

  • Identificación - ID de visitante, confianza, primera visita y última visita
  • Navegador y dispositivo - User-Agent, sistema operativo, idioma, zona horaria, plataforma, plugins, canvas, WebGL, WebGPU, audio, almacenamiento y permisos
  • Red e inteligencia de IP - Dirección IP, proximidad, VPN, proxy, Tor y señales de listas de bloqueo
  • Entorno - Modo incógnito, manipulación, máquina virtual, herramientas de desarrollo, replay y dispositivos con alta actividad
  • Bots y automatización - Veredicto de bot, probabilidad, confianza, agente de bot identificado y los motivos de la clasificación

La referencia completa de campos está en la Events API.

Siguientes pasos

Was this page helpful?