En este documento, describiremos varias prácticas recomendadas que debe seguir y tener en cuenta mientras utiliza Adobe Analytics para rastrear aplicaciones de una sola página (SPA). Este documento se centrará en el uso de Adobe Experience Platform Launch, que es el método de implementación recomendado.
NOTAS INICIALES:
NOTA: Como se ha indicado, este es un diagrama simplificado de cómo se gestionan las páginas de SPA en una implementación de Adobe Analytics mediante Experience Platform Launch. En las siguientes secciones de esta página, analizaremos los pasos y los temas que debe considerar cuidadosamente o en los que debe actuar.
Cuando se carga contenido nuevo en una página SPA o cuando se realiza una acción en una página SPA, una de las primeras acciones que debe realizar es actualizar la capa de datos. Esto debe suceder ANTES de que el evento personalizado se active y active las reglas en Experience Platform Launch, de modo que Experience Platform Launch pueda recoger los nuevos valores de la capa de datos e insertarlos en Adobe Analytics.
A continuación se muestra una capa de datos de muestra, cuyos elementos podrían cambiarse al cambiar la vista o al realizar acciones en la SPA. Por ejemplo, en un cambio en la pantalla de mayoría/total, sería común cambiar un elemento "pageName" para que el nuevo se pueda capturar en Experience Platform Launch y enviar a Adobe Analytics.
<script>
digitalData = {
pageInstanceID: "Launch Demo Site",
page:{
pageInfo:{
pageID: '2745374',
pageName: 'acs demo - product listing page'
},
attributes:{
project: "Experience Platform Launch Project"
}
},
user : [ {
"profile" : [ {
"attributes" : {
"gender" : "male",
"age" : "35"
}
} ]
}],
libraries : {
adobe : {
launch : {
state : 0, // 0 = not loaded , 1 = loaded
domain : "assets.adobedtm.com"
}
}
}
};
</script>
Cuando se cargue contenido nuevo en la página o cuando se produzca una acción en el sitio, querrá informar Experience Platform Launch para que pueda ejecutar una regla y enviar datos a Analytics. Hay un par de formas diferentes de hacerlo: Eventos personalizados o reglas de llamadas directas.
Ejemplos: En ESTE documento de ayuda, hay vínculos a sitios de SPA de muestra que han implementado Analytics (y otras soluciones de Experience Cloud), así como documentos que describen lo que se ha implementado. En estos ejemplos de SPA se han utilizado los siguientes eventos personalizados:
Consulte los documentos o páginas a los que se hace referencia para obtener más información sobre cómo y cuándo se activan. No es necesario que utilice estos mismos nombres de evento, pero se recomiendan las funciones enumeradas aquí. El siguiente vídeo muestra un sitio de muestra y dónde se encuentra Experience Platform Launch para escuchar los eventos personalizados.
Una de las cosas más importantes para entender Analytics al trabajar con un SPA es la diferencia entre s.t()
y s.tl()
. Va a activar uno de estos métodos Experience Platform Launch para enviar datos a Analytics, pero necesita saber cuándo enviar cada uno.
s.t() : "t" significa "track" y es una vista de página normal. Aunque la dirección URL no cambie, ¿cambia la vista lo suficiente como para considerarla una nueva "página"? Si es así, configure la variable s.pageName y usar s.t()
para enviar la llamada a Analytics
s.tl() : "tl" significa "vínculo de seguimiento" y se utiliza normalmente para rastrear clics o pequeños cambios en el contenido de la página, a diferencia de un cambio en la pantalla completa. Si el cambio en la página es pequeño, para que no lo considere una "página" nueva completa, utilice s.tl()
y no se preocupe por configurar la variable s.pageName, ya que la Analytics ignorará.
SUGERENCIA: Algunas personas utilizan una directriz general según la cual si la pantalla cambia más del 50 %, debe considerarse una vista de página y un uso s.t()
. Si el cambio en la pantalla es inferior al 50 %, utilice s.tl()
. Sin embargo, depende totalmente de usted y de lo que considere una nueva "página" y de cómo le gustaría rastrear su sitio en Adobe Analytics.
El siguiente vídeo muestra dónde y cómo activar s.t()
o s.tl()
en Launch by Adobe.
Al rastrear su sitio con Adobe Analytics, por supuesto que sólo desea enviar los datos correctos en el Analytics momento adecuado. En un entorno de SPA, un valor rastreado en una Analytics variable puede persistir y ser reenviado a Analytics, potencialmente cuando ya no lo queremos. Por este motivo, existe una función en la Analytics extensión para borrar las variables, de modo que tenga una pizarra nueva cuando ejecute la siguiente solicitud de imagen y envíe datos a Launch Analytics.
En el diagrama anterior, se muestra al final del proceso, borrando las variables después de enviar la visita. En realidad, se puede hacer antes o después de que se envíe la visita, pero debe ser coherente en las Experience Platform Launch reglas, de modo que siempre borre antes o después de configurar las variables y enviarlas. Recuerde que si va a borrar las variables antes de ejecutarlas s.t()
, asegúrese de borrar primero las variables, luego configure las nuevas variables y, finalmente, envíe los nuevos datos a Analytics.
NOTA: No siempre es necesario borrar variables al ejecutarse s.tl()
, ya que s.tl()
requiere el uso de la linkTrackVars variable junto a ella cada vez para indicar Analytics qué variables se van a establecer (se agregan automáticamente entre bastidores en Experience Platform Launch). Esto significa que las variables errantes no suelen aparecer al usar s.tl()
, pero se recomienda mucho cuando se usan s.t()
en un entorno SPA. Dicho esto, me gustaría recomendarlo como una práctica recomendada utilizar la función Borrar variables tanto para s.t()
como para s.tl()
un entorno SPA, sólo para garantizar la recopilación de datos de calidad.
El siguiente vídeo muestra dónde y cómo borrar las variables en Launch.
En la Launch Analytics extensión, hay dos lugares en los que puede insertar código personalizado: La sección Administración de biblioteca y la sección adicional "Configurar rastreador usando códigopersonalizado".
Es importante saber que cualquiera de estas ubicaciones solo va a ejecutar el código una vez, cuando la carga de página inicial se produce en la página de SPA. Si necesita que el código se ejecute en un cambio de vista o en una acción del sitio, debe agregar una acción adicional a la regla correspondiente (por ejemplo, en la "carga de página: "Fin de vista de evento" ( regla), de modo que el código se ejecute cada vez que se ejecute la regla . Al crear esa acción en la regla, establezca Extension = Core y Tipo de acción = Código personalizado.
Algunos sitios son una combinación de páginas "regulares" y páginas de SPA. En este caso, deberá utilizar una estrategia que funcione para ambos tipos de página. Al configurar los eventos personalizados en el sitio y activar las reglas en Experience Platform Launch, tenga cuidado de que no haya visitas de doble que entren Analytics desde la página, en base a los cambios de hash, etc. (si así es como ha elegido activar la Experience Platform Launch regla). En este caso, deberá suprimir una de las vistas de página para que no le proporcione datos defectuosos en Adobe Analytics.
Si decide desglosar la funcionalidad en reglas separadas para que tenga más control sobre ella, asegúrese de recordar/documento de que lo ha hecho, para que cualquier cambio en una regla también se pueda realizar en la otra regla , protegiendo así la integridad Analytics de los datos.
Sólo una llamada rápida aquí. Si está realizando la integración con Target A4T, asegúrese de que la Target solicitud y la Analytics solicitud del mismo cambio de vista tengan el mismo SDID. Esto garantizará que los datos se sincronicen correctamente en las soluciones.
Para ver las visitas, utilice un depurador o un programa de husmeador de paquetes. También puede utilizar el Experience Cloud Debugger, una extensión de Chrome que se puede descargar AQUÍ. Target debe activarse primero en la página, así que también puede comprobarlo en la consola de JavaScript o en el depurador.