Configurare Asset Insights con AEM Assets e Adobe Experience Platform Launch

In questa serie video in 5 parti, passiamo alla configurazione e alla configurazione di Asset Insights per Experience Manager implementata tramite Adobe Launch.

Parte 1: Panoramica di Asset Insights

Panoramica di Asset Insights Installa i componenti core, i componenti immagine di esempio e altri pacchetti di contenuti per preparare il tuo ambiente.

Diagramma dell'architettura

Il video utilizza i componenti core v2.2.2 che non sono più aggiornati; assicurati di utilizzare la versione più recente prima di passare alla sezione successiva.

• Scarica Contenuto immagine di esempio di Asset Insights
• Scarica i componenti core AEM WCM più recenti

Parte 2 : Abilitazione del tracciamento degli approfondimenti delle risorse per un componente immagine di esempio

Miglioramenti ai componenti core e utilizzo del componente proxy (componente immagine di esempio) per Asset Insights. Modifica dei criteri dei modelli di pagina di contenuto per abilitare il componente immagine di esempio per il sito di riferimento.

Il componente Immagine di base utilizza data-asset-id attributo all'interno dell'elemento padre <div> di un tag immagine per abilitare/disabilitare questa funzione. Il componente Proxy sostituisce il componente principale con le seguenti modifiche.

• Rimuove la data-asset-id dall’elemento div padre di un <img> elemento all’interno di image.html
• Aggiunte data-aem-asset-id direttamente all’ <img> elemento all’interno di image.html
• Aggiunte data-trackable='true' all’ <img> elemento in image.html
• data-aem-asset-id e data-trackable='true' sono mantenuti allo stesso livello di nodo

Parte 3: Adobe Analytics — Creazione di suite di rapporti, abilitazione della raccolta dati in tempo reale e reporting AEM Assets

Per il tracciamento delle risorse viene creata una suite di rapporti con raccolta dati in tempo reale. La configurazione di AEM Assets Insights è configurata utilizzando le credenziali di Adobe Analytics.

Per la configurazione di AEM Assets Insights sono necessarie le seguenti credenziali

• Datacenter
• Nome società di Analytics
• Nome utente di Analytics
• Segreto condiviso (può essere ottenuto da Adobe Analytics > Amministratore > Impostazioni società > Servizio Web).
• Suite di rapporti (accertati di selezionare la suite di rapporti corretta utilizzata per la generazione di rapporti sulle risorse)

Parte 4: Utilizzo di Adobe Experience Platform Launch per l'aggiunta dell'estensione Adobe Analytics

Aggiunta di estensione Adobe Analytics, creazione di regole di caricamento pagina e Integrazione di AEM con Launch con l’account tecnico Adobe IMS.

Articolo 1: Tracciamento pagina (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>

Il tracciamento della pagina implementa due chiamate back (registrate nel codice di incorporamento della risorsa)

• &lt;code>assetAnalytics.core.assetLoaded&lt;code> : chiamato quando viene inviato l’evento "load" per l’elemento asset-DOM-element.
• &lt;code>assetAnalytics.core.assetClic&lt;code> : chiamato quando l’evento "click" viene inviato per l’elemento asset-DOM-element, è pertinente solo quando l’elemento asset-DOM-element ha un tag di ancoraggio come elemento principale con un attributo "href" esterno valido

Infine, Pagetracker implementa una funzione di inizializzazione come.

• &lt;code>assetAnalytics.dispatcher.init()&lt;code> : chiamato per inizializzare il componente Pagetracker. DEVE essere invocato prima che uno qualsiasi degli eventi asset-insights-events (Impression e/o Clic) venga generato dalla pagina web.
• &lt;code>assetAnalytics.dispatcher.init()&lt;code> : facoltativamente accetta un oggetto AppMeasurement: se fornito, non tenta di creare una nuova istanza di oggetto AppMeasurement.

Articolo 2: Tracciamento immagine — Azione 1 (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);
 }
})();

Articolo 2: Tracciamento immagine — Azione 2 (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() : viene richiamato al termine del caricamento della pagina e attiva le impressioni delle risorse per tutte le immagini tracciabili
• Variabile di Analytics con elenco di risorse caricate : contextData['c.a.assets.idList']
• assetAnalytics.core.assetClic() : viene richiamato quando l’elemento DOM della risorsa dispone di un tag di ancoraggio con un valore href valido. Quando fai clic su una risorsa, viene creato un cookie con l’ID della risorsa su cui hai fatto clic come valore.(Nome cookie: a.assets.clickedid)
• Variabile di Analytics con elenco di risorse caricate : contextData['c.a.assets.clickedid']
• Origine : contextData['c.a.assets.source']

Istruzioni di debug della console

//Launch Build Info
_satellite.buildInfo

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

//Asset Insight JS Object
assetAnalytics

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

Nel video vengono indicate due estensioni del browser Google Chrome come modi per eseguire il debug di Analytics. Estensioni simili sono disponibili anche per altri browser.

• Avvia l'estensione Chrome
• Debugger Adobe Experience Cloud

È anche possibile passare DTM in modalità di debug con la seguente estensione Chrome: Avvia e switch DTM. Questo rende più facile vedere se ci sono errori relativi alla distribuzione DTM. Inoltre, puoi passare manualmente DTM alla modalità di debug tramite qualsiasi browser strumenti per sviluppatori -> Console JS aggiungendo il seguente snippet:

Parte 5 : Verifica del tracciamento e della sincronizzazione dei dati di Insight Analytics

Configurazione di AEM Asset Reporting Sync Job Scheduler e del rapporto Assets Insights

Risorse Business.Adobe.com

Auto Text Summarization Content As A Service Dynamic Media Headless Cms Digital Asset Management Digital Signage