Show Menu
ARGOMENTI×

Configurazione di Analytics per le funzioni Community

Panoramica

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 ad Adobe Analytics da cui vengono generati i report.
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:
    • Relazioni sulle tendenze comunitarie
    • Consenti ai visitatori del sito di ordinare per "più visualizzati", "più attivi", "più graditi"
    • Visualizzare i conteggi negli elenchi UGC
  • Nell’ambiente di authoring:
    • Visualizzazione dei dati di partecipazione nella console di gestione dei membri (viste, post, follower, Mi piace)
    • Riepilogo delle tendenze, heartbeat video e dispositivo video per abilitare i rapporti sulle risorse
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:
  1. Replicare la chiave di crittografia per garantire che la crittografia/decrittografia si verifichi correttamente su tutte le istanze di AEM
  2. Preparare una suite di rapporti di Adobe Analytics
  3. Creare un servizio e un framework cloud di AEM Analytics
  4. Abilita Analytics per un sito community
  5. Verifica della mappatura delle variabili di Analytics in AEM
  6. Identificare l'editore principale
  7. Pubblicare il sito della community
  8. Configurare l' importazione di dati del report da Adobe Analytics al sito community

Prerequisiti

Per configurare le funzioni di Analytics for Communities, è necessario collaborare con il rappresentante commerciale di riferimento per configurare un account Adobe Analytics e una suite di rapporti. Una volta stabilite, devono essere disponibili le seguenti informazioni:
  • Nome società
    Società associata all'account Adobe Analytics
  • Nome utente
    Il nome utente di accesso per l'utente autorizzato a gestire l'account Analytics
    (Deve includere i privilegi di accesso al servizio Web)
  • Password
    La password di accesso per l'utente autorizzato
  • Centro dati di Analytics
    URL del centro dati di Analytics per l'account
  • Suite di rapporti
    Nome della suite di rapporti di Analytics da utilizzare

Adobe Analytics Report Suite for Video Reporting

Utilizzando Adobe Marketing Cloud Report Suite Manager , è possibile configurare le suite di rapporti di Analytics in modo che un sito community possa essere abilitato per fornire rapporti per le funzioni Community.
Effettuando l'accesso ad Adobe Marketing Cloud con Nome società e Nome utente , è possibile configurare una suite di rapporti nuova o esistente con:
  • 11 Variabili di conversione (evar)
    • evar1 tramite evar11 abilitato
    • Può riadattare (rinominare) le variabili evar esistenti o crearne di nuove da utilizzare per le funzioni Community
  • 7 Eventi di successo (eventi)
    • event1 tramite event7 abilitato
    • Tipo Counter
      • not Counter (no subrelations)
    • Può riadattare (rinominare) gli eventi esistenti o crearne di nuovi da utilizzare per le funzioni Community
    • Video Reporting console
      • Abilita Video Core
      • Seleziona Salva
    • Console di misurazione video
      • Seleziona Use Solution Variables
      • Seleziona Salva
Se utilizzate una nuova suite di rapporti, tenete presente che una nuova suite di rapporti può contenere solo 4 variabili evar e 6 eventi, mentre per le community sono richieste 11 variabili evar 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 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
  • evar1 through evar11
  • event1 through event7
Prima della pubblicazione del sito della community, è importante ripristinare la mappatura preesistente spostando le variabili AEM che venivano automaticamente mappate sulle variabili Analytics quando Analytics era abilitato per un sito della community.
Per ripristinare la mappatura preesistente e spostare le variabili AEM in altre variabili di Analytics, consulta la sezione sulla modifica della mappatura delle variabili di Analytics.
In caso contrario si potrebbe determinare una perdita di dati non recuperabile.

Video Heartbeat Analytics

Quando viene concessa la licenza di Video Heartbeat Analytics, Marketing Cloud Org Id viene assegnata una licenza.
Per abilitare il reporting Video Heartbeat dopo la configurazione della suite di rapporti Analytics per il reporting video:
L' Marketing Cloud Org Id indicazione può essere effettuata al momento della creazione o successivamente del sito comunitario modificando le proprietà del sito. Configurazione del servizio cloud di AEM Analytics
Quando Video Heartbeat Analytics è abilitato, il codice Javascript (JS) per il lettore video crea un'istanza del codice della libreria heartbeat video (anche in JS) che gestisce tutte le logiche per l'invio di aggiornamenti dello stato dei video ai server di tracciamento video di Analytics ogni 10 secondi (non configurabili) e infine l'invio di 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.

Configurazione del servizio cloud di AEM Analytics

Per creare una nuova integrazione di Analytics, che integra Adobe Analytics con il sito della community AEM, utilizzate l’interfaccia utente standard nell’istanza di creazione:
  • Dalla navigazione globale: Strumenti > Distribuzione > Servizi cloud
  • Scorri verso il basso fino ad Adobe Analytics
  • Selezionate Configura ora o Mostra configurazioni

Finestra di dialogo Crea configurazione

  • Seleziona [+] l'icona accanto a Configurazioni ​disponibili per creare una nuova configurazione
Nella finestra di dialogo Crea configurazione, i valori da immettere identificano la configurazione.
  • Titolo
    (Obbligatorio) 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.
    For example, enter communities
  • Modello
    Seleziona Adobe Analytics Configuration
  • Seleziona Crea
    • Avvia la pagina di configurazione e apre la Analytics Settings finestra di dialogo

Finestra di dialogo Impostazioni analisi

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 account preliminari ottenute dal rappresentante commerciale di riferimento.
  • 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
    Seleziona il centro dati di Analytics in cui risiede la suite di rapporti
  • Non aggiungere tag di tracciamento alla pagina
    Mantieni come predefinito (non selezionato)
  • Usa AppMeasurement
    Mantieni come predefinito (non selezionato)
  • Non importare di notte le impression della pagina (creazione)
    Mantieni come predefinito (non selezionato)
  • Non importare di notte le impression della pagina (pubblicazione)
    Mantieni come predefinito (selezionato)
Per salvare le impostazioni:
  • Seleziona Connetti ad Analytics
    • In caso contrario,
      • Verificare che le voci non contengano spazi iniziali
      • Provare un datacenter diverso
      • Contattare il rappresentante commerciale di riferimento
  • Selezionare OK

Crea framework

Dopo la configurazione corretta della connessione di base ad Adobe Analytics, è necessario creare o modificare un framework per il sito della community. Lo scopo del framework è mappare le variabili delle funzioni Community (AEM) alle variabili 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, immettete 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.
    For example, enter communities
  • Modello
    Seleziona Adobe Analytics Framework
  • Seleziona Crea
La creazione di Analytics Framework apre il framework per la configurazione.

Configurazione del framework AEM Analytics

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

Seleziona 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.

Finestra di dialogo Suite di rapporti prima e dopo la selezione di 'Aggiungi elemento'

  1. Seleziona Aggiungi elemento + vengono visualizzate due caselle a discesa
  2. Scegli una suite Report suite di rapporti associata all'account Società da selezionare
  3. Selezionate 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?
  4. Choose a Run Mode Scegliete 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.

Abilitare Analytics per un sito community

Abilita per nuovo sito community

Per aggiungere il servizio cloud di Analytics durante la creazione di un nuovo sito community:
  • Nel passaggio 3
  • Nella scheda ANALYTICS :
    • Selezionate la casella di controllo Abilita analisi .
    • Scegliete il framework dalla casella a discesa
  • Facoltativamente, tornate alla configurazione del framework Analytics per regolare le mappature delle variabili.

Abilita per sito community esistente

Per aggiungere il servizio cloud di Analytics a un sito community esistente:
  • Passare alla console Community > Siti
  • Selezionate l'icona Modifica sito della community
  • Selezionare le impostazioni
  • Nella sezione Analisi:
    • Selezionate la casella di controllo Abilita analisi .
    • Scegliete il framework dalla casella a discesa
  • Facoltativamente, tornate alla configurazione del framework Analytics per regolare le mappature delle variabili.

Abilita per siti personalizzati

Affinché il tracciamento di Analytics e l'importazione possano funzionare correttamente per un sito community, deve essere presente un elemento 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 sitepage.hbs script non modificato per un sito community. Il valore di siteUrl viene estratto e inviato ad 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 sitepage.hbs script, accertatevi che l'elemento sia presente. La siteUrl variabile viene impostata quando viene eseguito il rendering sul server prima di essere trasmessa 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 , utilizzate:
<div
    class="navbar-brand scf-js-site-title"
    href="/content/my/company/en.html"
    style="visibility: hidden;"
>
</div>

Funzioni di Analytics per community

Analytics viene utilizzato automaticamente per diverse funzioni Community.
La configurazione Configurazione di OSGi 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.

Configurazione componente

Nota: i journal componenti vengono utilizzati per implementare la funzione blog.

Analisi mappata su variabili AEM

Una volta salvato il sito community con Analytics abilitato e selezionato il framework di configurazione cloud, le variabili AEM saranno mappate automaticamente alle variabili e agli eventi di Analytics che iniziano rispettivamente con evar1 ed event1 e aumentano 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 ricompilare le variabili AEM e ripristinare la mappatura originale.
Di seguito è riportato un esempio di mappature predefinite dopo aver seguito l'esercitazione introduttiva :

Mappa delle eVar inviate con ogni evento

Tipo risorsa abilitazione
Titolo sito
Tipo di funzione
Titolo gruppo
Percorso gruppo
Tipo UGC
Titolo UGC
Utente (membro)
Percorso UGC
Percorso sito
eVar1
eVar2
eVar3
eVar4
eVar5
eVar6
eVar7
eVar8
eVar9
eVar10
event1 Resource Play
(a)
-
-
-
-
-
-
-
i)
-
event2SCFView
(a)
b)
c)
(d)
(e)
(f)
(g)
(h)
i)
j)
event3SCFCreate (Post)
-
b)
c)
(d)
(e)
(f)
(g)
(h)
i)
j)
event4SCFFollow
-
b)
c)
(d)
(e)
(f)
(g)
(h)
i)
j)
event5SCFVoteUp
-
b)
c)
(d)
(e)
(f)
(g)
(h)
i)
j)
event6SCFVoteDown
-
b)
c)
(d)
(e)
(f)
(g)
(h)
i)
j)
event7SCFRate
-
b)
c)
(d)
(e)
(f)
(g)
(h)
i)
j)
Esempi per i valori eVar:
  • Tipo MIME:video/mp4
  • Titolo del sito community: Geometrixx Communities
  • Nome funzione community:Forum
  • Nome gruppo community: Escursione
  • Percorso del contenuto del gruppo community: /content/sites/community/it/group/hiking
  • UGC component resourceType : social/forum/components/hbs/topic
  • Titolo del componente UGC: Argomenti relativi all'esecuzione
  • Login (ID autorizzabile): aaron.mcdonald@mailinator.com
  • Percorso SRP per UGC: /content/usergenerated/asi/.../forum/jmtz-topic3 o percorso del componente da seguire : /content/sites/community/it/jcr:content/content/main/forum
  • Percorso del contenuto del sito community: /content/sites/community/it

Modifica della mappatura delle variabili di Analytics

La mappatura delle variabili evar ed eventi di Analytics alle 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 le variabili e gli eventi Community sovrascrivono le mappature pre-esistenti nella suite di rapporti, quindi per evitare la perdita di dati, assegna le variabili AEM per le funzionalità Community ad altre variabili e/o eventi di Analytics e ripristina le mappature originali.
È importante rimappare prima che il sito della community venga pubblicato con Analytics abilitato, altrimenti esiste il rischio di perdita di dati.

Esempio 1: Trascinamento di Analytics evar14 nella tabella di mappatura

Esempio 2: Selezione di 'x' per rimuovere evar11 sostituito

Esempio 3: AEM var eventdata.siteId riassociato ad Analytics evar14

Pubblicazione del sito della community

Verifica della mappatura delle variabili Analytics in AEM

È 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
  • evar1 through evar11
  • event1 through event7
Prima della pubblicazione del sito della community, è importante ripristinare la mappatura preesistente e spostare le variabili AEM di Communities che venivano mappate automaticamente (quando Analytics era abilitato per il sito della community) su 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.

Editore principale

Quando la distribuzione scelta è una farm di pubblicazione, un'istanza di pubblicazione AEM deve essere identificata come editore principale per il polling di Adobe Analytics per i dati del report da scrivere a 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 come principali.
Pertanto, è necessario modificare la configurazione in tutte le istanze di pubblicazione secondarie per deselezionare la casella di controllo Editore ​principale.
Per istruzioni specifiche, consultate la sezione relativa all'editore principale di Distribuzione di Communities .
È importante che l’editore principale sia configurato per impedire il polling da più istanze di pubblicazione.

Replicare la chiave Crypto

Le credenziali di Adobe Analytics sono crittografate. Per facilitare la replica o la trasmissione di credenziali di analisi crittografate tra autori ed editori, tutte le istanze AEM devono condividere la stessa chiave di crittografia master.
A tale scopo, seguire le istruzioni in Replica della chiave di crittografia.

Pubblica sito community e servizio di Analytics Cloud

Dopo che il servizio cloud di Analytics è stato abilitato per un sito community e, se necessario, dopo aver modificato la mappatura delle variabili Analytics in AEM, è necessario replicare la configurazione nell'ambiente di pubblicazione (ri)pubblicando nuovamente il sito community.

Come ottenere report da Analytics

Gestione report

La configurazione Configurazione di OSGi 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.

Importatore report

Dopo la pubblicazione di un sito community abilitato per Analytics, la configurazione Configurazione di OSGi OSGi dell'editore principale può essere configurata AEM Communities Analytics Report Importer 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 ad Adobe Analytics per il pulling e il salvataggio dei dati nell’ SRP .
Quando i dati possono essere classificati come "grandi dati", sondaggi più frequenti potrebbero mettere un carico elevato sul sito della comunità.
L’intervallo predefinito di importazione polling è impostato su 12 ore.

Personalizzazione report componente

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
  • Accesso con privilegi amministrativi
  • Passa a CRXDE Lite
  • Sotto il jcr:content nodo della radice della lingua
    • Ad esempio: /content/sites/engage/en/jcr:content
  • Passa al componente configurato per il reporting di Analytics
    • Ad esempio: analytics/reportConfigs/social_forum_components_hbs_topic
  • Osserva i periodi di tempo creati
    • last30Days
    • last90Days
    • thisYear
  • Osserva il total nodo
    • Modificando la interval proprietà si ignora l'intervallo di Importazione report
    • Il valore è espresso in secondi ed è impostato su 4 ore (14400 secondi)

Gestione dei dati utente in Analytics

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

Risorse