Documentación · Por Koolya
Cómo registra Analytics la navegación en una SPA
Una aplicación de página única puede cambiar de ruta sin crear un documento nuevo. El tracker observa cambios del historial para registrar páginas vistas, mientras la sesión permanece en memoria. Esta diferencia afecta tanto a la instalación como a la interpretación de recorridos.
Revisado el
Instala el script una sola vez
Coloca el script en el documento principal de la aplicación y verifica que se carga antes de medir acciones propias. No lo vuelvas a insertar en cada componente de ruta. Una segunda instalación puede duplicar eventos y crear otro contexto de sesión.
El tracker intercepta history.pushState y history.replaceState y escucha la navegación del historial. La ruta se compara con la última página registrada para evitar registrar de nuevo el mismo pathname. Un cambio solo de parámetros no equivale necesariamente a otra página vista.
Prueba el recorrido real
Abre la ruta inicial, navega a otra pantalla con los enlaces de la aplicación y vuelve con el botón del navegador. Comprueba las rutas de los pageview recibidos. Prueba también una ruta abierta directamente y una recarga completa, porque siguen recorridos de carga diferentes.
Los eventos propios describen acciones, no sustituyen los pageview. Si tu aplicación mide el envío de un formulario, dispara ese evento después de la respuesta correcta. Revisa que un efecto del componente o una repetición del render no lo envíe dos veces.
Interpreta los límites de sesión
Durante la navegación sin recarga, varios eventos pueden compartir la sesión del documento. Al recargar se crea otra; abrir una segunda pestaña tampoco demuestra que sea otra persona. Además, el tracker renueva la sesión cuando supera su ventana de 30 minutos.
Comprueba las exclusiones cuando pases de una ruta pública a otra privada dentro de la misma SPA. El tracker no reconoce identidades entre visitas ni enlaza automáticamente su sesión con el usuario de tu aplicación. Usa el recorrido para entender navegación registrada, no para reconstruir personas.