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

Überblick overview

Adobe Analytics und Adobe Experience Manager (AEM) sind beides Lösungen von Adobe Experience 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.

Beispielsweise können Admins auf der Community-Website verschiedene Berichte zur Wiedergabe des Videos anzeigen.

Außerdem ist die Analyse für Folgendes erforderlich:

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

Zum Konfigurieren der Funktionen von Analytics for Communities müssen Sie ein Adobe Analytics-Konto und eine Report Suite“Ihrem Kontobeauftragten einrichten. Nach ihrer Festlegung sollten folgende Informationen verfügbar sein:

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

Mithilfe des Adobe Experience Cloud Report Suite Manager können Analytics-Report Suites so konfiguriert werden, dass eine Community-Site für die Bereitstellung von Berichten für Communities-Funktionen aktiviert werden kann.

Durch die Anmeldung bei Adobe Experience Cloud mit Firmenname und Benutzername ist es möglich, eine neue oder vorhandene Report Suite so zu konfigurieren, dass sie Folgendes aufweist:

Bei Verwendung einer neuen Report Suite darf eine neue Report Suite nur 4 eVars und 6 Ereignisvariablen haben, während 11 eVars und 7 Ereignisvariablen für Communities 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 Bedenken bezüglich der für Communities reservierten Variablen haben.

Video Heartbeat Analytics video-heartbeat-analytics

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

So aktivieren Sie Video Heartbeat-Berichte nach Konfigurieren der Analytics Report Suite für Videoberichte:

Die Marketing Cloud Org Id kann zum Zeitpunkt der Erstellung der -Community-Sitespäter durch der EigenschaftenCommunity-Site eingegeben werden.

Wenn Video Heartbeat Analytics aktiviert ist, instanziiert der JavaScript-Code (JS) für den Video-Player den Video-Heartbeat-Bibliothekscode (auch in JS). Der Code handhabt die gesamte Logik zum Senden von Videostatusaktualisierungen an die Analytics-Videotracking-Server alle 10 Sekunden (nicht konfigurierbar). Schließlich sendet sie einen kumulativen Bericht der Videositzung an die wichtigsten Analytics-Server.

Wenn er nicht aktiviert ist, wird der Video-Heartbeat-Code nie instanziiert und nur der Videofortschritt und das Tracking der Wiederaufnahme-Position werden zum Reporting in SRP beibehalten.

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

So erstellen Sie eine Analytics-Integration, die Adobe Analytics mit der AEM-Community-Site integriert, indem Sie die Standardbenutzeroberfläche auf der Autoreninstanz verwenden:

Dialogfeld „Konfiguration erstellen“ create-configuration-dialog

Im Dialogfeld Konfiguration erstellen identifizieren die einzugebenden Werte die Konfiguration.

Dialogfeld „Analytics-Einstellungen“ analytics-settings-dialog

Die anfängliche Erstellung einer neuen Analytics-Konfiguration führt zur Anzeige der Konfiguration und zu einem neuen Dialogfeld für die Eingabe der Analytics-Einstellungen. Dieses Dialogfeld erfordert die vorausgesetzte Kontoinformationen die vom Kontobeauftragten abgerufen werden.

So speichern Sie die Einstellungen:

Framework erstellen create-framework

Nach erfolgreicher Konfiguration der Basisverbindung zu Adobe Analytics ist es erforderlich, ein Framework für die Community-Site zu erstellen oder zu bearbeiten. Ziel des Frameworks ist die Zuordnung von AEM-Variablen (Communities Feature) zu Analytics-Variablen (Report Suite).

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

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

Das Framework ordnet AEM-Variablen Analytics-Variablen (eVars und Ereignisse) zu. 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 minimiert werden, sodass sie den Zugriff auf die Report Suites-Einstellungen nicht behindert.

Report Suites-Dialog 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 aktivierten Analytics-Service erstellt wurde.

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

Für neue Community-Site aktivieren enable-for-new-community-site

So fügen Sie den Analytics Cloud-Service beim einer Community-Site hinzu:

Für vorhandene Community-Site aktivieren enable-for-existing-community-site

So fügen Sie den Analytics Cloud-Service zu einer Community-Site hinzu:

Für benutzerdefinierte Sites aktivieren enable-for-customized-sites

Damit das Analytics-Tracking und der Import für eine Community-Site ordnungsgemäß funktionieren, muss ein Seitenelement mit den Attributen "scf-js-site-title" und „href“ vorhanden sein. Auf der Seite sollte nur ein solches Element vorhanden sein, z. B. in einem unveränderten sitepage.hbs für eine Community-Site. Der Wert von siteUrl wird extrahiert und als „Site Pfad“ an Adobe Analytics.

# 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 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 gerendert 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 wird, muss das Element hinzugefügt werden. Der Wert von 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 for Communities analytics-for-communities-features

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

Die OSGiKonfiguration der Autorenumgebung, AEM Communities Analytics Component Configuration, bietet eine Liste der Komponenten, die für Analytics instrumentiert wurden. Die automatische Zuordnung von Variablen wird durch die aufgelisteten Komponenten bestimmt.

Wenn neue benutzerdefinierte Komponenten erstellt werden, die für Analytics instrumentiert sind, 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 und Analytics aktiviert sowie das Cloud-Konfigurations-Framework ausgewählt wurde, werden die AEM-Variablen automatisch den Analytics-eVars und -Ereignissen zugeordnet. Sie beginnt mit eVar1 bzw. event1 und wird um 1 inkrementiert.

Wenn Sie eine vorhandene Report Suite verwenden, die eine der Variablen in eVar1 über eVar11 und event1 bis event7 zugeordnet hat, ist es erforderlich, die AEM-Variablen neu zuzuordnen und die ursprüngliche Zuordnung wiederherzustellen.

Im Folgenden finden Sie ein Beispiel für Standardzuordnungen:

Zuordnung der eVars, die mit jedem Ereignis gesendet werden map-of-evars-sent-with-each-event

Beispiele für eVar-Werte :

Ä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 wurde, 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 entsprechenden Zeile in der Zuordnungstabelle ab.

Um doppelte Zuordnungen zu vermeiden, entfernen Sie unbedingt die ersetzte Analytics-eVar oder das ersetzte Ereignis aus der Zeile, indem Sie den Mauszeiger darüber bewegen und das „X“ auswählen, das rechts neben dem Analytics-Variablenelement angezeigt wird.

Wenn Communities-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 die Zuordnungstabelle example-step-dragging-analytics-evar-into-mapping-table

Beispiel Schritt 2: Auswahl von „x“ zum Entfernen der ersetzten eVar11 example-step-selecting-x-to-remove-replaced-evar

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

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

Überprüfen der Analytics-zu-AEM-Variablenzuordnung verify-analytics-to-aem-variable-mapping

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

Siehe Abschnitte:

Primärer Herausgeber primary-publisher

Wenn es sich bei der ausgewählten Bereitstellung um Veröffentlichungsfarm handelt, muss eine AEM-Veröffentlichungsinstanz als primärer Herausgeber identifiziert werden, der Adobe Analytics zum Schreiben von Berichtsdaten in SRP abfragt.

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

Daher müssen Sie die Konfiguration auf allen sekundären Veröffentlichungsinstanzen bearbeiten, um die Auswahl des Kontrollkästchens Primärer Herausgeber aufzuheben.

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

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 Autoren- und Herausgebern zu erleichtern, müssen alle AEM-Instanzen denselben primären Verschlüsselungsschlüssel verwenden.

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

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

Nachdem der Analytics Cloud-Service für eine Community-Site aktiviert und bei Bedarf die Zuordnung von Analytics zu AEM-Variablen angepasst“ wurde replizieren Sie die Konfiguration in der Veröffentlichungsumgebung, indem Sie die Community-Site (erneut).

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

Berichtverwaltung report-management

Die OSGi-Konfiguration Autors undprimären Herausgebers, AEM Communities Analytics Report Management, wird zur Abfrage von Analytics verwendet.

Auf der Autoreninstanz sind die Abfragen für Echtzeitberichte.

Auf dem primären Herausgeber dienen die Abfragen der Bereitstellung von Informationen zur Vorbereitung auf den Analytics-Datenimport des Report Importers.

Das Abfrageintervall ist standardmäßig auf 10 Sekunden festgelegt.

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 nicht einzeln in CRXDE konfiguriert sind.

Das Abrufintervall steuert die Häufigkeit der Anfragen an Adobe Analytics für Daten, die abgerufen und in SRP gespeichert werden sollen.

Wenn die Daten als „Big Data“ kategorisiert werden können, kann eine häufigere Abfrage die Community-Site stark belasten.

Die Standardabfrage Importintervall ist auf 12 Stunden festgelegt.

Anpassung von Komponentenberichten component-report-customization

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

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

Verwalten von Benutzerdaten in Analytics manage-user-data-in-analytics

Adobe Analytics stellt APIs bereit, mit denen Sie auf Benutzerdaten zugreifen, diese exportieren und löschen können. Weitere Informationen finden Sie unter Senden von Zugriffs- und Löschanfragen.

Ressourcen resources