Adobe Analytics e Adobe Experience Manager (AEM) sono entrambe soluzioni di Adobe Marketing Cloud.
Adobe Analytics può essere configurato per AEM Communities in modo che, quando un membro interagisce con le funzioni Community supportate, gli eventi vengano inviati Adobe Analytics da cui vengono generati i rapporti.
Ad esempio, quando un membro di un sito community di abilitazione visualizza una risorsa video assegnata, il lettore delle risorse invia eventi ad Analytics, inclusi i dati heartbeat video. Dal sito della community, gli amministratori possono visualizzare vari rapporti sulla riproduzione del video.
Inoltre, l'analisi è necessaria per:
Nell’ambiente di pubblicazione:
Nell’ambiente di authoring:
Le funzioni Community supportate includono:
Questa sezione della documentazione descrive come collegare una suite di rapporti di Analytics alle funzioni di Communities. I passaggi di base sono:
Replicare la chiave di crittografia per garantire che la crittografia/decrittografia si verifichi correttamente su tutte le istanze AEM
Preparare una Adobe Analytics suite di rapporti
Abilita analisi per un sito community
VerifyAnalytics per AEM mappatura variabile
Identificare editore principale
Configura importazione di dati del report da Adobe Analytics al sito della community
Per configurare le funzioni di Analytics for Communities, è necessario collaborare con il rappresentante commerciale di riferimento per impostare un account Adobe Analytics e suite di rapporti. Una volta stabilite, devono essere disponibili le seguenti informazioni:
Nome società
Società associata all'account Adobe Analytics .
Nome utente
Nome utente di accesso per l'utente autorizzato a gestire l'account Analytics
(devono includere i privilegi di accesso al servizio Web).
Password
La password di accesso per l’utente autorizzato.
Centro dati di Analytics
L'URL del centro dati di Analytics per l'account.
Suite di rapporti
Nome della suite di rapporti di Analytics da utilizzare.
Utilizzando il Report Suite Manager di Adobe Marketing Cloud, le suite di rapporti di Analytics possono essere configurate in modo che un sito community possa essere abilitato per fornire rapporti per le funzioni Community.
Effettuando l'accesso a Adobe Experience Cloud con Nome società e Nome utente, è possibile configurare una suite di rapporti nuova o esistente in modo che abbia:
11 Variabili di conversione (eVar)
evar1
tramite evar11
abilitato
Può riadattare (rinominare) le eVar esistenti o crearne di nuove da utilizzare per le funzioni Community
7 Eventi di successo (eventi)
event1
tramite event7
abilitato
tipo Counter
Counter (no subrelations)
Può riadattare (rinominare) gli eventi esistenti o crearne di nuovi da utilizzare per le funzioni Community
Video Reporting console
Video Core
Console di misurazione video
Use Solution Variables
Se utilizzate una nuova suite di rapporti, tenete presente che una nuova suite di rapporti può contenere solo 4 variabili evar e 6 variabili evento, mentre per le community sono necessarie 11 variabili evar e 7 variabili evento.
Se si utilizza una suite di rapporti esistente, potrebbe essere necessario modificare la mappatura della variabile](#modifying-analytics-variable-mapping) prima di attivare il framework Analytics per un sito community.[
Contatta il tuo rappresentante commerciale per qualsiasi dubbio sulle variabili dedicate alle Community.
Se si utilizza una suite di rapporti esistente che utilizza già variabili all'interno di
Da evar1
a evar11
Da event1
a event7
Quindi, prima della pubblicazione del sito community, è importante ripristinare la mappatura preesistente spostando le variabili AEM che venivano automaticamente mappate sulle variabili Analytics quando Analytics era abilitato per un sito community.
Per ripristinare la mappatura preesistente e spostare AEM variabili in altre variabili Analytics, consulta la sezione su Modifica della mappatura delle variabili Analytics.
In caso contrario si potrebbe determinare una perdita di dati non recuperabile.
Quando viene concessa la licenza di Video Heartbeat Analytics, viene assegnato un Marketing Cloud Org Id
.
Per abilitare la generazione di report Video Heartbeat dopo la configurazione della suite di rapporti Analytics per la generazione di report video:
Marketing Cloud Org Id
al sito della communityLa Marketing Cloud Org Id
può essere inserita al momento della creazione del sito community o successivamente mediante la modifica delle proprietà del sito community.
Quando Video Heartbeat Analytics è abilitato, il codice JavaScript (JS) per il lettore video crea un'istanza del codice libreria heartbeat video (anche in JS) che gestisce tutte le logiche per l'invio di aggiornamenti dello stato video ai server di tracciamento video di Analytics ogni 10 secondi (non configurabile) e alla fine invia un rapporto cumulativo della sessione video ai server Analytics principali.
Se non è attivato, il codice heartbeat video non viene mai istanziato e solo l'avanzamento video e il tracciamento della posizione di ripresa vengono memorizzati nell'SRP per il reporting.
Per creare una nuova integrazione di Analytics, che integra Adobe Analytics con il sito della community AEM, utilizzando l'interfaccia utente standard nell'istanza di creazione:
[+]
accanto a Configurazioni disponibili per creare una nuova configurazioneNella finestra di dialogo Crea configurazione, i valori da immettere identificano la configurazione.
Titolo
(Obbligatorio) Un titolo di visualizzazione per la configurazione.
Ad esempio, immettete Enablement Community Analytics
Nome
(Facoltativo) Se non viene specificato, per impostazione predefinita il nome verrà impostato su un nome di nodo valido derivato dal titolo.
Ad esempio, immettere community
Modello
Seleziona Adobe Analytics Configuration
Seleziona Crea
Analytics Settings
La creazione iniziale di una nuova configurazione di Analytics determina la visualizzazione della configurazione e una nuova finestra di dialogo per l'immissione delle impostazioni di Analytics. Questa finestra di dialogo richiede le informazioni preliminari sull'account ottenute dal rappresentante dell'account.
Azienda
Società associata all'account Adobe Analytics .
Nome utente
Il nome utente di accesso per l'utente autorizzato a gestire l'account Analytics.
Password
La password di accesso per l’utente autorizzato.
Datacenter
Selezionate il centro dati di Analytics in cui è distribuita la suite di rapporti.
Non aggiungere tag di tracciamento alla pagina
Mantieni come predefinito (deselezionato).
Usa AppMeasurement
Mantieni come predefinito (deselezionato).
Non importare di notte le impression della pagina (creazione)
Mantieni come predefinito (deselezionato).
Non importare di notte le impression della pagina (pubblicazione)
Mantieni come predefinito (deselezionato).
Per salvare le impostazioni:
Seleziona Connetti ad Analytics
In caso contrario,
Selezionare OK.
Dopo aver configurato correttamente la connessione di base a Adobe Analytics, è necessario creare o modificare un framework per il sito community. Lo scopo del framework è mappare le variabili delle funzioni (AEM) di Communities alle variabili di Analytics (suite di rapporti).
Selezionate l'icona [+]
accanto a Framework disponibili per creare un nuovo framework
Titolo
(Obbligatorio) Titolo visualizzato per il framework
Ad esempio, immettere Enablement Community Framework.
Nome
(Facoltativo) Se non viene specificato, per impostazione predefinita il nome verrà impostato su un nome di nodo valido derivato dal titolo.
Ad esempio, immettere community.
Modello
Seleziona Adobe Analytics Framework
.
Seleziona Crea.
La creazione di Analytics Framework consente di aprire il framework per la configurazione.
Lo scopo del framework è quello di mappare AEM variabili alle variabili di Analytics (eVar ed eventi). Le variabili Analytics disponibili per la mappatura sono definite nella suite di rapporti.
Selezionate la suite di rapporti impostata per il reporting video.
Se una suite di rapporti non è ancora stata creata o non è stata configurata correttamente, consulta la sezione precedente:
Adobe Analytics Report Suite for Video Reporting
La barra laterale non è necessaria e può essere ridotta a icona in modo da non ostacolare l’accesso alle impostazioni Suite di rapporti.
Selezionare Aggiungi elemento +.
Vengono visualizzate due caselle a discesa.
Scegliere Report suite.
Le suite di rapporti associate all'account Società sono disponibili per la selezione.
Selezionare Sì nella finestra di dialogo che si apre:
Load default server settings?
Do you want to load the default server settings and overwrite current values in the Server section?
Scegliete un elemento Run Mode
.
Selezionate Pubblica.
Il servizio e il framework di Analytics Cloud ora sono completi. Le mappature verranno definite dopo la creazione di un sito community con il servizio Analytics abilitato.
Per aggiungere il servizio cloud di Analytics durante la creazione di un nuovo sito community:
Nel passaggio 3, nella scheda ANALYTICS:
Facoltativamente, tornate alla configurazione del framework Analytics per regolare le mappature delle variabili.
Per aggiungere il servizio cloud di Analytics a un sito community esistente:
Andate alla console Community > Siti.
Selezionate l'icona Modifica sito della community.
Selezionare le IMPOSTAZIONI.
Nella sezione Analisi:
Facoltativamente, tornate alla configurazione del framework Analytics per regolare le mappature delle variabili.
Affinché il monitoraggio e l'importazione di Analytics funzioni correttamente per un sito community, è necessario che sia presente un elemento di pagina con gli attributi scf-js-site-title
class e href. Nella pagina dovrebbe esistere un solo elemento di questo tipo, ad esempio in uno script sitepage.hbs
non modificato per un sito community. Il valore di siteUrl
viene estratto e inviato a Adobe Analytics come percorso del 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 sovrappone lo script sitepage.hbs
, accertatevi che l'elemento sia presente. La variabile siteUrl
verrà impostata quando viene eseguito il rendering sul server prima di distribuirla al client.
Per un sito AEM generico che include componenti Community, ma non viene creato con la procedura guidata di 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
, utilizza:
<div
class="navbar-brand scf-js-site-title"
href="/content/my/company/en.html"
style="visibility: hidden;"
>
</div>
Analytics viene utilizzato automaticamente per diverse funzioni Community.
La configurazione OSGi dell'ambiente di authoring, AEM Communities Analytics Component Configuration
fornisce un elenco dei componenti che sono stati strumentalizzati per Analytics. La mappatura automatica delle variabili è determinata dai componenti elencati.
Se vengono creati nuovi componenti personalizzati dotati di strumenti per Analytics, questi devono essere aggiunti a questo elenco di componenti configurati.
I componenti del giornale di registrazione vengono utilizzati per implementare la funzione blog.
Una volta salvato il sito community con Analytics abilitato e selezionato il framework di configurazione cloud, le variabili AEM verranno mappate automaticamente sulle eVar e sugli eventi di Analytics a partire rispettivamente da evar1 ed event1 e con un incremento di 1.
Se utilizzate una suite di rapporti esistente che ha mappato una qualsiasi delle variabili all'interno di evar1 attraverso evar11 e event1 tramite event7, sarà necessario modificare le variabili AEM e ripristinare la mappatura originale.
Di seguito è riportato un esempio di mappature predefinite dopo aver seguito l' esercitazione introduttiva:
Tipo di abilitazione Resource |
Titolo del sito |
Tipo funzione |
Titolo gruppo |
Percorso gruppo |
Tipo UGC |
Titolo UGC |
Utente (membro) |
Percorso UGC |
Percorso Site |
|
eVar1 | eVar 2 | eVar 3 | eVar 4 | eVar 5 | eVar 6 | eVar 7 | eVar 8 | eVar 9 | eVar10 | |
event1 Riproduzione risorse |
(a) | - | - | - | - | - | - | - | i) | - |
event2 SCFView |
a) | b) | c) | (d) | (e) | (f) | (g) | (h) | i) | j) |
event3 SCFCreate (Post) |
- | b) | c) | d) | e) | f) | g) | h) | i) | j) |
event4 SCFFollow |
- | b) | c) | d) | e) | f) | g) | h) | i) | j) |
event5 SCFVoteUp |
- | b) | c) | d) | e) | f) | g) | h) | i) | j) |
event6 SCFVoteDown |
- | b) | c) | d) | e) | f) | g) | h) | i) | j) |
event7 SCFRate |
- | b) | c) | d) | e) | f) | g) | h) | i) | j) |
Esempi per valori eVar:
Tipo MIME: video/mp4
titolo del sito community: Geometrixx
nome funzione community: Forum
nome gruppo community: Escursione
percorso del contenuto del gruppo community: /content/sites/<site name>/en/groups/hiking
UGC component resourceType: social/forum/components/hbs/topic
Titolo del componente UGC: Argomenti relativi all'escursione
login (authorizableId): aaron.mcdonald@mailinator.com
Percorso SRP per UGC: /content/usergenerated/asi/.../forum/jmtz-topic3
o
percorso del componente da seguire: /content/sites/<site name>/en/jcr:content/content/primary/forum
percorso del contenuto del sito community: /content/sites/<site name>/en
La mappatura di eVar ed eventi di Analytics su variabili AEM è visibile dalla configurazione del framework dopo che Analytics è abilitato per un sito community.
Dopo l'abilitazione di Analytics e prima della pubblicazione del sito community, la mappatura può essere modificata nel framework trascinando l'evento o l'evento Analytics desiderato dalla barra a sinistra e rilasciandolo nella riga corrispondente nella tabella di mappatura.
Per evitare mappature duplicate, accertatevi di rimuovere la variabile evar o l'evento Analytics sostituito dalla riga posizionando il puntatore del mouse sopra di essa e selezionando la "X" che appare a destra dell'elemento della variabile Analytics.
Se eVar ed eventi Community sovrascrivono mappature pre-esistenti nella suite di rapporti, quindi per evitare la perdita di dati, assegna le variabili AEM per le funzionalità Community ad altre eVar o eventi di Analytics e ripristina le mappature originali.
È importante rimappare prima che il sito della community sia pubblicato con Analytics abilitato, altrimenti esiste il rischio di perdita di dati.
È consigliabile verificare la mappatura delle variabili prima di pubblicare il sito community, che pubblica anche il servizio e il framework cloud di Analytics.
Vedere sezioni:
Se si utilizza una suite di rapporti esistente che utilizza già variabili all'interno di
Da evar1
a evar11
Da event1
a event7
Prima della pubblicazione del sito della community, è importante ripristinare la mappatura preesistente e spostare le variabili Community AEM che sono state mappate automaticamente (quando Analytics era abilitato per il sito della community) ad altre variabili Analytics. La nuova mappatura deve essere coerente tra tutti i componenti Community.
In caso contrario si potrebbe determinare una perdita di dati non recuperabile.
Se la distribuzione scelta è una farm di pubblicazione, un'istanza di pubblicazione AEM deve essere identificata come editore principale per il polling Adobe Analytics per i dati del report da scrivere in SRP.
Per impostazione predefinita, la configurazione AEM Communities Publisher Configuration
OSGi identifica l’istanza di pubblicazione come editore principale, in modo che tutte le istanze di pubblicazione in una farm di pubblicazione si identifichino automaticamente come principale.
Pertanto, è necessario modificare la configurazione in tutte le istanze di pubblicazione secondarie per deselezionare la casella di controllo Principale Editore.
Per istruzioni specifiche, vedere la sezione relativa all'editore principale di Implementazione di Communities.
È importante che l’editore principale sia configurato in modo da impedire il polling da più istanze di pubblicazione.
Le credenziali Adobe Analytics sono crittografate. Per facilitare la replica o la trasmissione di credenziali di analisi crittografate tra autori e editori, tutte AEM istanze devono condividere la stessa chiave di crittografia primaria.
A tal fine, seguire le istruzioni riportate in Replicare la chiave di crittografia.
Una volta che il servizio cloud di Analytics è stato abilitato per un sito community e, se necessario, la mappatura di Analytics AEM variabili è stata modificata, è necessario replicare la configurazione nell'ambiente di pubblicazione (ri)pubblicando il sito community.
La configurazione OSGi dell'autore e dell'editore principale , AEM Communities Analytics Report Management
, viene utilizzata per eseguire query in Analytics.
In fase di creazione, le query sono per report in tempo reale.
Nell'editore principale, le query vengono utilizzate per fornire informazioni in preparazione all'importazione di dati Analytics da parte dell'importatore di report.
L'intervallo di query predefinito è 10 secondi.
Dopo la pubblicazione di un sito community abilitato per Analytics, la configurazione OSGi dell'editore principale, AEM Communities Analytics Report Importer
può essere configurata per impostare l'intervallo di polling predefinito per le configurazioni che non sono configurate singolarmente in CRXDE.
L'intervallo di polling controlla la frequenza delle richieste inviate a Adobe Analytics per estrarre e salvare i dati in SRP.
Quando i dati possono essere classificati come "grandi dati", sondaggi più frequenti potrebbero mettere un carico elevato sul sito della comunità.
Il polling predefinito Intervallo di importazione è impostato su 12 ore.
Al momento, 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 forum è attualmente l'unico esempio di questa personalizzazione:
Nell'editore principale, effettuate l'accesso con privilegi amministrativi.
Passare a CRXDE Lite. Ad esempio, https://localhost:4503/crx/de.
Sotto il nodo jcr:content della directory principale della lingua (ad esempio /content/sites/engage/en/jcr:content),
andate al componente configurato per il reporting di Analytics.
Esempio, analytics/reportConfigs/social_forum_components_hbs_topic
Osservate i periodi di tempo creati:
last30Days
last90Days
thisYear
Osservate il nodo total
.
interval
ha la priorità sull'intervallo di importazione dei report.Adobe Analytics fornisce API che consentono di accedere, esportare ed eliminare dati utente. Per ulteriori informazioni, vedere Invia richieste di accesso ed eliminazione.