[Integration]{class="badge positive"}
Integrieren von AEM Sites und Experience Platform Web SDK
[AEM Sites as a Cloud Service]{class="badge informative"}
Erfahren Sie, wie Sie AEM as a Cloud Service mit dem Experience Platform Web SDK integrieren. Dieser grundlegende Schritt ist für die Integration von Adobe Experience Cloud-Produkten wie Adobe Analytics, Target oder neueren innovativen Produkten wie Real-time Customer Data Platform, Customer Journey Analytics und Journey Optimizer von entscheidender Bedeutung.
Sie lernen auch, wie Sie Seitenaufrufdaten für das WKND – Beispielprojekt für Adobe Experience Manager in Experience Platform sammeln und senden.
Nach Abschluss dieser Einrichtung haben Sie eine solide Grundlage implementiert. Außerdem sind Sie bereit, die Implementierung von Experience Platform mit Anwendungen wie Real-Time Customer Data Platform (Real-Time CDP), Customer Journey Analytics (CJA), und Adobe Journey Optimizer (AJO) voranzutreiben. Die erweiterte Implementierung trägt durch die Standardisierung der Web- und Kundendaten zu einer besseren Interaktion mit der Kundschaft bei.
Voraussetzungen
Bei der Integration des Experience Platform Web SDK sind folgende Elemente erforderlich.
In AEM as Cloud Service:
- AEM-Adminzugriff auf AEM as a Cloud Service-Umgebungen
- Zugriff von Bereitstellungs-Manager auf Cloud Manager
- Klonen Sie das WKND – Adobe Experience Manager-Beispielprojekt und stellen Sie es in Ihre AEM as a Cloud Service-Umgebung bereit.
In Experience Platform:
- Zugriff auf die Standardproduktion, Prod-Sandbox
- Zugriff auf Schemata unter Daten-Management
- Zugriff auf Datensätze unter Daten-Management
- Zugriff auf Datenströme unter Datenerfassung
- Zugriff auf Tags unter Datenerfassung
Falls Sie nicht über die erforderlichen Berechtigungen verfügen, können Ihre Systemadmins über Adobe Admin Console die erforderlichen Berechtigungen erteilen.
Erstellen eines XDM-Schemas – Experience Platform
Mit dem Experience-Datenmodell (XDM)-Schema können Sie die Kundenerlebnisdaten standardisieren. Um die WKND-Seitenaufrufe zu erfassen, erstellen Sie ein XDM-Schema und verwenden die von Adobe bereitgestellten Feldergruppen AEP Web SDK ExperienceEvent
für die Web-Datenerfassung.
Es gibt allgemeine und branchenspezifische Datenmodelle, z. B. für den Einzelhandel, Finanzdienstleistungen, das Gesundheitswesen usw. Weitere Informationen finden Sie in der Übersicht über Branchendatenmodelle.
Weitere Informationen über das XDM-Schema und verwandte Konzepte wie Feldergruppen, Typen, Klassen und Datentypen finden Sie in der XDM-Systemübersicht.
Die XDM-Systemübersicht ist eine großartige Ressource, um mehr über das XDM-Schema und verwandte Konzepte wie Feldergruppen, Typen, Klassen und Datentypen zu erfahren. Sie bietet ein umfassendes Verständnis des XDM-Datenmodells und davon, wie XDM-Schemata erstellt und verwaltet werden, um Daten im gesamten Unternehmen zu standardisieren. Lernen Sie das XDM-Schema besser kennen und erfahren Sie, wie es Ihre Datenerfassungs- und Datenverwaltungsprozesse unterstützen kann.
Erstellen eines Datenstroms – Experience Platform
Ein Datenstrom weist das Platform Edge Network an, wohin die erfassten Daten gesendet werden sollen. Sie können beispielsweise an Experience Platform, Analytics oder Adobe Target gesendet werden.
Machen Sie sich mit dem Konzept von Datenströmen und verwandten Themen wie Data Governance und Konfiguration vertraut, indem Sie die Seite Datenspeicher-Übersicht besuchen.
Erstellen einer Tag-Eigenschaft – Experience Platform
Erfahren Sie, wie Sie in Experience Platform eine Tag-Eigenschaft erstellen, um die JavaScript-Bibliothek des Web SDK zur WKND-Website hinzuzufügen. Die neu definierte Tag-Eigenschaft verfügt über die folgenden Ressourcen:
- Tag-Erweiterungen: Core und Adobe Experience Platform Web SDK
- Datenelemente: Die Datenelemente des benutzerdefinierten Code-Typs, die den Seitennamen, den Site-Abschnitt und den Hostnamen mithilfe der Datenschicht der Adobe Client-WKND-Site extrahieren. Auch das Datenelement vom XDM-Objekttyp, das mit dem neu erstellten WKND-XDM-Schema übereinstimmt, wurde in einem früheren Schritt unter Erstellen eines XDM-Schemas erstellt.
- Regel: Senden von Daten an das Platform Edge Network bei jedem Besuch einer WKND-Web-Seite unter Verwendung des von der Adobe Client-Datenschicht ausgelösten Ereignisses
cmp:show
.
Beim Erstellen und Veröffentlichen der Tag-Bibliothek mit dem Veröffentlichungsfluss können Sie die Schaltfläche Alle geänderten Ressourcen hinzufügen verwenden. So wählen Sie alle Ressourcen wie Datenelemente, Regeln und Tag-Erweiterungen aus, anstatt eine einzelne Ressource zu identifizieren und auszuwählen. Während der Entwicklungsphase können Sie die Bibliothek auch nur in der Entwicklungsumgebung veröffentlichen und sie dann verifizieren und in die Staging- oder Produktionsumgebung übertragen.
-
Der Code für das Datenelement
Page Name
:code language-javascript if(event && event.component && event.component.hasOwnProperty('dc:title')) { // return value of 'dc:title' from the data layer Page object, which is propogated via 'cmp:show` event return event.component['dc:title']; }
-
Der Code für Datenelemente
Site Section
.code language-javascript if(event && event.component && event.component.hasOwnProperty('repo:path')) { let pagePath = event.component['repo:path']; let siteSection = ''; //Check of html String in URL. if (pagePath.indexOf('.html') > -1) { siteSection = pagePath.substring(0, pagePath.lastIndexOf('.html')); //replace slash with colon siteSection = siteSection.replaceAll('/', ':'); //remove `:content` siteSection = siteSection.replaceAll(':content:',''); } return siteSection }
-
Der Code für Datenelemente
Host Name
.code language-javascript if(window && window.location && window.location.hostname) { return window.location.hostname; }
-
Der Code für Regelereignisse
all pages - on load
.code language-javascript var pageShownEventHandler = function(evt) { // defensive coding to avoid a null pointer exception if(evt.hasOwnProperty("eventInfo") && evt.eventInfo.hasOwnProperty("path")) { // trigger tags Rule and pass event console.debug("cmp:show event: " + evt.eventInfo.path); var event = { // include the path of the component that triggered the event path: evt.eventInfo.path, // get the state of the component that triggered the event component: window.adobeDataLayer.getState(evt.eventInfo.path) }; // Trigger the tags Rule, passing in the new 'event' object // the 'event' obj can now be referenced by the reserved name 'event' by other tags data elements // i.e 'event.component['someKey']' trigger(event); } } // set the namespace to avoid a potential race condition window.adobeDataLayer = window.adobeDataLayer || []; // push the event listener for cmp:show into the data layer window.adobeDataLayer.push(function (dl) { //add event listener for 'cmp:show' and callback to the 'pageShownEventHandler' function dl.addEventListener("cmp:show", pageShownEventHandler); });
Die Tags-Übersicht bietet umfassende Kenntnisse zu wichtigen Konzepten wie Datenelementen, Regeln und Erweiterungen.
Weitere Informationen zur Integration von AEM-Kernkomponenten in die Adobe Client-Datenschicht finden Sie im Handbuch zum Verwenden der Adobe Client-Datenschicht mit AEM-Kernkomponenten.
Verbinden der Tag-Eigenschaft mit AEM
Erfahren Sie, wie Sie die kürzlich erstellte Tag-Eigenschaft über Adobe IMS und Tags in der Adobe Experience Platform-Konfiguration in AEM mit AEM verknüpfen. Wenn eine AEM as a Cloud Service-Umgebung eingerichtet ist, werden mehrere Konfigurationen des technischen Adobe IMS-Kontos automatisch generiert, einschließlich Tags. Eine schrittweise Anleitung finden Sie unter Verbinden von AEM Sites mit der Tag-Eigenschaft über IMS.
Für AEM Version 6.5 müssen Sie jedoch eine manuell konfigurieren.
Nach Verknüpfung der Tag-Eigenschaft kann die WKND-Site die JavaScript-Bibliothek der Tag-Eigenschaft mithilfe der Tags in der Adobe Experience Platform-Cloud-Service-Konfiguration auf die Web-Seiten laden.
Überprüfen des Ladens von Tag-Eigenschaften auf WKND
Überprüfen Sie mit der Chrome-Erweiterung von Adobe Experience Platform Debugger, ob die Tag-Eigenschaft auf WKND-Seiten geladen wird. Sie können Folgendes überprüfen:
- Tag-Eigenschaften wie Erweiterung, Version, Name und mehr.
- Platform Web SDK-Bibliotheksversion, Datenspeicher-ID
- XDM-Objekt als Teil des
events
-Attributs im Experience Platform Web SDK
Erstellen von Datensätzen – Experience Platform
Die mit dem Web SDK erfassten Seitenansichtsdaten werden im Experience Platform Data Lake als Datensätze gespeichert. Der Datensatz ist ein Speicher- und Verwaltungskonstrukt für eine Sammlung von Daten wie eine Datenbanktabelle, die einem Schema folgt. Erfahren Sie, wie Sie einen Datensatz erstellen und den zuvor erstellten Datenspeicher so konfigurieren, dass Daten an Experience Platform gesendet werden.
Die Datensatz-Übersicht bietet weitere Informationen zu Konzepten, Konfigurationen und anderen Aufnahmefunktionen.
WKND-Seitenansichtsdaten in Experience Platform
Nach der Einrichtung des Web SDK mit AEM, insbesondere auf der WKND-Site, ist es an der Zeit, Traffic durch die Site-Seiten zu generieren. Bestätigen Sie anschließend, dass die Seitenaufrufdaten in den Experience Platform-Datensatz aufgenommen werden. In der Datensatzbenutzeroberfläche werden verschiedene Details wie die Gesamtdatensätze, die Größe und die erfassten Batches zusammen mit einem visuell ansprechenden Balkendiagramm angezeigt.
Zusammenfassung
Gut gemacht! Sie haben die Einrichtung von AEM mit dem Experience Platform Web SDK abgeschlossen, um Daten von einer Website zu erfassen und aufzunehmen. Auf dieser Grundlage können Sie nun weitere Möglichkeiten zur Verbesserung und Integration von Produkten wie Analytics, Target, Customer Journey Analytics (CJA) und vielen anderen erkunden, um umfangreiche, personalisierte Erlebnisse für Ihre Kundschaft zu erstellen. Lernen und forschen Sie weiter, um das gesamte Potenzial von Adobe Experience Cloud auszuschöpfen.