Ampliación del seguimiento de eventos

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

• Rastree la interacción de los visitantes con sus componentes. Esto se puede hacer con Eventos personalizados.
• Acceso a valores en ContextHub.
• Añadir llamadas de retorno de registros.

Eventos personalizados

Los eventos personalizados rastrean 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

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

La sintaxis de data-tracking es

• data-tracking="{'event': ['eventName'], 'values': {'key': 'value', 'nextKey': 'nextValue'}, componentPath: 'myapp/component/mycomponent'}"

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

Un ejemplo puede 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, todo data-tracking los atributos se recopilarán y 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 Conexión a Adobe Analytics para obtener más información sobre los eventos de asignación.

Seguimiento de eventos personalizados después de la carga de la página

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

• CQ_Analytics.record({event: 'eventName', values: { valueName: 'VALUE' }, collect: false, options: { obj: this, defaultLinkType: 'X' }, componentPath: '<%=resource.getResourceType()%>'})

Donde

• events es una cadena o una matriz de cadenas (para varios eventos).

• values contiene todos los valores que se van a rastrear

• collect es opcional y devuelve una matriz que contiene el evento y el objeto de datos.

• options es opcional y contiene opciones de seguimiento de vínculos como el elemento HTML obj y [defaultLinkType](https://microsite.omniture.com/t2/help/en_US/sc/implement/index.html#linkType).

• componentPath es un atributo necesario y se recomienda establecerlo en <%=resource.getResourceType()%>

Por ejemplo, con la siguiente definición, un usuario que hace clic en el botón Saltar a la parte superior provocará los dos eventos, jumptop y headlineclick, que se activará:

<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

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

Puede recibir notificaciones de los cambios de valor en un almacén si vincula una función con la función ContextHub.getStore(name).eventing.on(ContextHub.Constants.EVENT_STORE_UPDATED, handler, selector, triggerForPastEvents) función.

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

Eventos adicionales para ContextHub:

Todas las tiendas están listas:

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

Específico del almacén:

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

Adición de llamadas de registro

Las retrollamadas antes y después se registran mediante las funciones CQ_Analytics.registerBeforeCallback(callback,rank) y CQ_Analytics.registerAfterCallback(callback,rank).

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

Si la rellamada devuelve el valor false, las rellamadas que siguen a la cadena de ejecución no se ejecutarán.

Recursos de Business.Adobe.com

Content Insights Automated Onboarding Personalized Experiences Embedded Charts Dynamic Forms Headless Cms