Device Intelligence
Utilisez cside Device Intelligence pour identifier les visiteurs, collecter les signaux navigateur et détecter les bots, VPN, proxies et environnements suspects.
cside Device Intelligence collecte les signaux navigateur et réseau de vraies sessions, les transforme en token de session et permet à votre backend de récupérer les datapoints associés. Utilisez-le pour les contrôles fraude, l’abus de compte, la mesure des bots et l’intelligence visiteur.
Device Intelligence est activé par équipe, pas par domaine. Si vous ne voyez pas de données de fingerprint, vérifiez que l’équipe a Device Intelligence activé et au moins un domaine géré non suspendu.
Activer Device Intelligence
Device Intelligence est un interrupteur au niveau de l’équipe. Activez-le depuis la page Install Device Intelligence du tableau de bord, ou depuis l’état vide de Device Intelligence.
- L’équipe a besoin d’au moins un domaine géré non suspendu avant de pouvoir l’activer. Le script ne s’exécute que sur les domaines collecteurs de l’équipe, activer une équipe sans domaine ne collecte donc rien.
- L’activation exige de reconnaître explicitement que Device Intelligence collecte des données personnelles (PII) des visiteurs, dont l’adresse IP, la localisation approximative et des signaux matériels et navigateur. Vous êtes responsable de la base légale, des mentions de confidentialité et de tout consentement requis par le RGPD, le CCPA et les autres lois applicables.
Une fois la fonction activée, chaque domaine géré de l’équipe peut collecter des fingerprints. Il n’y a pas d’interrupteur par domaine.
Fonctionnement
- Activez Device Intelligence pour l’équipe dans cside
- Installez le package NPM ou chargez le script cside Device Intelligence sur votre site
- Appelez
sendClientTelemetry(externalIds?)depuis le navigateur - Envoyez le token de session renvoyé à votre backend
- Récupérez les datapoints depuis cside avec l’Events API et une clé API de Device Intelligence réservée au backend
externalIds est facultatif. Utilisez-le lorsque vous voulez attacher vos propres identifiants de compte, session, commande ou utilisateur au fingerprint. Les règles intégrées et l’Identity graph s’appuient sur userId, passez-le donc lorsque vous en avez un.
Configuration recommandée
Pour les apps construites avec un bundler, installez @cside.dev/device-intelligence. Le code de collecte est inclus dans le package, il n’y a donc aucun script distant à charger ou à bloquer, et il renvoie un sendClientTelemetry typé. C’est la méthode par défaut du tableau de bord.
Lorsque vous injectez plutôt le script dans le HTML, utilisez la configuration DNS pour le servir depuis votre propre domaine lorsque c’est possible. cside propose cette option pour éviter les préoccupations de confidentialité liées aux domaines tiers, rendre le script first-party pour le navigateur et empêcher les bloqueurs de publicités du navigateur ou le blocage client-side d’interférer avec le script ou d’affecter la précision des détections. Chargez-le tôt dans le document avec le bootstrap navigateur tolérant aux pannes.
Catégories de datapoints
L’Events API peut renvoyer :
- Identification - ID visiteur, confiance, première vue et dernière vue
- Navigateur et appareil - User-Agent, OS, langue, fuseau horaire, plateforme, plugins, canvas, WebGL, WebGPU, audio, stockage et permissions
- Réseau et IP - Adresse IP, proximité, VPN, proxy, Tor et signaux de listes de blocage
- Environnement - Navigation privée, altération, machine virtuelle, outils développeur, replay et appareils à forte activité
- Bots et automatisation - Verdict bot, probabilité, confiance, agent bot identifié et raisons derrière la classification
La référence complète des champs se trouve dans l’Events API.
Étapes suivantes
Thanks for your feedback!