Analytics-Konfiguration für Communities-Funktionen analytics-configuration-for-communities-features
Übersicht 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:
-
In der Veröffentlichungsumgebung:
- Community-Berichterstattung Trends
- Ermöglicht Besuchern der Site die Sortierung nach "am häufigsten angesehen", "am aktivsten", "am beliebtesten"
- Anzeigen von Zählungen in Listen für benutzergenerierte Inhalte
-
In der Autorenumgebung:
- Anzeigen von Beitragsdaten in der Mitgliederverwaltungskonsole (Ansichten, Posts, folgt, Gefällt mir)
- Trendzusammenfassung, Video Heartbeat und Videogerät für Aktivierungsressource Berichte
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 des Kryptoschlüssels damit Sie sicherstellen können, dass die Verschlüsselung/Entschlüsselung auf allen AEM korrekt ausgeführt wird
-
Adobe Analytics vorbereiten Report Suite
-
Erstellen von AEM Analytics Cloud Service und Framework
-
Analytics aktivieren für eine Community-Site
-
Überprüfen Zuordnung von Analytics zu AEM Variablen
-
Identifizieren primärer Herausgeber
-
Veröffentlichen die Community-Site
-
Konfigurieren Import von Berichtsdaten von Adobe Analytics zur Community-Site
Voraussetzungen prerequisites
Um die Funktionen von Analytics for Communities zu konfigurieren, müssen Sie sich an Ihren Kundenbetreuer wenden, um ein Adobe Analytics-Konto einzurichten. Report Suite. Nach der Feststellung sollten folgende Informationen verfügbar sein:
-
Unternehmensname
Das mit dem Adobe Analytics-Konto verknüpfte Unternehmen.
-
Benutzername
Der Anmeldename des Benutzers, der zur Verwaltung des Analytics-Kontos berechtigt ist (einschließlich Zugriffsberechtigungen für Webdienste).
-
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 zu verwendenden Analytics Report Suite.
Adobe Analytics Report Suite für Videoberichte adobe-analytics-report-suite-for-video-reporting
Verwenden der Adobe Experience Cloud 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 Benutzernamekann eine neue oder vorhandene Report Suite wie folgt konfiguriert werden:
-
11 Konversionsvariablen (eVars)
-
evar1
bisevar11
enabled -
Kann vorhandene eVars wiederverwenden (umbenennen) oder für Communities-Funktionen verwenden
-
-
7 Erfolgsereignisse (Ereignisse)
-
event1
bisevent7
enabled -
type
Counter
- nicht
Counter (no subrelations)
- nicht
-
Kann vorhandene Ereignisse wiederverwenden (umbenennen) oder Ereignisse erstellen, die für Communities-Funktionen verwendet werden können
-
-
-
Videoberichterkonsole
- Aktivieren
Video Core
- Wählen Sie Speichern aus
- Aktivieren
-
Video Core Measurement Console
- Klicken Sie auf
Use Solution Variables
- Wählen Sie Speichern aus
- Klicken Sie auf
-
Wenn Sie eine neue Report Suite festgelegt ist, kann 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 von vorhandene Report Suite, kann es erforderlich sein, Ändern der Variablenzuordnung vor der Aktivierung des Analytics-Frameworks für eine Community-Site.
Wenden Sie sich an Ihren Kundenbetreuer, wenn Sie Fragen zu den Communities-Variablen haben.
-
evar1
bisevar11
-
event1
bisevent7
Video Heartbeat Analytics video-heartbeat-analytics
Wenn Video Heartbeat Analytics lizenziert ist, wird ein Marketing Cloud Org Id
zugewiesen wurde.
So aktivieren Sie Video Heartbeat-Berichte nach Konfigurieren der Analytics Report Suite für Videoberichte:
- Erstellen Sie eine Analytics Cloud-Dienst
- Aktivieren Analytics für eine Community-Site
- Verknüpfen Sie die
Marketing Cloud Org Id
mit der Community-Site
Die Marketing Cloud Org Id
kann zum Zeitpunkt der Community-Site-Erstellung oder später von Ändern die Eigenschaften der Community-Site.
Wenn Video Heartbeat Analytics aktiviert ist, instanziiert der JavaScript-Code (JS) für den Videoplayer den Video Heartbeat Library-Code (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:
- Über die globale Navigation: Instrumente > Implementierung > Cloud Service
- Hinunter scrollen zu Adobe Analytics
- Auswählen Jetzt konfigurieren oder Konfigurationen anzeigen
Dialogfeld "Konfiguration erstellen" create-configuration-dialog
- Auswählen
[+]
Symbol neben Verfügbare Konfigurationen , sodass Sie eine Konfiguration erstellen können.
Im Dialogfeld "Konfiguration erstellen"geben die eingegebenen Werte die Konfiguration an.
-
Titel
(Erforderlich) Ein Anzeigetitel für die Konfiguration.
Geben Sie beispielsweise Community Analytics -
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 -
Vorlage
Klicken Sie auf
Adobe Analytics Configuration
-
Wählen Sie Erstellen aus
- Startet die Konfigurationsseite und öffnet
Analytics Settings
dialog
- Startet die Konfigurationsseite und öffnet
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. Dieses Dialogfeld erfordert die Voraussetzungen für Kontoinformationen vom Kundenbetreuer erhalten.
-
Unternehmen
Das mit dem Adobe Analytics-Konto verknüpfte Unternehmen.
-
Benutzername
Der Anmeldename des Benutzers, der zur Verwaltung des Analytics-Kontos berechtigt ist.
-
Kennwort
Das Anmeldekennwort für den autorisierten Benutzer.
-
Rechenzentrum
Wählen Sie das Analytics-Rechenzentrum aus, in dem die Report Suite gehostet wird.
-
Kein Verfolgungs-Tag zur Seite hinzufügen
Behalten Sie die Standardeinstellung bei (deaktiviert).
-
AppMeasurement verwenden
Behalten Sie die Standardeinstellung bei (deaktiviert).
-
Nachts keine Seitenimpressionen importieren (verfassen)
Behalten Sie die Standardeinstellung bei (deaktiviert).
-
Nachts keine Seitenimpressionen importieren (veröffentlichen)
Behalten Sie die Standardeinstellung bei (deaktiviert).
Speichern der Einstellungen:
-
Auswählen Verbindung zu Analytics herstellen
-
Wenn dies nicht erfolgreich war,
- Vergewissern Sie sich, dass Einträge keine führenden Leerzeichen enthalten.
- Testen Sie ein anderes Rechenzentrum.
-
-
Wählen Sie OK aus.
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.
-
Auswählen
[+]
Symbol neben Verfügbare Frameworks damit Sie ein Framework erstellen können. -
Titel
(Erforderlich) Ein Anzeigetitel für das Framework. Geben Sie beispielsweise Gemeinschaftsrahmen.
-
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. -
Vorlage
Klicken Sie auf
Adobe Analytics Framework
. -
Wählen Sie Erstellen aus.
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 definiert in der Report Suite.
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
-
Auswählen Element hinzufügen +.
Es werden zwei Dropdown-Felder angezeigt.
-
Wählen Sie eine
Report suite.
Die mit dem Unternehmenskonto verknüpften Report Suites stehen zur Auswahl zur Verfügung.
-
Auswählen Ja im sich öffnenden Dialogfeld:
code language-none Load default server settings? Do you want to load the default server settings and overwrite current values in the Server section?
-
Wählen Sie eine
Run Mode
. -
Auswählen Veröffentlichen.
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
Hinzufügen des Analytics Cloud-Dienstes während der Erstellen einer Community-Site:
-
In Schritt 3 wird unter dem Registerkarte "ANALYTICS":
- Wählen Sie die Analytics aktivieren aktivieren.
- Wählen Sie das Framework aus der Dropdown-Liste aus.
-
Kehren Sie optional zur Analytics-Framework-Konfiguration zurück, um die Variablenzuordnungen anzupassen.
Aktivieren für bestehende Community-Site enable-for-existing-community-site
Hinzufügen des Analytics Cloud-Dienstes zu einem bestehende Community-Site:
-
Navigieren Sie zum Communities > Sites Konsole.
-
Wählen Sie das Symbol Site bearbeiten der Community-Site aus.
-
Wählen Sie EINSTELLUNGEN aus.
-
Im Abschnitt Analytics :
- Wählen Sie die Analytics aktivieren aktivieren.
- Wählen Sie das Framework aus der Dropdown-Liste aus.
-
Kehren Sie optional zur Analytics-Framework-Konfiguration zurück, um die Variablenzuordnungen anzupassen.
Aktivieren für benutzerdefinierte Sites enable-for-customized-sites
Damit Analytics-Tracking und -Import für eine Community-Site ordnungsgemäß funktionieren, ist dies ein Seitenelement mit der Variablen scf-js-site-title
-Klasse und href-Attribute müssen vorhanden sein. Auf der Seite sollte nur ein solches Element vorhanden sein, wie es beispielsweise in einem nicht geänderten sitepage.hbs
Skript für eine Community-Site. Der Wert von siteUrl
wird extrahiert und an Adobe Analytics gesendet, da Sitepfad.
# 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>
Für angepasste Community-Site überlagert sitepage.hbs
-Skript verwenden, stellen Sie sicher, dass das -Element vorhanden ist. Die siteUrl
wird festgelegt, wenn sie auf dem Server gerendert wird, bevor sie an den Client gesendet werden.
Für generische AEM , die Communities-Komponenten enthält, aber nicht mit der Assistent zur Site-Erstellung, muss das Element hinzugefügt werden. Der Wert von href sollte der Pfad zur Site sein. Wenn der Sitepfad beispielsweise /content/my/company/en
, und verwenden Sie dann:
<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 Autorenumgebung OSGi-Konfiguration, AEM Communities Analytics Component Configuration
bietet 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 AEM Variablen neu erstellen 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 :
-
MIME-Typ: video/mp4
-
Community-Site-Titel: Geometrixx Communities
-
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 (authorizableId):
aaron.mcdonald@mailinator.com
-
SRP-Pfad zu UGC:
/content/usergenerated/asi/.../forum/jmtz-topic3
oder Pfad der zu befolgenden Komponente:/content/sites/<site name>/en/jcr:content/content/primary/forum
-
Pfad zum Community-Site-Inhalt:
/content/sites/<site name>/en
Ä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:
-
evar1
bisevar11
-
event1
bisevent7
Primärer Herausgeber primary-publisher
Wenn es sich bei der ausgewählten Bereitstellung um eine Veröffentlichungsfarmmuss eine AEM Veröffentlichungsinstanz als primärer Herausgeber für die Abfrage von Adobe Analytics für Berichtsdaten identifiziert werden, an die geschrieben werden soll SRP.
Standardmäßig wird die Variable AEM Communities Publisher Configuration
Die OSGi-Konfiguration identifiziert die Veröffentlichungsinstanz als primären Herausgeber, sodass sich alle Veröffentlichungsinstanzen in einer Veröffentlichungsfarm selbst als primär identifizieren.
Daher ist es erforderlich, die Konfiguration auf allen sekundären Veröffentlichungsinstanzen zu bearbeiten, um die Auswahl der Primärer Herausgeber aktivieren.
Spezifische Anweisungen finden Sie im Abschnitt des primären Herausgebers unter 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 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.
Community-Site und Analytics Cloud-Dienst veröffentlichen 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 wird angepasst, replizieren Sie die Konfiguration in der Veröffentlichungsumgebung durch (erneut) Veröffentlichen der Community-Site.
Abrufen von Berichten aus Analytics obtaining-reports-from-analytics
Berichtverwaltung report-management
Der Autor und der primäre Herausgeber OSGi-Konfiguration, 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, wird die OSGi-Konfiguration, AEM Communities Analytics Report Importer
kann 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 von Anforderungen an Adobe Analytics, in denen Daten abgerufen und gespeichert werden sollen SRP.
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.
Die Standardabfrage Importintervall auf 12 Stunden festgelegt ist.
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:
-
Melden Sie sich beim primären Herausgeber mit Administratorrechten an.
-
Gehen Sie zu CRXDE Lite. Beispiel: https://localhost:4503/crx/de.
-
Unter dem
jcr:content
Knoten des Sprachstamms (z. B./content/sites/engage/en/jcr:content
), navigieren Sie zur 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
Knoten.- Ändern der
interval
-Eigenschaft überschreibt das Report Importer-Intervall. - Der Wert wird in Sekunden angegeben und auf vier Stunden (14400 Sekunden) festgelegt.
- Ändern der
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
- Adobe Experience Cloud: Hilfe und Referenz zu Analytics
- AEM: Integration mit Adobe Analytics
- AEM: Analytics mit externen Anbietern