Integrazione

Configurare Asset Insights con AEM Assets e Adobe Experience Platform Launch

Ultimo aggiornamento: 2024-01-26
  • Argomenti:
  • Asset Insights
    Visualizza ulteriori informazioni su questo argomento
  • Creato per:
  • Intermediate
    Developer

AEM Assets as a Cloud Service, AEM Assets 6.5

In questa serie video in cinque parti, esaminiamo l’impostazione e la configurazione di Asset Insights per un Experience Manager implementato tramite Adobe Launch.

Parte 1: Panoramica di Asset Insights

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

Diagramma architettura

Diagramma architettura

ATTENZIONE

Assicurati di scaricare versione più recente dei Componenti core per la tua implementazione.

Il video utilizza i Componenti core v2.2.2, che non è la versione più recente; assicurati di utilizzare la versione più recente prima di procedere alla sezione successiva.

Parte 2: Abilitazione del tracciamento di Informazioni su risorse per il componente Immagine di esempio

Sono stati apportati miglioramenti ai componenti core e all’utilizzo del componente proxy (componente immagine di esempio) per Informazioni su risorse. Modifica dei criteri del modello della pagina di contenuto per abilitare il componente immagine di esempio per il sito di riferimento.

NOTA

Il componente core Immagine include la funzionalità di disabilitazione del tracciamento UUID disabilitando il tracciamento dell’UUID della risorsa (valore di identificatore univoco per un nodo creato in JCR)

Il componente core Immagine 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 core con le seguenti modifiche.

  • Elimina il data-asset-id dal div padre di un elemento <img> all’interno del file image.html
  • Aggiunte data-aem-asset-id direttamente all’elemento <img> all’interno di image.html
  • Aggiunte data-trackable='true' all'elemento <img> all'interno di image.html
  • data-aem-asset-id e data-trackable='true' sono mantenuti allo stesso livello di nodo
NOTA

data-aem-asset-id='image.UUID' e data-trackable='true' sono gli attributi chiave che devono essere presenti per Asset Impression. Per Informazioni sul clic delle risorse, oltre agli attributi di dati indicati sopra presenti nel tag <img> , il tag principale deve avere un valore href valido.

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

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

NOTA

La raccolta dei dati in tempo reale e il reporting delle risorse AEM devono essere abilitati per la suite di rapporti Adobe Analytics. L’abilitazione di AEM Asset Reporting riserva le variabili di analisi per il tracciamento degli insight sulle risorse.

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

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

Parte 4: Utilizzo di Adobe Experience Platform Launch per aggiungere l’estensione Adobe Analytics

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

NOTA

Assicurati di replicare tutte le modifiche dall’istanza di authoring a quella di pubblicazione.

Regola 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 pagina implementa due callback (registrati in asset-embed-code)

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

Infine, il tracciamento delle pagine implementa una funzione di inizializzazione come.

  • &lt;code>assetAnalytics.dispatcher.init()&lt;code> : chiamato per inizializzare il componente di tracciamento pagina. Questo DEVE essere richiamato prima che uno qualsiasi degli eventi di approfondimento delle risorse (impressioni e/o clic) venga generato dalla pagina web.
  • &lt;code>assetAnalytics.dispatcher.init()&lt;code> : accetta facoltativamente un oggetto AppMeasurement; se fornito, non tenta di creare un’istanza dell’oggetto AppMeasurement.

Regola 2: Tracciamento immagini — 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);
 }
})();

Regola 2: Tracciamento immagini — 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 completamento del caricamento della pagina e attiva Impression risorse per tutte le immagini tracciabili
  • Variabile di Analytics contenente l’elenco di risorse caricato: contextData["c.a.assets.idList"]
  • assetAnalytics.core.assetClicked() : viene richiamato quando l’elemento DOM della risorsa ha un tag di ancoraggio con valore href valido. Quando si fa clic su una risorsa, viene creato un cookie il cui valore è l’ID della risorsa selezionata.(Nome cookie: a.assets.clickedid)
  • Variabile di Analytics contenente l’elenco di risorse caricato: 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, due estensioni del browser Google Chrome vengono utilizzate come riferimento per il debug di Analytics. Estensioni simili sono disponibili anche per altri browser.

È inoltre possibile passare da DTM alla modalità di debug con la seguente estensione di Chrome: Launch e switch DTM. In questo modo è più facile verificare la presenza di errori relativi all’implementazione di DTM. Inoltre, puoi passare manualmente da DTM alla modalità di debug tramite qualsiasi browser strumento per sviluppatori -> Console JS aggiungendo il seguente frammento:

Parte 5: Verifica del tracciamento analitico e sincronizzazione dei dati di approfondimento

Configurazione del report AEM Asset Reporting Sync Job Scheduler e del report Assets Insights

In questa pagina