Skip to main content

​
Du scan au rapport

Voici ce qui se passe entre le moment où une personne scanne votre QR Code et celui où l’événement apparaît dans vos rapports.

​
La session de scan

Le paramètre scnv de l’URL est la clé de l’attribution. Il contient un identifiant de session de scan : un UUID qui désigne un scan précis, d’un QR Code précis, par une personne précise, à un instant précis.
Au chargement d’une page portant ce paramètre, le SDK navigateur fait ceci :
  1. Il lit la valeur de scnv dans l’URL
  2. Il l’enregistre dans localStorage avec une validité de 60 jours
  3. Il la joint sous le nom scan_session_id à chaque événement envoyé depuis ce navigateur
Autrement dit, si la personne quitte le site puis revient dans les 60 jours, ses actions suivantes restent rattachées au scan d’origine.

​
Attribution entre les pages et les sessions

L’identifiant de session de scan est conservé d’une page à l’autre sur un même domaine. Si une personne :
  1. scanne un QR Code → arrive sur /landing
  2. poursuit vers /pricing
  3. s’inscrit sur /signup
les trois pages vues sont rattachées au même scan, à condition que le SDK soit installé sur toutes les pages.

​
Événements du navigateur et événements serveur

Il existe deux types d’événements : Les deux types acceptent un scan_session_id, qui les relie au scan du QR Code. Pour les événements serveur, votre backend doit recevoir le scan_session_id depuis le navigateur — le plus souvent via un champ de formulaire, un cookie de session ou un appel d’API.

​
Le traitement des événements

Dès que l’API de suivi reçoit un événement, celui-ci passe par une chaîne de traitement :
  1. Validation — contrôle des champs obligatoires, de la taille du contenu et de l’autorisation du site et du domaine
  2. Déduplication — les valeurs répétées de event_id sont marquées comme doublons (elles restent stockées, elles ne sont pas supprimées)
  3. Données d’appareil — analyse du user-agent pour en extraire le type d’appareil, le navigateur et le système
  4. Données de localisation — résolution du pays et de la ville à partir de l’adresse IP via GeoIP
  5. Rapprochement d’identité — résolution du scan_session_id vers l’identifiant du QR Code et celui de l’utilisateur dans la base Scanova
  6. Détection de fraude — notation heuristique pour signaler les comportements de robots
  7. Confidentialité / RGPD — suppression des champs personnels si consent vaut denied ou pending
Les événements traités apparaissent dans les rapports de votre tableau de bord après un court délai d’ingestion (moins de 10 secondes en général).

​
Identité et sessions

Chaque événement envoyé par le SDK porte trois valeurs d’identité distinctes. En comprendre la différence aide à lire les rapports : Un même visiteur peut avoir de nombreuses sessions web, et une session web de nombreux événements. Tous les événements survenus dans les 60 jours suivant un scan partagent le même scan_session_id.

​
Disponibilité des données

  • Les événements sont ingérés et mis en file dès leur réception
  • En charge normale, les événements traités apparaissent dans les rapports en quelques secondes
  • De courts délais, jusqu’à quelques minutes, peuvent survenir lors des pics de trafic