Ampliación del seguimiento de eventos extending-event-tracking

AEM Analytics le permite realizar un seguimiento de la interacción del usuario con el sitio web. Como desarrollador, es posible que tenga que:

Eventos personalizados custom-events

Los eventos personalizados hacen un seguimiento de cualquier elemento que dependa de la disponibilidad de un componente específico en la página. Esto también incluye eventos específicos de la plantilla, ya que el componente de página se trata como otro componente.

Seguimiento De Eventos Personalizados Al Cargar La Página tracking-custom-events-on-page-load

Esto se puede hacer con el pseudoatributo data-tracking (el atributo de registro anterior sigue siendo compatible con la compatibilidad con versiones anteriores). Puede añadir esto a cualquier etiqueta de HTML.

La sintaxis de data-tracking es

Puede pasar cualquier número de pares clave-valor como segundo parámetro, que se denomina carga útil.

Un ejemplo podría tener el siguiente aspecto:

<span data-tracking="{event:'blogEntryView',
                                values:{
                                   'blogEntryContentType': 'blog',
                                   'blogEntryUniqueID': '<%= xssAPI.encodeForJSString(entry.getId()) %>',
                                   'blogEntryTitle': '<%= xssAPI.encodeForJSString(entry.getTitle()) %>',
                                   'blogEntryAuthor':'<%= xssAPI.encodeForJSString(entry.getAuthor()) %>',
                                   'blogEntryPageLanguage':'<%= currentPage.getLanguage(true) %>'
                                },
                                componentPath:'myapp/component/mycomponent'}">
</span>

Al cargar la página, se recopilarán todos los atributos de data-tracking y se agregarán al almacén de eventos de ContextHub, donde se pueden asignar a eventos de Adobe Analytics. Adobe Analytics no rastreará los eventos que no estén asignados. Consulte Conectarse a Adobe Analytics para obtener más información sobre la asignación de eventos.

Seguimiento de eventos personalizados después de cargar la página tracking-custom-events-after-page-load

Para hacer un seguimiento de los eventos que se producen después de cargar una página (como las interacciones del usuario), use la función JavaScript CQ_Analytics.record:

Donde

Por ejemplo, con la siguiente definición, si un usuario hace clic en el vínculo Saltar al principio, se activarán los dos eventos, jumptop y headlineclick:

<h1 data-tracking="{event: 'headline', values: {level:'1'}, componentPath: '<%=resource.getResourceType()%>'}">
  My Headline <a href="#" onclick="CQ_Analytics.record({event: ['jumptop','headlineclick'],  values: {level:'1'}, componentPath: '<%=resource.getResourceType()%>'})">Jump to top</a>
</h1>

Acceso a los valores en ContextHub accessing-values-in-the-contexthub

La API de JavaScript de ContextHub tiene una función getStore(name) que devuelve el almacén especificado, si está disponible. El almacén tiene una función getItem(key) que devuelve el valor de la clave especificada, si está disponible. Mediante la función getKeys() es posible recuperar una matriz de claves definidas para el almacén específico.

Se le pueden notificar los cambios de valor en un almacén enlazando una función mediante la función ContextHub.getStore(name).eventing.on(ContextHub.Constants.EVENT_STORE_UPDATED, handler, selector, triggerForPastEvents).

La mejor manera de recibir notificaciones sobre la disponibilidad inicial de ContextHub es utilizar la función ContextHub.eventing.on(ContextHub.Constants.EVENT_ALL_STORES_READY, handler, selector, triggerForPastEvents);.

Eventos adicionales para ContextHub:

Todas las tiendas listas:

ContextHub.eventing.on(ContextHub.Constants.EVENT_ALL_STORES_READY, handler, selector, triggerForPastEvents);

Específico de la tienda:

ContextHub.getStore(store).eventing.on(ContextHub.Constants.EVENT_STORE_READY, handler, selector, triggerForPastEvents)

Adición de devoluciones de llamada de registro adding-record-callbacks

Antes y después de registrar las llamadas de retorno mediante las funciones CQ_Analytics.registerBeforeCallback(callback,rank) y CQ_Analytics.registerAfterCallback(callback,rank).

Ambas funciones toman una función como primer argumento y una clasificación como segundo argumento, lo que dicta el orden en que se ejecutan las llamadas de retorno.

Si la llamada de retorno devuelve el valor "False", no se ejecutarán las llamadas de retorno siguientes en la cadena de ejecución.