Integration

Integrieren von AEM Sites und Experience Platform Web SDK

AEM Sites as a Cloud Service

Erfahren Sie, wie Sie AEM as a Cloud Service mit Experience Platform integrieren. Web SDK. 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.

Außerdem erfahren Sie, wie Sie WKND - Adobe Experience Manager-Beispielprojekt Seitenansichtsdaten im Experience Platform.

Nach Abschluss dieser Einrichtung haben Sie eine solide Grundlage implementiert. Außerdem können Sie die Implementierung der Experience Platform mit Anwendungen wie Real-time Customer Data Platform (Real-Time CDP), Customer Journey Analytics (CJA)und Adobe Journey Optimizer (AJO). Die erweiterte Implementierung trägt durch Standardisierung der Web- und Kundendaten zu einer besseren Kundeninteraktion bei.

Voraussetzungen

Bei der Integration des Experience Platform Web SDK sind folgende Elemente erforderlich.

In AEM als Cloud Service:

In Experience Platform:

  • Zugriff auf die Standardproduktion, Prod Sandbox.
  • Zugriff auf Schemas unter Data Management
  • Zugriff auf Datensätze unter Data Management
  • Zugriff auf Datenspeicher unter Datenerfassung
  • Zugriff auf Tags (früher als Launch bezeichnet) unter "Datenerfassung"

Falls Sie nicht über die erforderlichen Berechtigungen verfügen, verwenden Sie Ihr Systemadministrator Adobe Admin Console kann die erforderlichen Berechtigungen erteilen.

Erstellen eines XDM-Schemas - Experience Platform

Mit dem Experience-Datenmodell (XDM)-Schema können Sie die Kundenerlebnisdaten standardisieren. So sammeln Sie die WKND-Seitenansicht Daten, erstellen Sie ein XDM-Schema und verwenden Sie die von der Adobe bereitgestellten Feldergruppen. AEP Web SDK ExperienceEvent für die Webdatenerfassung.

Es gibt generische und branchenspezifische Beispiele für Einzelhandel, Finanzdienstleistungen, Gesundheitswesen und mehr, eine Reihe von Referenzdatenmodellen, siehe Übersicht über die Datenmodelle der Branche für weitere Informationen.

Erfahren Sie mehr über das XDM-Schema und verwandte Konzepte wie Feldgruppen, Typen, Klassen und Datentypen aus XDM-System - Übersicht.

Die XDM-System - Übersicht ist eine großartige Ressource, um mehr über das XDM-Schema und verwandte Konzepte wie Feldgruppen, Typen, Klassen und Datentypen zu erfahren. Es bietet ein umfassendes Verständnis des XDM-Datenmodells und wie XDM-Schemas erstellt und verwaltet werden, um Daten im gesamten Unternehmen zu standardisieren. Erfahren Sie mehr darüber, wie Sie das XDM-Schema besser verstehen und wie es Ihre Datenerfassungs- und -verwaltungsprozesse nutzen kann.

Erstellen von Datenspeichern - Experience Platform

Ein Datastream weist das Platform Edge Network an, wo die erfassten Daten gesendet werden sollen. Sie kann beispielsweise an Experience Platform, Analytics oder Adobe Target gesendet werden.

Machen Sie sich mit dem Konzept von Datastreams und verwandten Themen wie Data Governance und Konfiguration vertraut, indem Sie die Übersicht über Datenspeicher Seite.

Tag-Eigenschaft erstellen - Experience Platform

Erfahren Sie, wie Sie in Experience Platform eine Tag-Eigenschaft (ehemals Launch) 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 Codetyps, die den Seitennamen, den Site-Abschnitt und den Hostnamen mithilfe der Adobe Client Data Layer der WKND-Site extrahieren. Außerdem das Datenelement vom Typ XDM-Objekt , das dem zuvor neu erstellten WKND-XDM-Schema-Build-in entspricht Erstellen eines XDM-Schemas Schritt.
  • Regel: Senden von Daten an das Platform Edge Network bei jedem Besuch einer WKND-Webseite mithilfe der Adobe Client Data Layer ausgelöst cmp:show -Ereignis.

Beim Erstellen und Veröffentlichen der Tag-Bibliothek mithilfe des Veröffentlichungsfluss, können Sie die Alle geänderten Ressourcen hinzufügen Schaltfläche. 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 Entwicklung Umgebung, dann überprüfen und an die Staging oder Produktion Umgebung.

TIPP

Das Datenelement und der im Video angezeigte Regel-Ereignis-Code stehen Ihnen als Referenz zur Verfügung. Erweitern des unten stehenden Accordion-Elements. Wenn Sie jedoch NICHT die Adobe Client-Datenschicht verwenden, müssen Sie den unten stehenden Code ändern. Es gilt jedoch weiterhin das Konzept der Definition der Datenelemente und ihrer Verwendung in der Regeldefinition.

 Datenelement und Regelereigniscode

  • Die Page Name Datenelementcode.

    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'];
}

  • Die Site Section Datenelementcode.

    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
}

  • Die Host Name Datenelementcode.

    if(window && window.location && window.location.hostname) {
    return window.location.hostname;
}

  • Die all pages - on load Regel-Ereignis-Code

    var pageShownEventHandler = function(evt) {
// defensive coding to avoid a null pointer exception
if(evt.hasOwnProperty("eventInfo") && evt.eventInfo.hasOwnProperty("path")) {
    //trigger Launch 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 Launch Rule, passing in the new 'event' object
    // the 'event' obj can now be referenced by the reserved name 'event' by other Launch 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 Übersicht über Tags bietet umfassende Kenntnisse zu wichtigen Konzepten wie Datenelementen, Regeln und Erweiterungen.

Weitere Informationen zur Integration AEM Kernkomponenten in die Adobe Client-Datenschicht finden Sie im Abschnitt Verwenden der Adobe Client-Datenschicht mit AEM Leitfaden zu Kernkomponenten.

Tag-Eigenschaft mit AEM verbinden

Erfahren Sie, wie Sie die kürzlich erstellte Tag-Eigenschaft über die Adobe IMS- und Adobe Launch-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 Adobe Launch. 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 Cloud Service-Konfiguration von Adobe Launch auf die Webseiten laden.

Laden der Tag-Eigenschaft auf WKND überprüfen

Verwenden von Adobe Experience Platform Debugger Chrome oder Firefox -Erweiterung überprüfen, ob die Tag-Eigenschaft auf WKND-Seiten geladen wird. Sie können überprüfen,

  • Tag-Eigenschaftendetails wie Erweiterung, Version, Name und mehr.
  • Platform Web SDK-Bibliotheksversion, Datastream-ID
  • XDM-Objekt als Teil events -Attribut im Experience Platform Web SDK

Datensatz erstellen - 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 die Experience Platform gesendet werden.

Die Datensätze - Übersicht bietet weitere Informationen zu Konzepten, Konfigurationen und anderen Erfassungsfunktionen.

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 dann, dass die Seitenansichtsdaten in den Experience Platform-Datensatz aufgenommen werden. In der Benutzeroberfläche "Datensatz"werden verschiedene Details wie Datensätze insgesamt, Größe und erfasste Batches zusammen mit einem visuell ansprechenden Balkendiagramm angezeigt.

Zusammenfassung

Gute gemacht! Sie haben die Einrichtung von AEM mit dem Experience Platform Web SDK abgeschlossen, um Daten von einer Website zu erfassen und zu erfassen. 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 Kunden zu erstellen. Lernen Sie weiter und lernen Sie, um das gesamte Potenzial von Adobe Experience Cloud auszuschöpfen.

VERFÜGBARKEIT

Wenn Sie End-to-End-Video , der den gesamten Integrationsprozess anstelle der einzelnen Einrichtungsschritte-Videos abdeckt, können Sie auf here , um darauf zuzugreifen.

Zusätzliche Ressourcen

Auf dieser Seite