Analytics-Konfiguration für Communities-Funktionen analytics-configuration-for-communities-features

Überblick overview

Adobe Analytics und Adobe Experience Manager (AEM) sind beide Lösungen von Adobe Experience Cloud.

Adobe Analytics kann für AEM Communities so konfiguriert werden, dass bei der Interaktion eines Mitglieds mit unterstützten Communities-Funktionen Ereignisse an Adobe Analytics gesendet werden, aus denen Berichte generiert werden.

Auf der Community-Site können Administratoren beispielsweise verschiedene Berichte zur Videowiedergabe sehen.

Außerdem ist die Analyse 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:

Voraussetzungen prerequisites

Um die Funktionen von Analytics for Communities zu konfigurieren, müssen Sie sich an Ihren Kundenbetreuer wenden, um ein Adobe Analytics-Konto und eine Report Suite einzurichten. Nach der Feststellung sollten folgende Informationen verfügbar sein:

Adobe Analytics Report Suite für Videoberichte adobe-analytics-report-suite-for-video-reporting

Mithilfe des Adobe Experience Clouds Report Suite Manager können Analytics-Report Suites so konfiguriert werden, dass eine Community-Site Berichte für Communities-Funktionen bereitstellen kann.

Durch Anmeldung bei Adobe Experience Cloud mit Firmenname und Benutzername können Sie eine neue oder vorhandene Report Suite so konfigurieren, dass sie Folgendes aufweist:

Bei Verwendung einer neuen Report Suite darf eine neue Report Suite nur über 4 eVars und 6 Ereignisvariablen verfügen, während für Communities 11 eVars und 7 Ereignisvariablen erforderlich sind.

Bei Verwendung einer vorhandenen Report Suite kann es erforderlich sein, die Variablenzuordnung zu ändern , bevor das Analytics-Framework für eine Community-Site aktiviert wird.

Wenden Sie sich an Ihren Kundenbetreuer, wenn Sie Fragen zu den Communities-Variablen haben.

Video Heartbeat Analytics video-heartbeat-analytics

Wenn Video Heartbeat Analytics lizenziert ist, wird ein Marketing Cloud Org Id zugewiesen.

So aktivieren Sie die Video Heartbeat-Berichterstellung nach Konfiguration der Analytics Report Suite für Videoberichte:

Der Marketing Cloud Org Id kann zum Zeitpunkt der Erstellung der Community-Site oder neuer eingegeben werden, indem die Eigenschaften der Community-Site geändert werden.

Wenn Video Heartbeat Analytics aktiviert ist, instanziiert der JavaScript (JS)-Code für den Videoplayer den Video Heartbeat-Bibliothekscode (auch in JS). Der Code verarbeitet alle Logiken zum Senden von Videostatusaktualisierungen an die Analytics-Video-Tracking-Server alle 10 Sekunden (nicht konfigurierbar). Schließlich wird ein kumulativer Bericht der Videositzung an die wichtigsten Analytics-Server gesendet.

Wenn dies nicht aktiviert ist, wird der Video Heartbeat-Code nie instanziiert und nur das Video-Fortschritts- und das Tracking der Wiederaufnahmeposition wird zur Berichterstellung in SRP persistiert.

Analytics Cloud-Dienstkonfiguration AEM aem-analytics-cloud-service-configuration

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

Dialogfeld "Konfiguration erstellen" create-configuration-dialog

Im Dialogfeld "Konfiguration erstellen"geben die eingegebenen Werte die Konfiguration an.

Dialogfeld "Analytics-Einstellungen" analytics-settings-dialog

Die erste Erstellung einer neuen Analytics-Konfiguration führt zur Anzeige der Konfiguration und eines neuen Dialogfelds für die Eingabe der Analytics-Einstellungen. Für dieses Dialogfeld sind die vom Kundenbetreuer erhaltenen erforderlichen Kontoinformationen erforderlich.

Speichern der Einstellungen:

Framework erstellen create-framework

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, Communities-Funktionsvariablen (AEM) Analytics-Variablen (Report Suite) zuzuordnen.

Durch Erstellen des Analytics-Frameworks wird das Framework zur Konfiguration geöffnet.

AEM Analytics-Framework-Konfiguration aem-analytics-framework-configuration

Das Framework dient der Zuordnung AEM Variablen zu Analytics-Variablen (eVars und Ereignisse). Die für die Zuordnung verfügbaren Analytics-Variablen sind in der Report Suite definiert.

Report Suite auswählen select-report-suite

Wählen Sie die Report Suite aus, die für 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

Die Sidekick ist nicht erforderlich und kann so minimiert werden, dass sie den Zugriff auf die Report Suites-Einstellungen nicht behindert.

Dialogfeld "Report Suites"vor und nach der Auswahl von "Element hinzufügen" report-suites-dialog-before-and-after-selecting-add-item

Der Analytics-Cloud-Service und das -Framework sind jetzt abgeschlossen. Die Zuordnungen werden definiert, nachdem eine Community-Site mit diesem Analytics-Dienst erstellt wurde.

Aktivieren von Analytics für eine Community-Site enable-analytics-for-a-community-site

Aktivieren für neue Community-Site enable-for-new-community-site

So fügen Sie den Analytics Cloud-Dienst hinzu, während Sie eine Community-Site erstellen:

Aktivieren für bestehende Community-Site enable-for-existing-community-site

So fügen Sie den Analytics Cloud-Dienst einer vorhandenen Community-Site hinzu:

Aktivieren für benutzerdefinierte Sites enable-for-customized-sites

Damit das Analytics-Tracking und -Import für eine Community-Site ordnungsgemäß funktionieren, muss ein Seitenelement mit den Attributen scf-js-site-title class und href vorhanden sein. Auf der Seite sollte nur ein solches Element vorhanden sein, wie es beispielsweise in einem unveränderten sitepage.hbs-Skript für eine Community-Site der Fall ist. Der Wert von siteUrl wird extrahiert und als Site-Pfad 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 angepassten Community-Site, die das sitepage.hbs-Skript überlagert, sicher, dass das Element vorhanden ist. Die Variable siteUrl wird festgelegt, wenn sie auf dem Server gerendert wird, bevor sie an den Client gesendet wird.

Für eine generische AEM Site, die Communities-Komponenten enthält, aber nicht mit dem Website-Erstellungsassistenten erstellt wird, muss das Element hinzugefügt werden. Der Wert von href sollte der Pfad zur Site sein. Wenn der Sitepfad beispielsweise /content/my/company/en lautet, verwenden Sie:

<div
    class="navbar-brand scf-js-site-title"
    href="/content/my/company/en.html"
    style="visibility: hidden;"
>
</div>

Funktionen von Analytics for Communities analytics-for-communities-features

Analytics wird automatisch für verschiedene Communities-Funktionen verwendet.

Die OSGi-Konfiguration, AEM Communities Analytics Component Configuration der Autorenumgebung enthält eine Liste der Komponenten, die für Analytics instrumentiert wurden. Die automatische Zuordnung von Variablen wird durch die 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 component-configuration

Analytics AEM Variablen zugeordnet mapped-analytics-to-aem-variables

Nachdem die Community-Site gespeichert wurde und Analytics aktiviert ist und das Cloud-Konfigurations-Framework ausgewählt ist, werden die AEM Variablen automatisch den Analytics-eVars und -Ereignissen zugeordnet. Er beginnt mit evar1 bzw. event1 und wird um 1 inkrementiert.

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 standardmäßige Zuordnungen:

Zuordnung der mit jedem Ereignis gesendeten eVars map-of-evars-sent-with-each-event

Beispiele für eVar :

Ändern der Analytics-Variablenzuordnung modifying-analytics-variable-mapping

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. Ziehen Sie einfach die gewünschte Analytics-eVar oder das gewünschte Ereignis aus der linken Leiste und legen Sie sie in der Zuordnungstabelle in der entsprechenden Zeile ab.

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 bewegen und das "X"auswählen, das rechts neben dem Analytics-Variablenelement angezeigt wird.

Wenn Community-eVars und -Ereignisse Zuordnungen überschreiben, die bereits in der Report Suite vorhanden waren, weisen Sie zur Vermeidung von Datenverlust die AEM Variablen für Communities-Funktionen anderen Analytics-eVars oder -Ereignissen zu und stellen Sie die ursprünglichen Zuordnungen wieder her.

Beispiel Schritt 1: Ziehen von Analytics eVar14 in eine Zuordnungstabelle example-step-dragging-analytics-evar-into-mapping-table

Beispiel Schritt 2: Auswählen von "x"zum Entfernen der ersetzten evar11 example-step-selecting-x-to-remove-replaced-evar

Beispiel Schritt 3: AEM var eventdata.siteId wurde der Analytics-eVar14 zugeordnet example-step-aem-var-eventdata-siteid-remapped-to-analytics-evar

Veröffentlichen der Community-Site publishing-the-community-site

Überprüfen der Zuordnung von Analytics zu AEM Variablen verify-analytics-to-aem-variable-mapping

Es ist ratsam, die Variablenzuordnung zu überprüfen, bevor Sie die Community-Site veröffentlichen, auf der auch der Analytics Cloud-Dienst und das Framework veröffentlicht werden.

Siehe Abschnitte:

Primärer Herausgeber primary-publisher

Wenn es sich bei der ausgewä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 Berichtsdaten identifiziert werden, die in SRP geschrieben werden sollen.

Standardmäßig identifiziert die OSGi-Konfiguration AEM Communities Publisher Configuration die Veröffentlichungsinstanz als primären Herausgeber, sodass sich alle Veröffentlichungsinstanzen in einer Veröffentlichungsfarm selbst als primär identifizieren.

Daher müssen Sie die Konfiguration in allen sekundären Veröffentlichungsinstanzen bearbeiten, um das Kontrollkästchen Primärer Herausgeber zu deaktivieren.

Spezifische Anweisungen finden Sie im Abschnitt für den primären Herausgeber von Communities bereitstellen.

Replizieren des Crypto-Schlüssels replicate-the-crypto-key

Die Adobe Analytics-Anmeldeinformationen werden verschlüsselt. Um die Replikation oder Übertragung verschlüsselter Analytics-Anmeldeinformationen zwischen Autor und Herausgebern zu erleichtern, müssen alle AEM Instanzen denselben Primärverschlüsselungsschlüssel verwenden.

Befolgen Sie dazu die Anweisungen unter Replizieren des Crypto-Schlüssels.

Publish-Community-Site und Analytics Cloud-Dienst publish-community-site-and-analytics-cloud-service

Nachdem der Analytics Cloud-Dienst für eine Community-Site aktiviert wurde und bei Bedarf die Zuordnung von Analytics zu AEM Variablen angepasst wurde, replizieren Sie die Konfiguration in der Veröffentlichungsumgebung durch (erneutes Veröffentlichen der Community-Site.

Abrufen von Berichten aus Analytics obtaining-reports-from-analytics

Berichtverwaltung report-management

Die OSGi-Konfiguration des Autors und des primären Herausgebers AEM Communities Analytics Report Management wird zur Abfrage von Analytics verwendet.

Auf der Autoreninstanz werden die Abfragen für Echtzeitberichte erstellt.

Beim primären Herausgeber werden die Abfragen verwendet, um Informationen bei der Vorbereitung des Analytics-Datenimports durch Report Importer bereitzustellen.

Das Abfrageintervall beträgt standardmäßig 10 Sekunden.

Report Importer report-importer

Sobald eine für Analytics aktivierte Community-Site veröffentlicht wurde, kann die OSGi-Konfiguration des primären Herausgebers AEM Communities Analytics Report Importer so konfiguriert werden, dass das standardmäßige Abrufintervall für die Konfigurationen festgelegt wird, die in CRXDE nicht einzeln konfiguriert sind.

Das Abrufintervall 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 eine große Belastung für die Community-Site verursachen.

Der standardmäßige Abruf Importintervall wird auf 12 Stunden festgelegt.

Anpassung von Komponentenberichten component-report-customization

Derzeit werden zur Anpassung der zu verfolgenden Metriken Knoten im Repository erstellt, die Zeiträume definieren, für die ein Bericht zu dieser Metrik erstellt werden soll.

Das Forenthema ist derzeit das einzige Beispiel für diese Anpassung:

Benutzerdaten in Analytics verwalten manage-user-data-in-analytics

Adobe Analytics bietet APIs, mit denen Sie Benutzerdaten aufrufen, exportieren und löschen können. Weitere Informationen finden Sie unter Zugriffs- und Löschanfragen einreichen.

Ressourcen resources