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

CAUTION
AEM 6.4 ha llegado al final de la compatibilidad ampliada y esta documentación ya no se actualiza. Para obtener más información, consulte nuestra períodos de asistencia técnica. Buscar las versiones compatibles here.

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

NOTE
Esta información es básicamente genérica, pero usa Adobe Analytics para ver ejemplos específicos.
Para obtener información general sobre el desarrollo de componentes y cuadros de diálogo, consulte Desarrollo de componentes.

Eventos personalizados custom-events

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 tracking-custom-events-on-page-load

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 tracking-custom-events-after-page-load

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 accessing-values-in-the-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)

NOTE
Consulte también la Referencia de la API de ContextHub

Adición de llamadas de registro adding-record-callbacks

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.

recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e