Show Menu
THEMEN×

Analytics-Konfiguration für Communities-Funktionen

Übersicht

Adobe Analytics und Adobe Experience Manager (AEM) sind beide Lösungen der Adobe Marketing Cloud.
Adobe Analytics kann für AEM Communities konfiguriert werden, sodass Ereignis, die von einem Mitglied mit unterstützten Communities-Funktionen interagieren, an Adobe Analytics gesendet werden, von dem aus Berichte generiert werden.
Wenn beispielsweise ein Mitglied einer Community-Site zur Aktivierung eine Videoressource Ansicht, die ihm zugewiesen wurde, sendet der Ressourcenplayer Ereignis, einschließlich Video Heartbeat-Daten. Auf der Community-Site können Administratoren verschiedene Berichte zur Wiedergabe des Videos sehen.
Darüber hinaus sind Analysen erforderlich für:
Zu den unterstützten Communities-Funktionen gehören:
In diesem Abschnitt der Dokumentation wird beschrieben, wie Sie eine Analytics-Report Suite mit Communities-Funktionen verbinden. Die grundlegenden Schritte sind:
  1. Replizieren Sie den Verschlüsselungsschlüssel , um sicherzustellen, dass Verschlüsselung/Entschlüsselung in allen AEM-Instanzen korrekt ausgeführt wird.
  2. Vorbereitung einer Adobe Analytics- Report Suite
  3. Aktivieren von Analytics für eine Community-Site
  4. Überprüfen der Zuordnung von Analytics zu AEM-Variablen
  5. Identifizieren Sie den primären Herausgeber.
  6. Veröffentlichen der Community-Site
  7. Konfigurieren des Imports von Berichtsdaten aus Adobe Analytics auf die Community-Site

Voraussetzungen

Zur Konfiguration der Funktionen von Analytics für Communities müssen Sie mit Ihrem Kundenbetreuer zusammenarbeiten, um ein Adobe Analytics-Konto und eine Adobe Analytics- Report Suite einzurichten. Nach der Festlegung sollten folgende Informationen verfügbar sein:
  • Name der Firma
    Die Firma, die mit dem Adobe Analytics-Konto verknüpft ist.
  • User Name
    Der Anmeldename des Benutzers, der zur Verwaltung des Analytics-Kontos berechtigt ist (sollte Web Service Access-Berechtigungen enthalten).
  • Kennwort
    Das Anmeldekennwort des autorisierten Benutzers.
  • Analytics Data Center
    Die URL des Analytics-Rechenzentrums für das Konto.
  • Report Suite
    Der Name der verwendeten Analytics-Report Suite.

Adobe Analytics Report Suite for Video Berichte

Mithilfe des Report Suite Manager der Adobe Marketing Cloud können Analytics-Report Suites so konfiguriert werden, dass eine Community-Site Berichte für Communities-Funktionen bereitstellen kann.
Durch die Anmeldung bei der Adobe Marketing Cloud mit Firmen- und Benutzername können Sie eine neue oder vorhandene Report Suite für folgende Aufgaben konfigurieren:
    • evar1 durch evar11 Aktivierung
    • Kann vorhandene eVars wiederverwenden (umbenennen) oder neue erstellen, die für Communities-Funktionen verwendet werden können
    • event1 durch event7 Aktivierung
    • type Counter
      • not Counter (no subrelations)
    • Kann vorhandene Ereignis wiederverwenden (umbenennen) oder neue erstellen, die für Communities-Funktionen verwendet werden können
    • Video Berichte Console
      • Aktivieren Video Core
      • Wählen Sie Speichern aus
    • Video-Core-Messkonsole
      • Wählen Sie nun eine der folgenden Optionen aus Use Solution Variables
      • Wählen Sie Speichern aus
Wenn Sie eine neue Report Suite verwenden, beachten Sie, dass eine neue Report Suite möglicherweise nur 4 eVars und 6 Ereignis-Variablen enthält, während für Communities 11 eVars und 7 Ereignis Vars erforderlich sind.
Wenn Sie eine vorhandene Report Suite verwenden, müssen Sie die Variablenzuordnung ggf. ändern, bevor Sie das Analytics-Framework für eine Community-Site aktivieren. Wenden Sie sich an Ihren Kundenbetreuer, wenn Sie Bedenken hinsichtlich der Variablen für Communities haben.
Wenn Sie eine vorhandene Report Suite verwenden, die bereits Variablen in
  • evar1 bis evar11
  • event1 bis event7
Bevor die Community-Site veröffentlicht wird, müssen Sie die bereits vorhandene Zuordnung wiederherstellen, indem Sie die AEM-Variablen verschieben, die automatisch Analytics-Variablen zugeordnet wurden, wenn Analytics für eine Community-Site aktiviert wurde.
Informationen zum Wiederherstellen der bereits vorhandenen Zuordnung und Verschieben von AEM-Variablen in andere Analytics-Variablen finden Sie im Abschnitt zum Ändern der Analytics-Variablenzuordnung .
Andernfalls kann es zu nicht wiederherstellbaren Datenverlusten kommen.

Video Heartbeat Analytics

Wenn Video Heartbeat Analytics lizenziert ist, Marketing Cloud Org Id wird eine zugewiesen.
So aktivieren Sie Video Heartbeat Berichte nach der Konfiguration der Analytics Report Suite für Video-Berichte :
Die Marketing Cloud Org Id Variable kann zum Zeitpunkt der Community-Site-Erstellung oder später eingegeben werden, indem die Eigenschaften der Community-Site geändert werden. Konfiguration des AEM Analytics Cloud-Dienstes
Wenn Video Heartbeat Analytics aktiviert ist, instanziiert der JavaScript-(JS-)Code für den Videoplayer den Video Heartbeat Library-Code (auch in JS), der alle Logik zum Senden von Videostatusaktualisierungen an die Analytics-Videoverfolgungsserver alle 10 Sekunden (nicht konfigurierbar) verarbeitet und schließlich einen kumulativen Bericht der Videositzung an die Analytics-Hauptserver sendet.
Ist diese Option nicht aktiviert, wird der Video Heartbeat-Code nie instanziiert und nur die Videoverfolgung und die Verfolgung der Wiederaufnahme-Position bleiben zum Berichte auf SRP beschränkt.

Konfiguration des AEM Analytics Cloud-Dienstes

Um eine neue Analytics-Integration zu erstellen, die Adobe Analytics mit der AEM-Community-Site integriert, verwenden Sie die Standard-Benutzeroberfläche in der Autoreninstanz:
  • Aus globaler Navigation: Werkzeuge > Bereitstellung > Cloud-Dienste
  • Scroll-down to Adobe Analytics
  • Wählen Sie Konfigurationen jetzt konfigurieren oder Konfigurationen anzeigen

Dialogfeld "Konfiguration erstellen"

  • Klicken Sie auf [+] das Symbol neben Verfügbare Konfigurationen , um eine neue Konfiguration zu erstellen.
Im Dialogfeld "Konfiguration erstellen"wird die Konfiguration durch die eingegebenen Werte identifiziert.
  • Titel
    (Erforderlich) Ein Anzeigentitel für die Konfiguration. Geben Sie z. B. Enablement Community Analytics ein.
  • Name
    (Optional) Wenn kein Name angegeben ist, wird standardmäßig ein gültiger Knotenname verwendet, der aus dem Titel abgeleitet wurde. For example, enter communities
  • Vorlage
    Wählen Sie nun eine der folgenden Optionen aus Adobe Analytics Configuration
  • Wählen Sie Erstellen
    • Startet die Konfigurationsseite und öffnet Analytics Settings das Dialogfeld

Dialogfeld "Analytics-Einstellungen"

Bei der ersten Erstellung einer neuen Analytics-Konfiguration wird die Konfiguration angezeigt und es wird ein neues Dialogfeld für die Eingabe der Analytics-Einstellungen angezeigt. Dieser Dialog erfordert die erforderlichen Kontoinformationen , die vom Kundenbetreuer eingeholt werden.
  • Unternehmen
    Die Firma, die mit dem Adobe Analytics-Konto verknüpft ist
  • Benutzername
    Der Anmeldename des Benutzers, der zur Verwaltung des Analytics-Kontos berechtigt ist
  • Kennwort
    Das Anmeldekennwort für den autorisierten Benutzer
  • Datenzentrum
    Wählen Sie das Analytics-Rechenzentrum aus, in dem die Report Suite gehostet wird
  • Kein Verfolgungs-Tag zur Seite hinzufügen
    Als Standard deaktivieren
  • AppMeasurement verwenden
    Als Standard deaktivieren
  • Nachts keine Seitenimpressionen importieren (verfassen)
    Als Standard deaktivieren
  • Seitenimpressionen nicht nachts importieren (veröffentlichen) als Standard beibehalten (deaktiviert)
So speichern Sie die Einstellungen:
  • Select Connect to Analytics
    • Wenn dies nicht erfolgreich ist,
      • Überprüfen Sie, ob die Einträge keine Leerzeichen enthalten
      • Ein anderes Rechenzentrum ausprobieren
      • Wenden Sie sich an Ihren Kundenbetreuer
  • Wählen Sie OK aus

Framework erstellen

Nach der erfolgreichen Konfiguration der grundlegenden Verbindung mit Adobe Analytics müssen Sie ein Framework für die Community-Site erstellen oder bearbeiten. Der Zweck des Frameworks besteht darin, Variablen der Funktion Communities (AEM) Analytics (Report Suite)-Variablen zuzuordnen.
  • Klicken Sie auf [+] das Symbol neben Verfügbare Frameworks , um ein neues Framework zu erstellen.
  • Titel
    (Erforderlich) Ein Anzeigentitel für das FrameworkGeben Sie z. B. Enablement Community Framework ein.
  • Name
    (Optional) Wenn kein Name angegeben ist, wird standardmäßig ein gültiger Knotenname verwendet, der aus dem Titel abgeleitet wurde. For example, enter communities
  • Vorlage
    Wählen Sie nun eine der folgenden Optionen aus Adobe Analytics Framework
  • Wählen Sie Erstellen
Das Erstellen des Analytics-Frameworks öffnet das Framework für die Konfiguration.

Konfiguration des AEM Analytics-Frameworks

Das Framework dient dazu, AEM-Variablen Analytics-Variablen zuzuordnen (eVars und Ereignis). Die für die Zuordnung verfügbaren Analytics-Variablen werden in der Report Suite definiert .

Report Suite auswählen

Wählen Sie die Report Suite aus, die für Video Berichte eingerichtet wurde.
Wenn eine Report Suite noch nicht erstellt oder nicht ordnungsgemäß eingerichtet wurde, lesen Sie den vorherigen Abschnitt: Report Suite für Video Berichte in Adobe Analytics
Der Sidekick ist nicht erforderlich und kann minimiert werden, sodass er den Zugriff auf die Report Suites-Einstellungen nicht behindert.

Report Suites Dialogfeld vor und nach Auswahl von "Hinzufügen Element"

  1. Element Hinzufügen + auswählen
    Es werden zwei Dropdownfelder angezeigt.
  2. Choose a Report suite.
    Die mit dem Firmen-Konto verknüpften Report Suites stehen zur Auswahl zur Verfügung.
  3. Wählen Sie Ja im angezeigten Dialogfeld aus:
    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
  5. Wählen Sie Veröffentlichen
Der Dienst und das Framework für Analytics sind nun abgeschlossen. Die Zuordnungen werden definiert, sobald eine Community-Site mit diesem Analytics-Dienst erstellt wurde.

Aktivieren von Analytics für eine Community-Site

Für neue Community-Site aktivieren

So fügen Sie beim Erstellen einer neuen Community-Site den Analytics-Cloud-Dienst hinzu:
  • In Schritt 3 unter der Registerkarte " ANALYTICS" :
    • Aktivieren Sie das Kontrollkästchen Analytics aktivieren.
    • Wählen Sie das Framework aus dem Dropdown-Feld.
  • Optional können Sie zur Analytics-Framework-Konfiguration zurückkehren, um die Variablenzuordnungen anzupassen.

Für bestehende Community-Site aktivieren

Hinzufügen des Analytics-Cloud-Dienstes zu einer bestehenden Community-Site :
  • Navigieren Sie zur Konsole Communities > Sites .
  • Wählen Sie das Symbol "Site bearbeiten"der Community-Site aus.
  • Wählen Sie die EINSTELLUNGEN.
  • Im Abschnitt Analytics:
    • Aktivieren Sie das Kontrollkästchen Analytics aktivieren.
    • Wählen Sie das Framework aus der Dropdownliste.
  • Optional können Sie zur Analytics-Framework-Konfiguration zurückkehren, um die Variablenzuordnungen anzupassen.

Aktivieren für benutzerdefinierte Sites

Damit Analytics-Verfolgung und -Import für eine Community-Site ordnungsgemäß funktionieren, muss ein Seitenelement mit den Attributen scf-js-site-title class und href vorhanden sein. Nur ein solches Element sollte auf der Seite vorhanden sein, wie es in einem nicht geänderten sitepage.hbs Skript für eine Community-Site der Fall ist. Der Wert von siteUrl wird extrahiert und als Sitepfad an Adobe Analytics gesendet.
# 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>

Stellen Sie bei einer benutzerdefinierten Community-Site , die das sitepage.hbs Skript überlagert, sicher, dass das Element vorhanden ist. Die siteUrl Variable wird festgelegt, wenn sie auf dem Server wiedergegeben wird, bevor sie an den Client gesendet wird.
Für eine generische AEM-Site , die Communities-Komponenten enthält, aber nicht mit dem Site-Erstellungsassistenten erstellt wurde, muss das Element hinzugefügt werden. Der Wert des href sollte der Pfad zur Site sein. Wenn der Site-Pfad beispielsweise /content/my/company/en ist, verwenden Sie:
<div
    class="navbar-brand scf-js-site-title"
    href="/content/my/company/en.html"
    style="visibility: hidden;"
>
</div>

Funktionen von Analytics für Communities

Analytics wird automatisch für mehrere Communities-Funktionen verwendet.
Die OSGi-Konfiguration der Autorenkonfiguration AEM Communities Analytics Component Configuration enthält eine Auflistung der Komponenten, die für Analytics instrumentiert wurden. Die automatische Zuordnung von Variablen wird von den aufgeführten Komponenten bestimmt.
Wenn neue benutzerdefinierte Komponenten erstellt werden, die für Analytics instrumentiert werden, sollten sie dieser Liste konfigurierter Komponenten hinzugefügt werden.

Komponentenkonfiguration

Die Protokoll-Komponenten werden zur Implementierung der Blog-Funktion verwendet.

Analytics AEM-Variablen zugeordnet

Sobald die Community-Site mit aktiviertem Analytics und aktiviertem Cloud-Konfigurationsframework gespeichert wurde, werden die AEM-Variablen automatisch den Analytics-eVars und -Ereignissen zugeordnet, die mit "evar1"bzw. "Ereignis1"beginnen und um 1 erhöht werden.
Wenn Sie eine vorhandene Report Suite verwenden, die eine der Variablen in evar1 bis evar11 und Ereignis1 bis Ereignis7 zugeordnet hat, müssen Sie die AEM-Variablen neu zuordnen und die ursprüngliche Zuordnung wiederherstellen .
Im Folgenden finden Sie ein Beispiel für Standardzuordnungen nach dem Einstieg :

Zuordnung der mit jedem Ereignis gesendeten eVars

Aktivierungsressource -Typ Site -Titel Funktionstyp Gruppentitel Group Path UGC -Typ UGC -Titel Benutzer (Mitglied) UGC -Pfad Site -Pfad
eVar1 eVar2 eVar3 eVar4 eVar5 eVar6 eVar7 eVar8 eVar9 eVar10
Ereignis1 -Ressourcenwiedergabe (eine) - - - - - - - (i) -
Ereignis2 SCFView (eine) (b) (c) (d) (E) (f) (g) (h) (i) j)
Ereignis3 SCFCreate (Post) - (b) (c) (d) (E) (f) (g) (h) (i) j)
Ereignis4 SCFFollow - (b) (c) (d) (E) (f) (g) (h) (i) j)
Ereignis5 SCFVoteUp - (b) (c) (d) (E) (f) (g) (h) (i) j)
Ereignis6 SCFVoteDown - (b) (c) (d) (E) (f) (g) (h) (i) j)
Ereignis7 SCFRate - (b) (c) (d) (E) (f) (g) (h) (i) j)
Beispiele für eVar-Werte:

Ändern der Analytics-Variablenzuordnung

Die Zuordnung von Analytics-eVars und -Ereignissen zu AEM-Variablen ist in der Framework-Konfiguration sichtbar, nachdem Analytics für eine Community-Site aktiviert wurde.
Nachdem Analytics aktiviert wurde und bevor die Community-Site veröffentlicht wird, kann die Zuordnung im Framework geändert werden, indem die gewünschte Analytics-eVar oder das gewünschte Analytics-Ereignis aus der linken Leiste gezogen und in die entsprechende Zeile der Zuordnungstabelle eingefügt wird.
Um Duplikat-Zuordnungen zu vermeiden, müssen Sie die ersetzte Analytics-eVar oder das ersetzte Analytics-Ereignis aus der Zeile entfernen, indem Sie den Mauszeiger darüber halten und das X auswählen, das rechts neben dem Analytics-Variablenelement angezeigt wird.
Wenn Communities-eVars und -Ereignis Zuordnungen überschreiben, die bereits in der Report Suite vorhanden waren, weisen Sie zur Vermeidung von Datenverlusten die AEM-Variablen für Communities-Funktionen anderen Analytics-eVars oder -Ereignissen zu und stellen Sie die ursprünglichen Zuordnungen wieder her.
Bevor die Community-Site mit aktivierter Analytics veröffentlicht wird, müssen Sie unbedingt eine Aktualisierung vornehmen. Andernfalls besteht das Risiko eines Datenverlusts.

Beispiel Schritt 1: Ziehen von Analytics evar14 in die Tabelle

Beispiel Schritt 2: Auswahl von "x" zum Entfernen der ersetzten evar11

Beispiel Schritt 3: AEM var eventData.siteId wird Analytics evar14 zugeordnet

Veröffentlichen der Community-Site

Zuordnung von Analytics zu AEM-Variablen überprüfen

Es ist sinnvoll, die Variablenzuordnung vor der Veröffentlichung der Community-Site zu überprüfen, die auch den Analytics-Cloud-Dienst und das Analytics-Framework veröffentlicht.
Siehe Abschnitte:
Wenn Sie eine vorhandene Report Suite verwenden, die bereits Variablen in
  • evar1 bis evar11
  • event1 bis event7
Bevor die Community-Site veröffentlicht wird, müssen Sie die bereits vorhandene Zuordnung wiederherstellen und die AEM-Variablen für Communities, die automatisch zugeordnet wurden (als Analytics für die Community-Site aktiviert wurde), an andere Analytics-Variablen verschieben. Diese Neuzuordnung sollte für alle Communities-Komponenten einheitlich sein.
Andernfalls kann es zu nicht wiederherstellbaren Datenverlusten kommen.

Herausgeber

Wenn es sich bei der gewählten Bereitstellung um eine Veröffentlichungsfarm handelt, muss eine AEM-Veröffentlichungsinstanz als primärer Herausgeber für die Abfrage von Adobe Analytics für die Berichtdaten identifiziert werden, die in SRP geschrieben werden sollen.
Standardmäßig identifiziert die AEM Communities Publisher Configuration OSGi-Konfiguration die Veröffentlichungsinstanz als primären Herausgeber, sodass sich alle Instanzen im Veröffentlichungsmodus in einer Veröffentlichungsfarm selbst als Primär identifizieren.
Daher müssen Sie die Konfiguration in allen sekundären Instanzen im Veröffentlichungsmodus bearbeiten, um das Kontrollkästchen " Primärer Herausgeber "zu deaktivieren.
Spezifische Anweisungen finden Sie im Abschnitt zum primären Herausgeber unter Bereitstellen von Communities .
Es ist wichtig, dass der primäre Herausgeber so konfiguriert ist, dass keine Abfrage von mehreren Instanzen im Veröffentlichungsmodus durchgeführt wird.

Crypto-Schlüssel replizieren

Die Adobe Analytics-Anmeldeinformationen werden verschlüsselt. Um die Replizierung oder Übertragung verschlüsselter Analysedaten zwischen Autoren und Herausgebern zu erleichtern, müssen alle AEM-Instanzen denselben Master-Verschlüsselungsschlüssel verwenden.
Befolgen Sie dazu die Anweisungen unter Crypto-Schlüssel replizieren .

Community-Site und Analytics-Cloud-Dienst veröffentlichen

Nachdem der Analytics-Cloud-Dienst für eine Community-Site aktiviert wurde und die Zuordnung von Analytics zu AEM-Variablen erforderlichenfalls angepasst wurde, muss die Konfiguration der Veröffentlichungskonfiguration repliziert werden, indem die Community-Site veröffentlicht (erneut)veröffentlicht wird.

Abrufen von Berichten aus Analytics

Berichtsverwaltung

Die OSGi-Konfiguration des Autors und des primären Herausgebers AEM Communities Analytics Report Management wird zur Abfrage von Analytics verwendet.
Beim Autor werden die Abfragen für Echtzeitberichte verwendet.
Beim primären Herausgeber werden die Abfragen verwendet, um Informationen zur Vorbereitung des Analytics-Datenimports des Berichts bereitzustellen.
Das Zeitintervall der Abfrage ist standardmäßig auf 10 Sekunden eingestellt.

Report Importer

Sobald eine für Analytics aktivierte Community-Site veröffentlicht wurde, kann die OSGi-Konfiguration des primären Herausgebers konfiguriert werden, AEM Communities Analytics Report Importer um das Standard-Abfrageintervall für die Konfigurationen festzulegen, die in CRXDE nicht einzeln konfiguriert sind.
Das Abfrageintervall steuert die Häufigkeit von Anfragen an Adobe Analytics, damit Daten abgerufen und in SRP gespeichert werden.
Wenn die Daten als "Big Data"kategorisiert werden können, kann eine häufigere Abfrage zu einer hohen Belastung der Community-Site führen.
Das Importintervall für die Standardabfrage ist auf 12 Stunden eingestellt.

Komponentenberichtsanpassung

Zur Anpassung der zu verfolgenden Metriken werden derzeit Knoten im Repository erstellt, die Zeiträume definieren, für die ein Bericht zu dieser Metrik erstellt werden soll.
Das Forumthema ist derzeit das einzige Beispiel für diese Anpassung:
  • Melden Sie sich beim primären Herausgeber mit Administratorrechten an.
  • Navigate to CRXDE Lite . For example, https://localhost:4503/crx/de .
  • Navigieren Sie unter dem Knoten jcr:content im Sprachstamm (z. B. /content/sites/engage/en/jcr:content), zu der für Analytics Berichte konfigurierten Komponente). Beispiel: analytics/reportConfigs/social_forum_components_hbs_topic
  • Beachten Sie die erstellten Zeiträume:
    • last30Days
    • last90Days
    • thisYear
  • Beachten Sie die total Node.
    • Das Ändern der interval Eigenschaft setzt das Report Importer-Intervall außer Kraft.
    • Der Wert wird in Sekunden und auf 4 Stunden (14400 Sekunden) festgelegt.

Benutzerdaten in Analytics verwalten

Adobe Analytics bietet APIs, mit denen Sie auf Benutzerdaten zugreifen, sie exportieren und löschen können. Weitere Informationen finden Sie unter Zugriff senden und Anforderungen löschen.

Ressourcen