Skip to main content

​
El recorrido del escaneo al informe

Esto es lo que ocurre desde que alguien escanea tu código QR hasta que ese evento aparece en tus informes.

​
La sesión de escaneo

El parámetro scnv de la URL es la clave de la atribución. Contiene un ID de sesión de escaneo: un UUID que identifica de forma única un escaneo concreto de un código QR concreto, hecho por una persona concreta en un momento concreto.
Cuando el SDK del navegador carga en una página con ese parámetro, hace lo siguiente:
  1. Lee el valor de scnv de la URL
  2. Lo guarda en localStorage con una caducidad de 60 días
  3. Lo adjunta como scan_session_id a cada evento que sale de ese navegador
Es decir: si la persona se marcha y vuelve dentro de esos 60 días, sus acciones posteriores se siguen atribuyendo al escaneo original.

​
Atribución entre páginas y sesiones

El ID de sesión de escaneo se mantiene al navegar entre páginas del mismo dominio. Si alguien:
  1. Escanea un código QR → llega a /landing
  2. Hace clic hasta /pricing
  3. Se registra en /signup
las tres páginas vistas se atribuyen al mismo escaneo, siempre que el SDK esté instalado en todas ellas.

​
Eventos del navegador y eventos de servidor

Hay dos tipos de eventos: Ambos tipos aceptan un scan_session_id, que los enlaza con el escaneo del código QR. Para los eventos de servidor, tu backend necesita recibir el scan_session_id del navegador, normalmente en un campo de formulario, una cookie de sesión o una llamada a tu API.

​
Cómo se procesan los eventos

Cuando la API de seguimiento recibe un evento, este pasa por varias fases de procesamiento:
  1. Validación: comprueba los campos obligatorios, el tamaño del contenido y la autorización del sitio y el dominio
  2. Deduplicación: marca como duplicados los valores repetidos de event_id (se siguen guardando, no se descartan)
  3. Datos del dispositivo: analiza el user-agent para extraer tipo de dispositivo, navegador y sistema operativo
  4. Datos de ubicación: resuelve la dirección IP en país y ciudad mediante GeoIP
  5. Enlace de identidad: resuelve el scan_session_id al ID del código QR y al ID de usuario en la base de datos de Scanova
  6. Detección de fraude: puntuación heurística para señalar comportamientos propios de bots
  7. Privacidad y RGPD: elimina los campos de datos personales si consent es denied o pending
Los eventos procesados aparecen en los informes del panel con un pequeño retardo de ingesta (normalmente menos de 10 segundos).

​
Identidad y sesiones

Cada evento que envía el SDK lleva tres valores de identidad distintos. Entender la diferencia ayuda a leer los informes: Un mismo visitante puede tener muchas sesiones web, y una sesión web muchos eventos. Todos los eventos de los 60 días siguientes a un escaneo comparten el mismo scan_session_id.

​
Disponibilidad de los datos

  • Los eventos se ingieren y se encolan en cuanto llegan
  • Con carga normal, los eventos procesados aparecen en los informes en cuestión de segundos
  • En picos de tráfico puede haber retrasos cortos, de hasta unos minutos