Show Menu
THEMEN×

Analytics-Konfiguration für Communities-Funktionen

Überblick

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 bei der Interaktion eines Mitglieds mit unterstützten Communities-Funktionen Ereignisse an Adobe Analytics gesendet werden, aus denen Berichte generiert werden.
Wenn ein Mitglied einer Community-Site für eine Aktivierung beispielsweise eine Videoressource anzeigt, die ihm zugewiesen ist, sendet der Ressourcenplayer Ereignisse, 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:
  • Firmenname
    Das mit dem Adobe Analytics-Konto verbundene Unternehmen
  • Benutzername
    Der Anmeldename des Benutzers, der zur Verwaltung des Analytics-Kontos berechtigt ist
    (Sollte Web-Service-Zugriffsberechtigungen beinhalten)
  • Kennwort
    Das Anmeldekennwort für den autorisierten Benutzer
  • 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 für Videoberichte

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 Firmenname und Benutzername können Sie eine neue oder vorhandene Report Suite so konfigurieren, dass sie Folgendes aufweist:
    • 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
    • Typ Counter
      • not Counter (no subrelations)
    • Kann vorhandene Ereignisse wiederverwenden (umbenennen) oder neue Ereignisse erstellen, die für Communities-Funktionen verwendet werden können
    • Videoberichterstellungskonsole
      • Aktivieren Video Core
      • Wählen Sie Speichern
    • Video-Core-Messkonsole
      • Wählen Sie nun eine der folgenden Optionen aus Use Solution Variables
      • Wählen Sie Speichern
Wenn Sie eine neue Report Suite verwenden, beachten Sie, dass eine neue Report Suite möglicherweise nur 4 eVars und 6 Ereignisvariablen hat, während für Communities 11 eVars und 7 Ereignisvariablen 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.
Bei Verwendung einer vorhandenen Report Suite, die bereits Variablen in
  • evar1 through evar11
  • event1 through 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 die Video Heartbeat-Berichterstellung nach der Konfiguration der Analytics Report Suite für die Videoberichte :
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 die gesamte 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 werden zur Berichterstellung auf SRP beibehalten.

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 entweder Konfigurationen konfigurieren oder 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.
    Beispiel: Enablement Community Analytics eingeben
  • 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 erhalten wurden.
  • Unternehmen
    Das mit dem Adobe Analytics-Konto verbundene Unternehmen
  • 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, 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
  • Nachts keine Seitenimpressionen importieren (veröffentlichen)
    Als Standard beibehalten (aktiviert)
So speichern Sie die Einstellungen:
  • Select Connect to Analytics
    • Wenn dies nicht erfolgreich ist,
      • Überprüfen Sie, ob die Einträge keine Leerzeichen enthalten
      • Anderen Rechenzentrum testen
      • 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 Framework
    Geben 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

Der Zweck des Frameworks ist die Zuordnung von AEM-Variablen zu Analytics-Variablen (evars und events). 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 die Videoberichte eingerichtet wurde.
Wenn eine Report Suite noch nicht erstellt oder nicht ordnungsgemäß eingerichtet wurde, lesen Sie den vorherigen Abschnitt: Adobe Analytics Report Suite für Videoberichte
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 "Element hinzufügen"

  1. Auswahl Element hinzufügen + zwei Dropdownfelder werden angezeigt
  2. Wählen Sie eine Report Suite, Report suite die mit dem Unternehmenskonto verknüpft ist, zur Auswahl verfügbar sein soll
  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 Auswählen der Veröffentlichung
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
  • Auf der Registerkarte 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.

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
  • EINSTELLUNGEN auswählen
  • 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 Autorenumgebung AEM Communities Analytics Component Configuration enthält eine Liste 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 der konfigurierten Komponenten hinzugefügt werden.

Komponentenkonfiguration

Hinweis: die journal 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. "event1"beginnen und um 1 inkrementiert werden.
Wenn Sie eine vorhandene Report Suite verwenden, die eine der Variablen in evar1 bis evar11 und event1 bis event7 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
Gruppenpfad
UGC-Typ
UGC-Titel
Benutzer (Mitglied)
UGC-Pfad
Site-Pfad
eVar1
eVar2
eVar3
eVar4
eVar5
eVar6
eVar7
eVar8
eVar9
eVar10
event1Resource Play
(eine)
-
-
-
-
-
-
-
(i)
-
event2SCFView
(eine)
(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)
Beispiele für eVar-Werte:
  • MIME-Typ :video/mp4
  • Titel der Community-Site: Geometrixx Communities
  • Pfad zum Inhalt einer Community-Gruppe: /content/sites/community/de/groups/wandern
  • UGC component resourceType : social/forum/components/hbs/topic
  • UGC-Komponententitel: Wanderthemen
  • Anmeldung (autorisierbare ID): aaron.mcdonald@mailinator.com
  • SRP-Pfad zu UGC: /content/usergenerated/asi/.../forum/jmtz-topic3 oder Pfad der zu folgenden Komponente: /content/sites/groups/de/jcr:content/content/primary/forum
  • Pfad zum Inhalt der Community-Site: /content/sites/community/de

Ä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 doppelte 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 -Ereignisse Zuordnungen überschreiben, die in der Report Suite bereits vorhanden waren, weisen Sie zur Vermeidung von Datenverlusten die AEM-Variablen für Communities-Funktionen anderen Analytics-eVars und/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:
Bei Verwendung einer vorhandenen Report Suite, die bereits Variablen in
  • evar1 through evar11
  • event1 through 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 Replikation oder Übertragung verschlüsselter Analytics-Anmeldeinformationen 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 in der Veröffentlichungsumgebung 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 erstellt.
Beim primären Herausgeber werden die Abfragen verwendet, um Informationen zur Vorbereitung des Analytics-Datenimports des Berichts bereitzustellen.
Das Abfrageintervall beträgt standardmäßig 10 Sekunden.

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:
  • Im primären Herausgeber
  • Anmelden mit Administratorrechten
  • Navigate to CRXDE Lite
  • Unter dem jcr:content Knoten des Sprachstamms
    • Beispiel: /content/sites/engage/en/jcr:content
  • Navigieren Sie zu der für die Analytics-Berichterstellung 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