Configurazione di Analytics per le funzioni di Communities analytics-configuration-for-communities-features

Panoramica overview

Adobe Analytics e Adobe Experience Manager (AEM) sono entrambe soluzioni di Adobe Experience Cloud.

Adobe Analytics può essere configurato per AEM Communities in modo che, quando un membro interagisce con le funzioni di Communities supportate, gli eventi vengano inviati ad Adobe Analytics da cui vengono generati i rapporti.

Ad esempio, dal sito della community, gli amministratori possono visualizzare vari rapporti relativi alla riproduzione del video.

Inoltre, Analytics è necessario per:

Le funzioni supportate per Communities includono:

Questa sezione della documentazione descrive come collegare una suite di rapporti di Analytics con le funzioni di Communities. I passaggi di base sono i seguenti:

Prerequisiti prerequisites

Per configurare le funzionalità di Analytics for Communities, è necessario collaborare con il rappresentante del tuo account per impostare un account Adobe Analytics e una suite di rapporti. Una volta stabilite, dovrebbero essere disponibili le seguenti informazioni:

Suite di rapporti Adobe Analytics per reporting video adobe-analytics-report-suite-for-video-reporting

Utilizzando la Gestione suite di rapporti di Adobe Experience Cloud, è possibile configurare le suite di rapporti di Analytics in modo che un sito community possa essere abilitato per fornire rapporti per le funzioni di Communities.

Effettuando l'accesso a Adobe Experience Cloud con Nome società e Nome utente, è possibile configurare una suite di rapporti nuova o esistente con:

Se utilizzi una nuova suite di rapporti, una nuova suite di rapporti può contenere solo 4 eVar e 6 variabili evento, mentre per le community sono necessarie 11 e 7 variabili evento.

Se utilizzi una suite di rapporti esistente, potrebbe essere necessario modificare la mappatura delle variabili prima di attivare il framework Analytics per un sito community.

Contatta il rappresentante del tuo account per eventuali problemi relativi alle variabili dedicate alle community.

Video Heartbeat Analytics video-heartbeat-analytics

Quando Video Heartbeat Analytics è concesso in licenza, viene assegnato Marketing Cloud Org Id.

Per abilitare il reporting Video Heartbeat dopo la configurazione della suite di rapporti Analytics per il reporting video:

Marketing Cloud Org Id può essere immesso al momento della creazione del sito community o successiva modifica le proprietà del sito community.

Quando Video Heartbeat Analytics è abilitato, il codice JavaScript (JS) del lettore video crea un’istanza del codice libreria heartbeat video (anche in JS). Il codice gestisce tutte le logiche per l’invio degli aggiornamenti dello stato video ai server di tracciamento video di Analytics ogni 10 secondi (non configurabile). Alla fine invia un rapporto cumulativo della sessione video ai server principali di Analytics.

Se non è abilitata, non viene mai creata un'istanza del codice heartbeat video e solo l'avanzamento video e il tracciamento della posizione di ripresa vengono salvati in modo permanente in SRP per il reporting.

Configurazione servizio Analytics Cloud AEM aem-analytics-cloud-service-configuration

Per creare un’integrazione Analytics, che integri Adobe Analytics con il sito della community AEM, utilizzando l’interfaccia utente standard nell’istanza di authoring:

Finestra di dialogo Crea configurazione create-configuration-dialog

Nella finestra di dialogo Crea configurazione, i valori da immettere identificano la configurazione.

Finestra di dialogo Impostazioni di Analytics analytics-settings-dialog

La creazione iniziale di una nuova configurazione di Analytics comporta la visualizzazione della configurazione e una nuova finestra di dialogo per l’immissione delle impostazioni di Analytics. Questa finestra di dialogo richiede le informazioni sui prerequisiti ottenute dal rappresentante dell'account.

Per salvare le impostazioni:

Crea framework create-framework

Dopo aver configurato correttamente la connessione di base ad Adobe Analytics, è necessario creare o modificare un framework per il sito community. Lo scopo del framework è quello di mappare le variabili della funzione Communities (AEM) alle variabili di Analytics (suite di rapporti).

La creazione del framework di Analytics apre il framework per la configurazione.

Configurazione framework analisi AEM aem-analytics-framework-configuration

Lo scopo del framework è quello di mappare le variabili AEM alle variabili Analytics (eVar ed eventi). Le variabili di Analytics disponibili per la mappatura sono definite nella suite di rapporti.

Seleziona suite di rapporti select-report-suite

Seleziona la suite di rapporti che è stata configurata per il reporting video.

Se una suite di rapporti non è ancora stata creata o non è configurata correttamente, vedi la sezione precedente:
Suite di rapporti Adobe Analytics per reporting video

Il Sidekick non è necessario e può essere ridotto a icona in modo da non ostacolare l’accesso alle impostazioni delle suite di rapporti.

Finestra di dialogo Suite di rapporti prima e dopo aver selezionato "Aggiungi elemento" report-suites-dialog-before-and-after-selecting-add-item

Il servizio cloud Analytics e il framework sono stati completati. Le mappature vengono definite dopo la creazione di un sito community con questo servizio Analytics abilitato.

Abilitare Analytics per un sito community enable-analytics-for-a-community-site

Abilita per nuovo sito community enable-for-new-community-site

Per aggiungere il servizio Analytics Cloud durante la creazione di un sito community:

Abilita per sito community esistente enable-for-existing-community-site

Per aggiungere il servizio Analytics Cloud a un sito community esistente:

Abilita per siti personalizzati enable-for-customized-sites

Affinché il tracciamento e l'importazione di Analytics funzionino correttamente per un sito community, è necessario che sia presente un elemento pagina con la classe scf-js-site-title e gli attributi href. Nella pagina deve essere presente un solo elemento di questo tipo, come nel caso di uno script sitepage.hbs non modificato per un sito community. Il valore di siteUrl viene estratto e inviato ad Adobe Analytics come percorso sito.

# present in default sitepage.hbs
# only one scf-js-site-title class should be included
# this example sets it to be hidden as it serves no visual purpose
<div
    class="navbar-brand scf-js-site-title"
    href="{{siteUrl}}.html"
    style="visibility: hidden;"
>
</div>

Per un sito community personalizzato che si sovrappone allo script sitepage.hbs, verificare che l'elemento sia presente. La variabile siteUrl viene impostata quando viene riprodotta sul server prima di essere trasmessa al client.

Per un sito AEM generico che include componenti di Communities ma non è stato creato con la procedura guidata per la creazione del sito, è necessario aggiungere l'elemento. Il valore di href deve essere il percorso del sito. Ad esempio, se il percorso del sito è /content/my/company/en, utilizzare:

<div
    class="navbar-brand scf-js-site-title"
    href="/content/my/company/en.html"
    style="visibility: hidden;"
>
</div>

Funzioni di Analytics per Communities analytics-for-communities-features

Analytics viene utilizzato automaticamente per diverse funzioni di Communities.

La configurazione OSGi dell'ambiente di authoring, AEM Communities Analytics Component Configuration, fornisce un elenco dei componenti instrumentati per Analytics. La mappatura automatica delle variabili è determinata dai componenti elencati.

Se vengono creati nuovi componenti personalizzati instrumentati per Analytics, questi devono essere aggiunti a questo elenco di componenti configurati.

Configurazione componente component-configuration

Analisi mappata alle variabili AEM mapped-analytics-to-aem-variables

Dopo il salvataggio del sito community, con Analytics abilitato e il framework di configurazione cloud selezionato, le variabili AEM vengono mappate automaticamente sulle eVar e sugli eventi di Analytics. Inizia rispettivamente con evar1 ed event1 e viene incrementato di 1.

Se si utilizza una suite di rapporti esistente che ha mappato una qualsiasi delle variabili all'interno di evar1 fino a evar11 ed event1 fino a event7, diventa necessario rimappare le variabili AEM e ripristinare la mappatura originale.

Di seguito è riportato un esempio di mappature predefinite:

Mappa delle eVar inviate con ogni evento map-of-evars-sent-with-each-event

Esempi per valori eVar:

Modifica della mappatura delle variabili di Analytics modifying-analytics-variable-mapping

La mappatura di eVar ed eventi di Analytics alle variabili AEM è visibile dalla configurazione del framework dopo l’abilitazione di Analytics per un sito community.

Dopo l'abilitazione di Analytics e prima della pubblicazione del sito community, la mappatura può essere modificata nel framework. Trascina la eVar o l’evento di Analytics desiderato dalla barra a sinistra e rilascialo nella riga pertinente nella tabella di mappatura.

Per evitare mappature duplicate, assicurati di rimuovere l’evar o l’evento Analytics sostituito dalla riga passando con il mouse sopra di esso e selezionando la "X" che appare a destra dell’elemento variabile Analytics.

Se le eVar e gli eventi di Communities sovrascrivono le mappature preesistenti nella suite di rapporti, per evitare perdite di dati assegna le variabili AEM per le funzioni Communities ad altre eVar o eventi di Analytics e ripristina le mappature originali.

Esempio di passaggio 1: trascinare Analytics evar14 nella tabella di mappatura example-step-dragging-analytics-evar-into-mapping-table

Esempio di passaggio 2: selezione di "x" per rimuovere evar11 sostituito example-step-selecting-x-to-remove-replaced-evar

Esempio di passaggio 3: AEM var eventdata.siteId rinominato in Analytics evar14 example-step-aem-var-eventdata-siteid-remapped-to-analytics-evar

Pubblicazione del sito community publishing-the-community-site

Verificare la mappatura delle variabili da Analytics a AEM verify-analytics-to-aem-variable-mapping

È consigliabile verificare la mappatura delle variabili prima di pubblicare il sito community, che pubblica anche il servizio e il framework di Analytics Cloud.

Vedere le sezioni:

Editore primario primary-publisher

Se la distribuzione scelta è una farm di pubblicazione, è necessario identificare un'istanza di pubblicazione AEM come editore principale per il polling di Adobe Analytics per i dati del report da scrivere in SRP.

Per impostazione predefinita, la configurazione OSGi AEM Communities Publisher Configuration identifica la propria istanza di pubblicazione come editore principale, in modo che tutte le istanze di pubblicazione in una farm di pubblicazione si identifichino autonomamente come principale.

È pertanto necessario modificare la configurazione in tutte le istanze di pubblicazione secondarie per deselezionare la casella di controllo Editore primario.

Per istruzioni specifiche, vedere la sezione relativa all'editore principale di Distribuzione delle community.

Replica la chiave di crittografia replicate-the-crypto-key

Le credenziali di Adobe Analytics sono crittografate. Per facilitare la replica o la trasmissione delle credenziali di analisi crittografate tra l’autore e gli editori, tutte le istanze AEM devono condividere la stessa chiave di crittografia primaria.

A tale scopo, seguire le istruzioni in Replica la chiave di crittografia.

Sito della community Publish e servizio Analytics Cloud publish-community-site-and-analytics-cloud-service

Dopo che il servizio Analytics Cloud è stato abilitato per un sito community e, se necessario, la mappatura delle variabili da Analytics a AEM è stata regolata, replicare la configurazione nell'ambiente di pubblicazione (ri)pubblicando il sito community.

Ottenimento di rapporti da Analytics obtaining-reports-from-analytics

Gestione dei rapporti report-management

La configurazione OSGi, AEM Communities Analytics Report Management, dell'autore e dell'editore primario viene utilizzata per eseguire query in Analytics.

Per l’autore, le query sono per i rapporti in tempo reale.

Nell’editore principale, le query vengono utilizzate per fornire informazioni in preparazione all’importazione dei dati analitici di Report Importer.

L’intervallo di query predefinito è 10 secondi.

Importazione report report-importer

Dopo la pubblicazione di un sito community abilitato per Analytics, è possibile configurare la configurazione OSGi, AEM Communities Analytics Report Importer, dell'editore primario per impostare l'intervallo di polling predefinito per le configurazioni non configurate singolarmente in CRXDE.

L'intervallo di polling controlla la frequenza delle richieste ad Adobe Analytics per i dati da estrarre e salvare in SRP.

Quando i dati possono essere classificati come "big data", i polling più frequenti possono comportare un carico elevato sul sito della community.

Il polling predefinito Intervallo di importazione è impostato su 12 ore.

Personalizzazione dei rapporti dei componenti component-report-customization

Attualmente, per personalizzare le metriche da monitorare, nell’archivio vengono creati nodi che definiscono i periodi di tempo per i quali generare un rapporto su tale metrica.

L’argomento del forum è attualmente l’unico esempio di questa personalizzazione:

Gestire i dati utente in Analytics manage-user-data-in-analytics

Adobe Analytics fornisce API che ti consentono di accedere, esportare ed eliminare dati utente. Per ulteriori informazioni, vedere Invia richieste di accesso ed eliminazione.

Riferimenti resources