Ce guide s’applique à toutes les plateformes sur lesquelles vous utilisez Fraud Insights, et pas seulement au web. Le modèle de session, les événements et la configuration ci-dessous sont identiques partout. Les étapes d’installation et les exemples de code utilisent le package JavaScript,
youverify-behavioral-web-sdk, que vous pouvez ajouter à n’importe quelle application web.Fonctionnalités
- Gestion des sessions : identifiants de session automatiques et suivi du début et de la fin de session.
- Signaux d’appareil et de comportement : fondés sur FingerprintJS et des heuristiques du navigateur.
- Suivi d’événements : envoyez des événements personnalisés avec des identifiants d’utilisateur ou d’entité et des métadonnées facultatifs.
- Réponses typées : une structure
GetDeviceResponseriche pour l’analyse des risques.
Installation
- npm
- yarn
Configuration
Créez une instance avecnew YouverifyBBS(props) :
Propriétés
Votre Public Merchant Key (clé marchand publique). Vous la trouverez dans la section API / Webhook de votre tableau de bord Youverify. Elle peut être utilisée sans risque côté client.
true utilise l’environnement sandbox (préproduction). false utilise la production.Appelée après une réponse de signal réussie, par exemple après
get().API principale
get(entityId?)
Initialise ou reprend une session et envoie le signal initial. Renvoie Promise<void>.
- Le premier appel envoie un événement
session_start. - Les appels suivants dans la même session envoient un événement personnalisé « Session resumed ».
- Il déclenche
onLoad(result: GetDeviceResponse)avec l’ensemble des données d’appareil et de session.
sendEvent(eventTitle, entityId?, meta?)
Envoie un événement comportemental personnalisé pour la session en cours. Renvoie Promise<void>.
close(entityId?)
Envoie un événement session_end et efface l’état local de la session. Renvoie Promise<void>.
getSessionId()
Renvoie l’identifiant de la session en cours, ou null s’il n’y en a pas.
getSessionDuration()
Renvoie le temps écoulé, en millisecondes, depuis le début de la session.
Environnements
Le SDK choisit les URL du backend à partir de la configuration de la build et de l’optionsandboxEnvironment.
Utilisez la Public Merchant Key de la section API / Webhook de votre tableau de bord, en vous assurant qu’elle correspond à l’environnement utilisé.
Exemples d’utilisation
Balise script (UMD)
React
Prise en charge des navigateurs
- Navigateurs modernes compatibles ES2015+.
- L’API Fetch est requise, ou un polyfill.
Transmettez toujours, comme
publicKey, la Public Merchant Key qui correspond à votre environnement (sandbox ou production). Privilégiez des noms d’événements explicites et joignez des données meta pour des analyses plus riches.