Analytics-Konfiguration für Communities-Funktionen

Übersicht

Adobe Analytics und Adobe Experience Manager (AEM) sind beide Lösungen von 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 korrekt ausgeführt wird.
  2. Vorbereiten einer Adobe Analytics- Report Suite
  3. Erstellen eines AEM Analytics- Cloud-Dienstes und - Frameworks
  4. Aktivieren von Analytics für eine Community-Site
  5. Überprüfen der Zuordnung von Analytics zu AEM Variablen
  6. Identifizieren Sie den primären Herausgeber.
  7. Veröffentlichen der Community-Site
  8. 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 Report Suiteeinzurichten. Nach der Festlegung sollten folgende Informationen verfügbar sein:

  • Name der Firma

    Die Firma, die mit dem Adobe Analytics-Konto verknüpft ist

  • 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 Video Berichte

Mithilfe des Report Suite Managerder 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 Adobe Marketing Cloud mit Firmen- und Benutzernamekönnen Sie eine neue oder vorhandene Report Suite für folgende Aufgaben konfigurieren:

  • 11 Konversionsvariablen (evars)

    • evar1 durch evar11 Aktivierung
    • Kann vorhandene eVars wiederverwenden (umbenennen) oder neue erstellen, die für Communities-Funktionen verwendet werden können
  • 7 Erfolgserlebnisse (Ereignis)

    • event1 durch event7 Aktivierung

    • Typ Counter

      • not Counter (no subrelations)
    • Kann vorhandene Ereignis wiederverwenden (umbenennen) oder neue erstellen, die für Communities-Funktionen verwendet werden können

  • Videomanagement

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

ACHTUNG

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

chlimage_1-264

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 bleiben zum Berichte auf SRP beschränkt.

Analytics Cloud-Dienstkonfiguration AEM

So erstellen Sie eine neue Analytics-Integration, die Adobe Analytics mit der AEM Community-Site integriert, mithilfe der Standard-Benutzeroberfläche in der Autoreninstanz:

  • Aus globaler Navigation: Werkzeuge > Bereitstellung > Cloud Services
  • Scroll down to Adobe Analytics
  • Wählen Sie entweder Konfigurationen konfigurieren oder anzeigen

chlimage_1-265

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.

chlimage_1-266

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

chlimage_1-267

  • 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 beibehalten (nicht markiert)

  • AppMeasurement verwenden

    Als Standard beibehalten (nicht markiert)

  • Nachts keine Seitenimpressionen importieren (verfassen)

    Als Standard beibehalten (nicht markiert)

  • 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
      • Ein anderes Rechenzentrum ausprobieren
      • Wenden Sie sich an Ihren Kundenbetreuer
  • Wählen Sie OK aus

chlimage_1-268

Framework erstellen

Nach erfolgreicher Konfiguration der Basisverbindung mit Adobe Analytics muss ein Framework für die Community-Site erstellt oder bearbeitet werden. 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

chlimage_1-269

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

AEM Analytics-Framework-Konfiguration

Der Zweck des Frameworks ist die Zuordnung AEM Variablen zu Analytics-Variablen (evars und Ereignis). Die für die Zuordnung verfügbaren Analytics-Variablen werden in der Report Suite definiert.

chlimage_1-270

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:
Adobe Analytics Report Suite für Video Berichte

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"

chlimage_1-271

  1. Wählen Sie Hinzufügen Element + zwei Dropdownfelder aus.
  2. Wählen Sie eine Report Suite aus, Report suite die mit dem Firmen-Konto verknüpft ist.
  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

chlimage_1-272

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-Siteden 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 siteUrlVariable 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-Erstellungsassistentenerstellt 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/enist, 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-Konfigurationder Autorenkonfiguration AEM Communities Analytics Component Configurationenthä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

chlimage_1-273

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. "Ereignis1"beginnen, und um 1 erhöht.

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 neu zuordnen und die ursprüngliche Zuordnung wiederherstellen .

Im Folgenden finden Sie ein Beispiel für Standardzuordnungen nach dem Einstieg:

chlimage_1-274

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
Ereignis1Ressourcenwiedergabe (eine) - - - - - - - (i) -
event2SCFView (eine) (b) © (d) (E) (f) (g) (h) (i) j)
Ereignis3SCFCreate (Post) - (b) © (d) (E) (f) (g) (h) (i) j)
event4SCFFollow - (b) © (d) (E) (f) (g) (h) (i) j)
event5SCFVoteUp - (b) © (d) (E) (f) (g) (h) (i) j)
event6SCFVoteDown - (b) © (d) (E) (f) (g) (h) (i) j)
event7SCFRate - (b) © (d) (E) (f) (g) (h) (i) j)

Beispiele für eVar:

  • MIME-Typ: video/mp4
  • Titelder Community-Site: Geometrixx
  • Community-Funktionsname: Forum
  • Community-Gruppenname: Wandern
  • 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 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 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.

ACHTUNG

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

chlimage_1-275

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

chlimage_1-276

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

chlimage_1-277

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:

ACHTUNG

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 Communities AEM Variablen, die automatisch zugeordnet wurden (als Analytics für die Community-Site aktiviert wurde), in andere Analytics-Variablen verschieben. Diese Neuzuordnung sollte für alle Communities-Komponenten einheitlich sein.

Andernfalls kann es zu nicht wiederherstellbaren Datenverlusten kommen.

Primär Publisher

Wenn es sich bei der gewählten Bereitstellung um eine Veröffentlichungsfarmhandelt, muss eine AEM Instanz im Veröffentlichungsmodus als primärer Herausgeber für die Abfrage von Adobe Analytics identifiziert werden, damit Berichtsdaten in SRPgeschrieben werden.

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är Publisher "zu deaktivieren.

Spezifische Anweisungen finden Sie im Abschnitt zum primären Herausgeber unter Bereitstellen von Communities.

ACHTUNG

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 primären Verschlüsselungsschlüssel verwenden.

Befolgen Sie dazu die Anweisungen unter Crypto-Schlüssel replizieren.

Veröffentlichen der Community-Site und des Analytics Cloud-Dienstes

Sobald der Analytics-Cloud-Dienst für eine Community-Site aktiviert wurde und die Zuordnung von Analytics zu AEM Variablen gegebenenfalls angepasstwurde, muss die Konfiguration der Veröffentlichungskonfiguration durch (erneutes)Veröffentlichen der Community-Siterepliziert werden.

Abrufen von Berichten aus Analytics

Berichtsverwaltung

Die OSGi-Konfigurationdes Autors und des primären Herausgebers AEM Communities Analytics Report Managementwird 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-Konfigurationdes primären Herausgebers konfiguriert werden, AEM Communities Analytics Report Importerum 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, um Daten in SRPabzurufen und zu speichern.

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.

chlimage_1-278

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 zur 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 totalNode

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

chlimage_1-279

Benutzerdaten in Analytics verwalten

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

Ressourcen

Auf dieser Seite