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 für die Aktivierung eine Videoressource Ansicht, die ihm zugewiesen wurde, sendet der Ressourcenplayer Ereignis einschließlich Video Heartbeat-Daten an Analytics. Auf der Community-Site können Administratoren verschiedene Berichte zur Wiedergabe des Videos sehen.
Darüber hinaus sind Analysen erforderlich für:
In der Umgebung "Veröffentlichen":
Umgebung des Verfassers:
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:
Replizieren Sie den kryptographischen Schlüssel, um sicherzustellen, dass Verschlüsselung/Entschlüsselung in allen AEM korrekt ausgeführt wird.
Vorbereitung einer Adobe Analytics Report Suite
Erstellen eines AEM Analytics Cloud-Dienstes und Framework
Aktivieren von Analytics für eine Community-Site
VerifyAnalytics zu AEM Variablenzuordnung
Identifizieren Sie den primären Herausgeber.
Community-Site veröffentlichen
Importieren von Berichtsdaten von Adobe Analytics zur Community-Site konfigurieren
Zur Konfiguration der Funktionen von Analytics für Communities müssen Sie mit Ihrem Kundenbetreuer zusammenarbeiten, um ein Adobe Analytics-Konto und Report Suite einzurichten. Nach der Festlegung sollten folgende Informationen verfügbar sein:
Unternehmensname
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 beinhalten).
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.
Mithilfe des Report Suite Manager der Adobe Marketing Cloud können Analytics-Report Suites so konfiguriert werden, dass eine Community-Site zur Bereitstellung von Berichten für Communities-Funktionen aktiviert werden kann.
Durch die Anmeldung bei Adobe Experience Cloud mit Firmen- und Benutzername ist es möglich, eine neue oder vorhandene Report Suite zu konfigurieren, die Folgendes aufweist:
11 Umrechnungsvariablen (eVars)
evar1
durch evar11
aktiviert
Kann vorhandene eVars wiederverwenden (umbenennen) oder neue erstellen, die für Communities-Funktionen verwendet werden können
7 Erfolgserlebnisse (Ereignis)
event1
durch event7
aktiviert
type Counter
Counter (no subrelations)
Kann vorhandene Ereignis wiederverwenden (umbenennen) oder neue erstellen, die für Communities-Funktionen verwendet werden können
Video Berichte Console
Video Core
Video-Core-Messkonsole
Use Solution Variables
Wenn Sie eine neue Report Suite verwenden, beachten Sie, dass eine neue Report Suite möglicherweise nur 4 eVars und 6 Ereignis-Variablen hat, während für Communities 11 eVars und 7 Ereignis vars erforderlich sind.
Wenn Sie eine vorhandene Report Suite verwenden, müssen Sie möglicherweise die Variablenzuordnung ä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 AEM Variablen in andere Analytics-Variablen finden Sie im Abschnitt Ändern der Analytics-Variablenzuordnung.
Andernfalls kann es zu nicht wiederherstellbaren Datenverlusten kommen.
Wenn Video Heartbeat Analytics lizenziert ist, wird ein Marketing Cloud Org Id
zugewiesen.
So aktivieren Sie Video Heartbeat Berichte nach der Konfiguration der Analytics Report Suite für Video Berichte](#adobe-analytics-report-suite-for-video-reporting):[
Marketing Cloud Org Id
mit der Community-Site.Das Marketing Cloud Org Id
kann zum Zeitpunkt der Community-Site-Erstellung oder höher 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 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.
So erstellen Sie eine neue Analytics-Integration, die Adobe Analytics mit der AEM Community-Site integriert, mithilfe der Standard-Benutzeroberfläche in der Autoreninstanz:
[+]
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. Aktivieren von Community Analytics ein
Name
(Optional) Wenn kein Name angegeben ist, wird standardmäßig ein gültiger Knotenname verwendet, der aus dem Titel abgeleitet wurde.
Geben Sie beispielsweise Communities ein.
Vorlage
Wählen Sie nun eine der folgenden Optionen aus Adobe Analytics Configuration
Wählen Sie Erstellen
Analytics Settings
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. Für dieses Dialogfeld sind die erforderlichen Kontoinformationen erforderlich, die vom Kundenbetreuer abgerufen 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 des autorisierten Benutzers.
Rechenzentrum
Wählen Sie das Analytics-Rechenzentrum, in dem die Report Suite gehostet wird.
Kein Verfolgungs-Tag zur Seite hinzufügen
Als Standard beibehalten (deaktiviert).
AppMeasurement verwenden
Als Standard beibehalten (deaktiviert).
Nachts keine Seitenimpressionen importieren (verfassen)
Als Standard beibehalten (deaktiviert).
Nachts keine Seitenimpressionen importieren (veröffentlichen)
Als Standard beibehalten (deaktiviert).
So speichern Sie die Einstellungen:
Wählen Sie Verbindung zu Analytics
Wenn dies nicht erfolgreich ist,
Wählen Sie OK aus.
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.
Titel
(Erforderlich) Ein Anzeigentitel für das Framework
Geben Sie beispielsweise Aktivieren des Community-Frameworks ein.
Name
(Optional) Wenn kein Name angegeben ist, wird standardmäßig ein gültiger Knotenname verwendet, der aus dem Titel abgeleitet wurde.
Geben Sie beispielsweise Communities ein.
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.
Der Zweck des Frameworks ist die Zuordnung AEM Variablen zu Analytics-Variablen (eVars und Ereignis). Die für die Zuordnung verfügbaren Analytics-Variablen sind definiert in der Report Suite.
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.
Wählen Sie Hinzufügen Element +.
Es werden zwei Dropdownfelder angezeigt.
Wählen Sie ein Report suite.
Die mit dem Firmen-Konto verknüpften Report Suites stehen zur Auswahl zur Verfügung.
Wählen Sie Ja in dem sich öffnenden Dialogfeld aus:
Load default server settings?
Do you want to load the default server settings and overwrite current values in the Server section?
Wählen Sie ein Run Mode
.
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.
So fügen Sie beim Erstellen einer neuen Community-Site den Analytics-Cloud-Dienst hinzu:
In Schritt 3 unter der Registerkarte ANALYTICS:
Optional können Sie zur Analytics-Framework-Konfiguration zurückkehren, um die Variablenzuordnungen anzupassen.
So fügen Sie einen Analytics-Cloud-Dienst zu einer bestehenden Community-Site hinzu:
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:
Optional können Sie zur Analytics-Framework-Konfiguration zurückkehren, um die Variablenzuordnungen anzupassen.
Damit Analytics-Verfolgung und -Import für eine Community-Site ordnungsgemäß funktionieren, muss ein Seitenelement mit den Attributen scf-js-site-title
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 Skript sitepage.hbs
überlagert, sicher, dass das Element vorhanden ist. Die Variable siteUrl
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 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>
Analytics wird automatisch für mehrere Communities-Funktionen verwendet.
Die Authoring-Umgebung OSGi configuration, 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.
Die Protokoll-Komponenten werden zur Implementierung der Blog-Funktion verwendet.
Sobald die Community-Site mit aktiviertem Analytics und aktiviertem Cloud-Konfigurationsframework gespeichert wurde, werden die AEM automatisch den Analytics-eVars und -Ereignissen zugeordnet, die mit "evar1"bzw. "Ereignis1"beginnen und um 1 inkrementiert 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 < a0/>neu zuordnen und die ursprüngliche Zuordnung wiederherstellen.
Im Folgenden finden Sie ein Beispiel für Standardzuordnungen nach dem Einstieg-Lernprogramm :
Aktivierung Ressource Typ |
Site Titel |
Funktion Typ |
Gruppe Titel |
Gruppe Pfad |
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:
MIME-Typ: video/mp4
Community-Site-Titel: Geometrixx
Community-Funktionsname: Forum
Community-Gruppenname: Wandern
Pfad zu Community-Gruppeninhalten: /content/sites/<site name>/en/groups/hiking
UGC component resourceType: social/forum/components/hbs/topic
UGC-Komponententitel: Wanderthemen
login (authorizedId): aaron.mcdonald@mailinator.com
SRP-Pfad zu UGC: /content/usergenerated/asi/.../forum/jmtz-topic3
oder
Komponentenpfad: /content/sites/<site name>/en/jcr:content/content/primary/forum
Pfad zum Inhalt der Community-Site: /content/sites/<site name>/en
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 anderen Analytics-eVars oder -Ereignissen zu und stellen Sie die ursprünglichen Zuordnungen wieder her.
Es ist wichtig zu bleiben, bevor die Community-Site published mit aktivierter Analytics-Funktion ist. Andernfalls besteht das Risiko eines Datenverlusts.
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 dann die bereits vorhandene Zuordnung wiederherstellen und die Communities AEM Variablen verschieben, die automatisch zugeordnet wurden (als Analytics für die Community-Site aktiviert wurde), zu anderen Analytics-Variablen. Diese Neuzuordnung sollte für alle Communities-Komponenten einheitlich sein.
Andernfalls kann es zu nicht wiederherstellbaren Datenverlusten kommen.
Wenn die gewählte Bereitstellung eine Veröffentlichungsfarm ist, muss eine AEM Veröffentlichungsinstanz als primärer Herausgeber für die Abfrage von Adobe Analytics identifiziert werden, damit Berichtsdaten in SRP geschrieben werden.
Standardmäßig identifiziert die OSGi-Konfiguration die Veröffentlichungsinstanz als primären Herausgeber, sodass alle Veröffentlichungsinstanzen in einer Veröffentlichungsfarm sich selbst als Primär identifizieren.AEM Communities Publisher Configuration
Daher müssen Sie die Konfiguration in allen sekundären Veröffentlichungsinstanzen bearbeiten, um die Markierung des Kontrollkästchens Primär Publisher aufzuheben.
Spezifische Anweisungen finden Sie im Abschnitt zum primären Herausgeber von 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.
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 primären Verschlüsselungsschlüssel verwenden.
Befolgen Sie dazu die Anweisungen unter Crypto-Schlüssel replizieren.
Nachdem der Analytics-Cloud-Dienst für eine Community-Site aktiviert wurde und die Zuordnung von Analytics zu AEM Variablen gegebenenfalls angepasst wurde, muss die Konfiguration der Veröffentlichungsvariablen durch (re)Veröffentlichen der Community-Site repliziert werden.
Die OSGi-Konfiguration, AEM Communities Analytics Report Management
des Autors und des primären Herausgebers 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.
Nachdem eine für Analytics aktivierte Community-Site veröffentlicht wurde, kann die OSGi-Konfiguration des primären Herausgebers, AEM Communities Analytics Report Importer
konfiguriert werden, um das Standard-Abfrageintervall für die Konfigurationen festzulegen, die nicht einzeln in CRXDE konfiguriert sind.
Das Abfrageintervall steuert die Häufigkeit von Anfragen an Adobe Analytics, nach denen Daten abgerufen und in SRP gespeichert werden sollen.
Wenn die Daten als "Big Data"kategorisiert werden können, kann eine häufigere Abfrage eine große Belastung für die Community-Site bedeuten.
Die Standardabfrage Importintervall ist auf 12 Stunden eingestellt.
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.
Navigieren Sie zu CRXDE Lite. Beispiel: https://localhost:4503/crx/de.
Navigieren Sie unter dem Knoten jcr:content des Sprachstamms (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 Node total
.
interval
wird das Report Importer-Intervall außer Kraft gesetzt.Adobe Analytics stellt APIs bereit, mit denen Sie auf Benutzerdaten zugreifen, sie exportieren und löschen können. Weitere Informationen finden Sie unter Anforderungen senden und Löschen.