[Integración]{class="badge positive"}

Configuración de Asset Insights con AEM Assets y etiquetas

[AEM Assets as a Cloud Service, AEM Assets 6.5]{class="badge informative"}

En esta serie de vídeos de cinco partes, analicemos la configuración de Asset Insights para Experience Manager implementados mediante etiquetas.

Parte 1: Información general de Asset Insights overview

Información general de Asset Insights. Instale los componentes principales, el componente de imagen de muestra y otros paquetes de contenido para preparar su entorno.

Diagrama de arquitectura architecture-diagram

Diagrama de arquitectura

CAUTION
Asegúrese de descargar el Última versión de componentes principales para su implementación.

El vídeo utiliza los componentes principales v2.2.2, que no es la versión más reciente; asegúrese de utilizar la versión más reciente antes de pasar a la siguiente sección.

Parte 2: Habilitar el seguimiento de Asset Insights para el componente de imagen de muestra sample-image-component-asset-insights

Mejoras en los componentes principales y uso del componente proxy (componente de imagen de muestra) para las perspectivas de recursos. Editar las directivas de plantilla de página de contenido para habilitar el componente de imagen de muestra para el sitio de referencia.

NOTE
El componente principal de imagen incluye la capacidad de deshabilitar el seguimiento UUID al deshabilitar el seguimiento del UUID del recurso (valor de identificador único para un nodo creado dentro de JCR)

El componente de imagen principal utiliza data-asset-id atributo dentro del elemento principal <div> de una etiqueta de imagen para activar o desactivar esta función. El componente proxy anula el componente principal con los siguientes cambios.

  • Quita el data-asset-id desde el div principal de un <img> elemento dentro de image.html
  • Agrega data-aem-asset-id directamente al <img> elemento dentro de image.html
  • Agrega data-trackable='true' al <img> elemento dentro de image.html
  • data-aem-asset-id y data-trackable='true' se mantienen en el mismo nivel de nodo
NOTE
data-aem-asset-id='image.UUID' y data-trackable='true' son los atributos clave que deben estar presentes para las impresiones de recursos. Para las perspectivas de clic en recursos, además de los atributos de datos anteriores presentes en la <img> etiqueta, la etiqueta principal debe tener un valor href válido.

Parte 3: Adobe Analytics: Creación de un grupo de informes, activación de la recopilación de datos en tiempo real y creación de informes en AEM Assets adobe-analytics-asset-insights

Se crea un grupo de informes con recopilación de datos en tiempo real para el seguimiento de recursos. La configuración de AEM Assets Insights se configura con las credenciales de Adobe Analytics.

NOTE
AEM La recopilación de datos en tiempo real y la creación de informes de recursos de la deben estar habilitadas para el grupo de informes de Adobe Analytics. AEM Al habilitar el informe de recursos de, se reservan variables de análisis para rastrear las perspectivas de recursos.

Para la configuración de AEM Assets Insights, necesita las siguientes credenciales

  • Centro de datos
  • Nombre de empresa de Analytics
  • Usuario de Analytics
  • Secreto compartido (se puede obtener de Adobe Analytics > Administración > Configuración de la empresa > Servicio web).
  • Grupo de informes (asegúrese de seleccionar el grupo de informes correcto que se utiliza para la creación de informes de recursos)

Parte 4: Uso de etiquetas para añadir la extensión de Adobe Analytics part-using-launch-by-adobe-for-adding-adobe-analytics-extension

Añadir la extensión de Adobe Analytics AEM, crear reglas de carga de página e integrar con etiquetas con la cuenta técnica de IMS de Adobe.

NOTE
Asegúrese de replicar todos los cambios de la instancia de autor a la instancia de publicación.

Regla 1: Rastreador de páginas (pagetracker.js) rule-page-tracker-pagetracker-js

//For AEM 6.3
<script type="text/javascript" src="http://localhost:4503/etc/clientlibs/foundation/assetinsights/pagetracker.js"></script>
//For AEM 6.4
<script type="text/javascript" src="http://localhost:4503/etc.clientlibs/dam/clientlibs/assetinsights/pagetracker.js"></script>

El rastreador de páginas implementa dos llamadas de retorno (registradas en el código incrustado del recurso)

  • &lt;code>assetAnalytics.core.assetLoaded&lt;code> : se llama cuando se envía el evento "load" para el elemento asset-DOM.
  • &lt;code>assetAnalytics.core.assetClicked&lt;code> : se llama cuando se envía un evento de "clic" para el elemento asset-DOM; esto solo es relevante cuando el elemento asset-DOM tiene una etiqueta de anclaje como principal con un atributo "href" externo válido

Finalmente, el rastreador de páginas implementa una función de inicialización como.

  • &lt;code>assetAnalytics.dispatcher.init()&lt;code> : se llama para inicializar el componente Rastreador de páginas. Se DEBE invocar antes de que se genere cualquiera de los eventos de asset-insights (impresiones o clics) desde la página web.
  • &lt;code>assetAnalytics.dispatcher.init()&lt;code> : acepta opcionalmente un objeto de AppMeasurement; si se proporciona, no intenta crear una instancia del objeto de AppMeasurement.

Regla 2: Rastreador de imágenes — Acción 1 (asset-insights.js) rule-image-tracker-action-asset-insights-js

/*
 * AEM Asset Insights
 */

var sObj = window.s;
_satellite.notify('in assetAnalytics customInit');
(function initializeAssetAnalytics() {
 if ((!!window.assetAnalytics) && (!!assetAnalytics.dispatcher)) {
 _satellite.notify('assetAnalytics ready');
 /** NOTE:
  Copy over the call to 'assetAnalytics.dispatcher.init()' from Assets Pagetracker
  Be mindful about changing the AppMeasurement object as retrieved above.
  */
 assetAnalytics.dispatcher.init(
                                "",  /** RSID to send tracking-call to */
                                "",  /** Tracking Server to send tracking-call to */
                                "",  /** Visitor Namespace to send tracking-call to */
                                "",  /** listVar to put comma-separated-list of Asset IDs for Asset Impression Events in tracking-call, e.g. 'listVar1' */
                                "",  /** eVar to put Asset ID for Asset Click Events in, e.g. 'eVar3' */
                                "",  /** event to include in tracking-calls for Asset Impression Events, e.g. 'event8' */
                                "",  /** event to include in tracking-calls for Asset Click Events, e.g. 'event7' */
                                sObj  /** [OPTIONAL] if the webpage already has an AppMeasurement object, please include the object here. If unspecified, Pagetracker Core shall create its own AppMeasurement object */
                                );
 sObj.usePlugins = true;
 sObj.doPlugins = assetAnalytics.core.updateContextData;
}
 else {
 _satellite.notify('assetAnalytics not available. Consider updating the Custom Page Code', 4);
 }
})();

Regla 2: Rastreador de imágenes — Acción 2 (image-tracker.js) rule-image-tracker-action-image-tracker-js

/*
 * AEM Asset Insights
 */

document.querySelectorAll('[data-aem-asset-id]').forEach(function(element) {
    assetAnalytics.core.assetLoaded(element);
    var parent = element.parentElement;
    if (parent.nodeName == "A") {
        parent.addEventListener("click", function() {
            assetAnalytics.core.assetClicked(this)
        });
    }
});
  • assetAnalytics.core.assetLoaded() : se invoca al completar la carga de la página y es déclencheur Asset Impression para todas las imágenes a las que se puede realizar un seguimiento
  • Variable de Analytics que lleva la lista de recursos cargados: contextData["c.a.assets.idList"]
  • assetAnalytics.core.assetClicked() : se invoca cuando el elemento DOM del recurso tiene una etiqueta de anclaje con un valor href válido. Cuando se hace clic en un recurso, se crea una cookie con el ID del recurso en el que se hizo clic como su valor.(Nombre de la cookie: a.assets.clickedid)
  • Variable de Analytics que lleva la lista de recursos cargados: contextData["c.a.assets.clickedid"]
  • Fuente de origen: contextData['c.a.assets.source']

Instrucciones de depuración de consola console-debug-statements

// Tags build info
_satellite.buildInfo

//Enables debug messages
_satellite.setDebug(true);

//Asset Insight JavaScript Object
assetAnalytics

//List of trackable images
document.querySelectorAll(".cmp-image__image");

En el vídeo se hace referencia a dos extensiones de explorador Google Chrome como formas de depurar Analytics. Extensiones similares están disponibles para otros navegadores también.

Parte 5: Prueba del seguimiento analítico y sincronización de datos de perspectiva analytics-tracking-asset-insights

AEM Configuración del programador de trabajos de sincronización de Asset Reporting y el informe de perspectivas de recursos

recommendation-more-help
a483189e-e5e6-49b5-a6dd-9c16d9dc0519