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:
-
Nell’ambiente di pubblicazione:
- Relazioni sulla community tendenze
- Consentire ai visitatori del sito di ordinare per "più visualizzati", "più attivi", "più apprezzati"
- Visualizza conteggi in elenchi UGC (User-Generated Content)
-
Nell’ambiente di authoring:
- Visualizzazione dei dati di partecipazione nel console gestione membri (visualizzazioni, post, segui, mi piace)
- Riepilogo delle tendenze, heartbeat video e dispositivo video per la risorsa di abilitazione rapporti
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:
-
Replica la chiave di crittografia in modo da garantire che la crittografia/decrittografia avvenga correttamente su tutte le istanze AEM
-
Preparare un’Adobe Analytics suite di rapporti
-
Creare un’analisi dell’AEM Servizio cloud e framework
-
Abilita analisi per un sito community
-
Verifica Mappatura delle variabili da Analytics a AEM
-
Identificare editore principale
-
Pubblica il sito community
-
Configura importazione dei dati del rapporto da Adobe Analytics al sito community
Prerequisiti prerequisites
Per configurare le funzioni di Analytics for Communities, è necessario collaborare con il rappresentante del tuo account per impostare un account Adobe Analytics e suite di rapporti. Una volta stabilite, dovrebbero essere disponibili le seguenti informazioni:
-
Nome dell’azienda
Azienda 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
Password di accesso per l'utente autorizzato.
-
Data center di Analytics
L’URL del data center di Analytics per l’account.
-
Suite per report
Nome della suite di rapporti di Analytics da utilizzare.
Suite di rapporti Adobe Analytics per reporting video adobe-analytics-report-suite-for-video-reporting
Utilizzo di Adobe Experience Cloud Report Suite Manager, le suite di rapporti di Analytics possono essere configurate in modo da abilitare un sito community per fornire rapporti sulle funzioni di Communities.
Accedendo 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
da aevar11
abilitato -
Possibilità di riutilizzare (rinominare) le eVar esistenti o crearne di da utilizzare per le funzioni community
-
-
7 eventi di successo (eventi)
-
event1
da aevent7
abilitato -
tipo
Counter
- non
Counter (no subrelations)
- non
-
È possibile riutilizzare (rinominare) gli eventi esistenti o crearne di nuovi da utilizzare per le funzioni di Communities
-
-
-
Console di reporting video
- Attiva
Video Core
- Seleziona Salva
- Attiva
-
Console di misurazione Core video
- Seleziona
Use Solution Variables
- Seleziona Salva
- Seleziona
-
Se si utilizza un nuova suite di rapporti, una nuova suite di rapporti può avere solo 4 e 6 variabili evento, mentre per le community sono necessarie 11 e 7 variabili evento.
Se utilizzi un’ suite di rapporti esistente, può 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.
-
Da
evar1
aevar11
-
Da
event1
aevent7
Video Heartbeat Analytics video-heartbeat-analytics
Quando Video Heartbeat Analytics è concesso in licenza, Marketing Cloud Org Id
è assegnato.
Per abilitare il reporting Video Heartbeat dopo configurazione della suite di rapporti di Analytics per il reporting video:
- Creare un Servizio Analytics Cloud
- Abilita Analytics per un sito community
- Associa
Marketing Cloud Org Id
con il sito community
Il Marketing Cloud Org Id
possono essere inserite al momento del creazione di siti community o in un secondo momento da modifica proprietà del sito community.
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). 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:
- Dalla navigazione globale: Strumenti > Distribuzione > Cloud Service
- Scorri verso il basso fino a Adobe Analytics
- Seleziona Configura ora o Mostra configurazioni
Finestra di dialogo Crea configurazione create-configuration-dialog
- Seleziona
[+]
icona accanto a Configurazioni disponibili in modo da poter creare una configurazione.
Nella finestra di dialogo Crea configurazione, i valori da immettere identificano la configurazione.
-
Titolo
(Obbligatorio) Titolo da visualizzare per la configurazione.
Ad esempio, immetti Analisi community -
Nome
(Facoltativo) Se non viene specificato, per impostazione predefinita il nome corrisponde a un nome di nodo valido derivato dal titolo.
Ad esempio, immetti community -
Modello
Seleziona
Adobe Analytics Configuration
-
Seleziona Crea
- Viene visualizzata la pagina di configurazione dei lanci
Analytics Settings
finestra di dialogo
- Viene visualizzata la pagina di configurazione dei lanci
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 richiede informazioni sui prerequisiti per l'account ottenuti dal rappresentante del conto.
-
Azienda
Azienda associata all’account Adobe Analytics.
-
Nome utente
Il nome utente di accesso per l’utente autorizzato a gestire l’account Analytics.
-
Password
Password di accesso per l'utente autorizzato.
-
Datacenter
Seleziona il data center di Analytics che ospita la suite di rapporti.
-
Non aggiungere tag di tracciamento alla pagina
Lascia come predefinito (deselezionato).
-
Usa AppMeasurement
Lascia come predefinito (deselezionato).
-
Non importare di notte le impression della pagina (creazione)
Lascia come predefinito (deselezionato).
-
Non importare di notte le impression della pagina (pubblicazione)
Lascia come predefinito (deselezionato).
Per salvare le impostazioni:
-
Seleziona Connetti ad Analytics
-
In caso contrario,
- Verificare che le voci non contengano spazi iniziali.
- Prova con un altro centro dati.
-
-
Seleziona OK.
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).
-
Seleziona
[+]
icona accanto a Framework disponibili in modo da poter creare un framework. -
Titolo
(Obbligatorio) Titolo da visualizzare per il framework. Ad esempio, immettere Quadro comunitario.
-
Nome
(Facoltativo) Se non viene specificato, per impostazione predefinita il nome corrisponde a un nome di nodo valido derivato dal titolo.
Ad esempio, immetti community. -
Modello
Seleziona
Adobe Analytics Framework
. -
Seleziona Crea.
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 definito 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
-
Seleziona Aggiungi elemento +.
Vengono visualizzate due caselle a discesa.
-
Scegli un
Report suite.
Le suite di rapporti associate all’account aziendale sono disponibili per la selezione.
-
Seleziona Sì nella finestra di dialogo visualizzata:
code language-none Load default server settings? Do you want to load the default server settings and overwrite current values in the Server section?
-
Scegli un
Run Mode
. -
Seleziona Pubblica.
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 mentre creazione di un sito community:
-
Nel passaggio 3, sotto Scheda ANALYTICS:
- Seleziona la Abilita analisi casella di controllo.
- Selezionare il framework dalla casella a discesa.
-
Se necessario, torna alla configurazione del framework Analytics per regolare le mappature delle variabili.
Abilita per sito community esistente enable-for-existing-community-site
Per aggiungere il servizio Analytics Cloud a una sito community esistente:
-
Accedi a Community > Siti console.
-
Selezionare l'icona Modifica sito del sito community.
-
Selezionare SETTINGS.
-
Nella sezione Analytics:
- Seleziona la Abilita analisi casella di controllo.
- Scegliere il framework dalla casella a discesa.
-
Se necessario, torna alla configurazione del framework Analytics per regolare le mappature delle variabili.
Abilita per siti personalizzati enable-for-customized-sites
Affinché il tracciamento e l'importazione di Analytics funzionino correttamente per un sito community, un elemento di pagina con scf-js-site-title
gli attributi class e href devono essere presenti. Nella pagina deve esistere un solo elemento di questo tipo, come accade in un elemento non modificato sitepage.hbs
script 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 si sovrappone al sitepage.hbs
, verificare che l'elemento sia presente. Il siteUrl
viene impostata quando viene eseguito il rendering sul server prima di servire il client.
Per un sito AEM generico che include i componenti di Communities, ma non viene creato con creazione guidata 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
, quindi utilizza:
<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.
dell’ambiente di authoring Configurazione OSGi, 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 utilizzi 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 ripristina 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 di valori eVar:
-
Tipo MIME: video/mp4
-
titolo del sito community: GEOMETRIXX
-
nome funzione community: Forum
-
nome gruppo community: Trekking
-
percorso del contenuto del gruppo community:
/content/sites/<site name>/en/groups/hiking
-
ResourceType del componente UGC:
social/forum/components/hbs/topic
-
Titolo componente UGC: Argomenti trekking
-
login (authorizableId):
aaron.mcdonald@mailinator.com
-
Percorso SRP a 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
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:
-
Da
evar1
aevar11
-
Da
event1
aevent7
Editore primario primary-publisher
Quando la distribuzione scelta è un farm di pubblicazione, quindi un’istanza di pubblicazione AEM deve essere identificata come l’editore primario per il polling di Adobe Analytics per i dati del rapporto in cui scrivere SRP.
Per impostazione predefinita, il AEM Communities Publisher Configuration
La configurazione OSGi 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 su tutte le istanze di pubblicazione secondarie per deselezionare Editore primario casella di controllo.
Per istruzioni specifiche, consulta la sezione dell’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.
Per farlo, segui le istruzioni all’indirizzo Replica la chiave di crittografia.
Pubblica sito community 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 è corretta, replica la configurazione nell’ambiente di pubblicazione tramite (ri)pubblicazione del sito community.
Ottenimento di rapporti da Analytics obtaining-reports-from-analytics
Gestione dei rapporti report-management
Autore ed editore principale Configurazione OSGi, AEM Communities Analytics Report Management
, viene utilizzato 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, l'autore principale Configurazione OSGi, AEM Communities Analytics Report Importer
, può essere configurato 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 recupero e il salvataggio dei dati SRP.
Quando i dati possono essere classificati come "big data", i polling più frequenti possono comportare un carico elevato sul sito della community.
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:
-
Nel server di pubblicazione principale, accedere con privilegi amministrativi.
-
Accedi a CRXDE Liti. Ad esempio: https://localhost:4503/crx/de.
-
Sotto
jcr:content
nodo della lingua root (ad esempio,/content/sites/engage/en/jcr:content
), passa al componente configurato per il reporting di Analytics.
Ad esempioanalytics/reportConfigs/social_forum_components_hbs_topic
-
Osserva i periodi di tempo creati:
last30Days
last90Days
thisYear
-
Osserva
total
nodo.- Modifica di
interval
sostituisce l'intervallo di Importazione report. - Il valore è in secondi ed è impostato su quattro ore (14400 secondi).
- Modifica di
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, consulta Inviare richieste di accesso e cancellazione.
Riferimenti resources
- Adobe Experience Cloud: Guida e riferimento di Analytics
- AEM: Integrazione con Adobe Analytics
- AEM: Analytics con provider esterni