Aplicaciones de una sola página (SPA)

Si su sitio es una aplicación de una sola página (SPA) — React, Vue, Angular o cualquier otro framework en el que la navegación ocurre en el cliente sin recargar la página entera —, Personyze necesita una configuración explícita para rastrear esos cambios de ruta. Si no, toda la SPA se ve en Personyze como una sola página vista, y la personalización que depende de la URL o de la ruta no se activa en las navegaciones posteriores.

Activar el modo SPA

Vaya a Configuración de la cuenta → Configuración general → Configuración del tracker y ponga el interruptor Single Page Application en activada.

Una vez activado, cada cambio de URL en su SPA hace lo siguiente:

Añade una nueva entrada al historial de páginas vistas del visitante
Vuelve a evaluar las coincidencias de audiencia para la nueva URL o ruta
Sustituye el contenido de placeholder asociado a la página vista anterior por el contenido de la nueva ruta
Activa el seguimiento de objetivos y otras reglas condicionadas por la URL

Cómo funciona la detección

Personyze escucha las señales estándar de navegación de las SPA: los eventos history.pushState, history.replaceState, y popstate . La mayoría de los frameworks modernos (React Router, Vue Router, la navegación en el cliente de Next.js) los emiten correctamente. Si su framework usa enrutamiento basado en hash (URL#/route ), Personyze también las rastrea.

Conflicto con Google Tag Manager.Si carga Personyze a través de GTM, use el tipo de activador Página vista, no Cambio de historial. El activador de cambio de historial de GTM lanza su propio evento de página vista, que entra en conflicto con la detección de SPA de Personyze. Consulte la guía de GTM para configurar correctamente el activador.

Comprobar que el seguimiento de la SPA funciona

Abra las herramientas de desarrollo, la pestaña Red, y filtre por counter.personyze.com.
Navegue dentro de su SPA sin recargar la página entera (haga clic en un enlace interno).
Debería ver que se lanza una nueva solicitud a counter.personyze.com con la nueva URL.
En el panel de Personyze, vaya a Actividad de los visitantes en el sitio en tiempo real y confirme que las dos URL aparecen en el historial de su sesión de prueba.

Seguimiento entre dominios

El modo SPA es independiente del seguimiento entre dominios, pero a menudo van juntos. Si sus visitantes pasan de un dominio a otro de su cuenta (p. ej., de marketing.brand.com a app.brand.com), active los dos — consulte la guía de seguimiento entre dominios para esa configuración. Juntos, el modo SPA y el seguimiento entre dominios garantizan que un mismo visitante corresponda a un único perfil de Personyze en todas las rutas de todos los dominios.

Resolución de problemas

La personalización no se actualiza al cambiar de ruta. Confirme que el modo SPA está activado y compruebe que la segmentación de su campaña incluye el nuevo patrón de URL (no solo la URL de entrada inicial).
Recuento de páginas vistas inflado. Algunas SPA llaman a pushState para cosas que no son navegación (abrir un modal, cambiar de pestaña). Si ve un número de páginas vistas sospechosamente alto, revise su código de enrutamiento o contacte con soporte — podemos configurar filtros de URL para ignorar patrones concretos.
Los objetivos no se activan. Los objetivos definidos como «La URL contiene X» se activarán ahora en cada ruta de la SPA que coincida. Si eso es demasiado amplio, añada una condición de URL más específica.