Universal Analytics (UA) dejará de estar disponible el 1 de julio de 2023, lo que significa que dejará de procesar datos. Las propiedades de Analytics 360 dejarán de funcionar el 1 de octubre de 2023. Migra a Google Analytics 4.

Medición de aplicaciones en una sola página

En esta guía, se describe cómo usar analytics.js para medir la actividad de las páginas en sitios cuyo contenido se carga de forma dinámica sin las cargas tradicionales tradicionales.

Descripción general

Una aplicación de una página (SPA) es una aplicación web o sitio web que carga en la primera página todos los recursos necesarios para navegar por el sitio. A medida que el usuario hace clic en los vínculos e interactúa con la página, el contenido posterior se carga de forma dinámica. A menudo, la aplicación actualiza la URL en la barra de direcciones para emular la navegación tradicional de la página, pero nunca se realiza otra solicitud de página completa.

La etiqueta predeterminada de Google Analytics funciona bien con los sitios web tradicionales porque el código del fragmento se ejecuta cada vez que los usuarios cargan una página nueva. Sin embargo, en el caso de una aplicación de una sola página en la que el sitio carga contenido nuevo de forma dinámica en lugar de hacerlo cuando se carga toda la página, el código del fragmento analytics.js solo se ejecuta una vez. Esto significa que las siguientes páginas vistas (virtuales) deben capturarse manualmente a medida que se carga contenido nuevo.

Seguimiento de visitas virtuales a la página

Cuando tu aplicación carga contenido de forma dinámica y actualiza la URL en la barra de direcciones, también se deben actualizar los datos almacenados en tu rastreador.

Para actualizar la herramienta de seguimiento, usa el comando set y proporciona el nuevo valor de page:

ga('set', 'page', '/new-page.html');

Una vez que hayas establecido el valor de página nuevo, todos los hits posteriores enviados usarán ese nuevo valor. Para registrar una página vista, envíe una visita a la página inmediatamente después de actualizar la herramienta de seguimiento.

ga('set', 'page', '/new-page.html');
ga('send', 'pageview');

Si bien técnicamente el comando send para hits de vistas de página acepta un campo page opcional como tercer parámetro, no se recomienda pasar el campo page cuando se miden aplicaciones de una sola página. Esto se debe a que los campos que se pasan con el comando send no se establecen en la herramienta de seguimiento; solo se aplican al hit actual. No actualizar el rastreador causará problemas si tu aplicación envía hits que no son de vista de página (p.ej., eventos o interacciones sociales), ya que esos hits se asociarán con cualquier valor page que tenga el rastreador cuando se creó.

Administra varias URL para el mismo recurso

Algunos SPA solo actualizan la parte de hash de la URL cuando se carga contenido dinámicamente. Esta práctica puede llevar a situaciones en las que diferentes rutas de página diferentes apuntan al mismo recurso. En estos casos, suele ser mejor elegir una URL canónica y solo enviar ese valor de page a Google Analytics.

Por ejemplo, considere un sitio web cuya página "Acerca de nosotros" se pueda alcanzar a través de cualquiera de las siguientes URL:

  • /about.html
  • /#about.html
  • /home.html#about.html

Para evitar la duplicación en sus informes, es mejor capturar todas estas páginas vistas como /about.html.

Consideraciones importantes

No actualizar el referente del documento

Cuando creas un objeto de seguimiento con el comando create, el valor de document.referrer se almacena en el campo de seguimiento de referrer. En el contexto de una aplicación de una sola página que no usa cargas de página completas, el campo referrer se mantendrá igual.

A pesar de esto, no es necesario actualizar el campo de referencia manualmente antes de enviar hits de vistas de página. Google Analytics puede determinar automáticamente la ruta de navegación correcta.

No actualizar la ubicación del documento

De la misma manera que la herramienta de seguimiento usa document.referrer para el campo referrer, usa document.location para el campo location, que puede contener datos de la campaña u otros metadatos en forma de parámetros de consulta anexados al final de la URL.

Si actualiza cualquiera de los campos de la campaña u otros metadatos que Google Analytics esté verificando, es posible que la sesión actual finalice y comience una nueva. Para evitar este problema, no actualices el campo location cuando midas páginas vistas virtuales en una aplicación de una sola página. En su lugar, usa el campo page.

No crear herramientas de seguimiento nuevas

No crees herramientas de seguimiento nuevas en una aplicación de una sola página para intentar imitar lo que hace el fragmento de seguimiento de JavaScript en los sitios web tradicionales. Si lo hace, corre el riesgo de enviar una URL de referencia incorrecta y datos de campaña incorrectos, como se describió anteriormente.