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:

  1. Replica la chiave di crittografia in modo da garantire che la crittografia/decrittografia avvenga correttamente su tutte le istanze AEM

  2. Preparare un’Adobe Analytics suite di rapporti

  3. Creare un’analisi dell’AEM Servizio cloud e framework

  4. Abilita analisi per un sito community

  5. Verifica Mappatura delle variabili da Analytics a AEM

  6. Identificare editore principale

  7. Pubblica il sito community

  8. 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 a evar11 abilitato

    • Possibilità di riutilizzare (rinominare) le eVar esistenti o crearne di da utilizzare per le funzioni community

  • 7 eventi di successo (eventi)

    • event1 da a event7 abilitato

    • tipo Counter

      • non Counter (no subrelations)
    • È possibile riutilizzare (rinominare) gli eventi esistenti o crearne di nuovi da utilizzare per le funzioni di Communities

  • Gestione video

    • Console di reporting video

      • Attiva Video Core
      • Seleziona Salva
    • Console di misurazione Core video

      • Seleziona Use Solution Variables
      • Seleziona Salva

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.

CAUTION
Se utilizzi una suite di rapporti esistente che utilizza già variabili in
  • Da evar1 a evar11

  • Da event1 a event7

Quindi, prima della pubblicazione del sito della community, è importante ripristinare la mappatura preesistente spostando le variabili AEM mappate automaticamente sulle variabili di Analytics quando Analytics era abilitato per un sito community.
Per ripristinare la mappatura preesistente e spostare le variabili AEM in altre variabili Analytics, vedi la sezione su Modifica della mappatura delle variabili di Analytics.
In caso contrario, potrebbe verificarsi una perdita di dati irreversibile.

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:

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.

marketing-org-id

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

cloud-config

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.

create-cloud-config

  • 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

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.

analytics-settings

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

    analytics-settings

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.

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

analytics-framework

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

report-suite

  1. Seleziona Aggiungi elemento +.

    Vengono visualizzate due caselle a discesa.

  2. Scegli un Report suite.

    Le suite di rapporti associate all’account aziendale sono disponibili per la selezione.

  3. Seleziona 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?
    
  4. Scegli un Run Mode.

  5. Seleziona Pubblica.

analytics-framework2

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

component-configuration1

NOTE
I componenti del diario vengono utilizzati per implementare la funzione blog.

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:

map-analytics

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

Abilitazione
Risorsa
Tipo
Sito
Titolo
Funzione
Tipo
Gruppo
Titolo
Gruppo
Percorso
UGC
Tipo
UGC
Titolo
Utente
(Membro)
UGC
Percorso
Sito
Percorso
eVar1
eVar2
eVar3
eVar4
eVar5
eVar6
eVar7
eVar8
eVar9
eVar10
event1
Riproduzione risorse
(a)
-
-
-
-
-
-
-
i) IT
-
event2
Visualizzazione SCFV
(a)
(b)
(c)
(d)
(e)
f)
(g)
(h)
i) IT
j)
event3
SCFCreate (Post)
-
(b)
(c)
(d)
(e)
f)
(g)
(h)
i) IT
j)
event4
SCFFollow
-
(b)
(c)
(d)
(e)
f)
(g)
(h)
i) IT
j)
event5
Scorri verso l'alto
-
(b)
(c)
(d)
(e)
f)
(g)
(h)
i) IT
j)
event6
ScorriInBasso
-
(b)
(c)
(d)
(e)
f)
(g)
(h)
i) IT
j)
event7
SCFRate
-
(b)
(c)
(d)
(e)
f)
(g)
(h)
i) IT
j)

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.

CAUTION
È importante ripetere la mappatura prima che il sito community sia pubblicato con Analytics abilitato, altrimenti si corre il rischio di perdita di dati.

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

analytics-mapping-evar

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

analytics-mapping-evar1

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

analytics-mapping-evar2

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:

CAUTION
Se utilizzi una suite di rapporti esistente che utilizza già variabili in
  • Da evar1 a evar11

  • Da event1 a event7

Quindi, prima della pubblicazione del sito della community, ripristina la mappatura preesistente. Sposta le variabili AEM delle community mappate automaticamente (quando Analytics era abilitato per il sito community) su altre variabili di Analytics. Questa mappatura deve essere coerente tra tutti i componenti di Communities.
In caso contrario, potrebbe verificarsi una perdita di dati irreversibile.

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.

CAUTION
È importante che l’editore principale sia configurato in modo da impedire il polling da più istanze di pubblicazione.

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.

report-importer

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 esempio analytics/reportConfigs/social_forum_components_hbs_topic

  • Osserva i periodi di tempo creati:

    • last30Days
    • last90Days
    • thisYear
  • Osserva totalnodo.

    • Modifica di interval sostituisce l'intervallo di Importazione report.
    • Il valore è in secondi ed è impostato su quattro ore (14400 secondi).

component-report

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

recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791