Integrering

Integrera AEM Sites och Experience Platform Web SDK

AEM Sites as a Cloud Service

Lär dig integrera AEM as a Cloud Service med Experience Platform Web SDK. Detta grundläggande steg är avgörande för att integrera Adobe Experience Cloud-produkter som Adobe Analytics, Target eller nyligen lanserade innovativa produkter som Real-time Customer Data Platform, Customer Journey Analytics och Journey Optimizer.

Du får även lära dig hur du samlar in och skickar WKND - exempel på Adobe Experience Manager-projekt sidvisningsdata i Experience Platform.

När du är klar med konfigurationen har du implementerat en stabil grund. Du är också redo att fortsätta implementeringen av Experience Platform med program som Real-time Customer Data Platform (Real-Time CDP), Customer Journey Analytics (CJA)och Adobe Journey Optimizer (JO). Den avancerade implementeringen bidrar till att öka kundengagemanget genom att standardisera webb- och kunddata.

Förutsättningar

Följande krävs vid integrering av Experience Platform Web SDK.

I AEM som Cloud Service:

I Experience Platform:

  • Tillgång till standardproduktionen Prod sandlåda.
  • Åtkomst till Scheman under Datahantering
  • Åtkomst till Datauppsättningar under Datahantering
  • Åtkomst till Datastreams under Datainsamling
  • Åtkomst till Taggar (tidigare Launch) under Datainsamling

Om du inte har de behörigheter som krävs använder systemadministratören Adobe Admin Console kan ge nödvändiga behörigheter.

Skapa XDM-schema - Experience Platform

XDM-schemat (Experience Data Model) hjälper er att standardisera kundupplevelsedata. Samla in WKND-sidvy data, skapa ett XDM-schema och använda fältgrupper som tillhandahålls av Adobe AEP Web SDK ExperienceEvent för insamling av webbdata.

Det finns generiska och specifika branscher, t.ex. Retail, Financial Services, Healthcare med flera, en serie referensdatamodeller, se Översikt över branschdatamodeller för mer information.

Lär dig mer om XDM-schema och relaterade koncept som fältgrupper, typer, klasser och datatyper från XDM - systemöversikt.

The XDM - systemöversikt är en bra resurs att lära sig om XDM-schema och relaterade koncept som fältgrupper, typer, klasser och datatyper. Det ger en omfattande förståelse för XDM-datamodellen och hur man skapar och hanterar XDM-scheman för att standardisera data i hela företaget. Utforska den för att få en djupare förståelse för XDM-schemat och hur det kan hjälpa er med datainsamling och datahantering.

Skapa dataström - Experience Platform

En DataStream instruerar Platform Edge Network var insamlade data ska skickas. Den kan till exempel skickas till Experience Platform, Analytics eller Adobe Target.

Bekanta dig med begreppet Datastreams och relaterade ämnen som datastyrning och konfiguration genom att besöka Översikt över datastreams sida.

Skapa tagg, egenskap - Experience Platform

Lär dig hur du skapar en taggegenskap (tidigare kallad Launch) i Experience Platform för att lägga till JavaScript-biblioteket för Web SDK på WKND-webbplatsen. Den nyligen definierade taggegenskapen har följande resurser:

  • Taggtillägg: Core och Adobe Experience Platform Web SDK
  • Dataelement: Dataelement av anpassad kodtyp som extraherar sidnamn, webbplatsavsnitt och värdnamn med hjälp av WKND-platsens Adobe-klientdatalager. XDM-objektets datatypselement som överensstämmer med det nya WKND XDM-schemabygget som skapades tidigare Skapa XDM-schema steg.
  • Regel: Skicka data till Platform Edge Network när en WKND-webbsida besöktes med hjälp av Adobe-klientdatalagret som utlöses cmp:show -händelse.

När du skapar och publicerar taggbiblioteket med Publiceringsflöde kan du använda Lägg till alla ändrade resurser -knappen. Om du vill välja alla resurser som dataelement, regel och taggtillägg i stället för att identifiera och välja en enskild resurs. Under utvecklingsfasen kan du dessutom publicera biblioteket endast på Utveckling miljö, verifiera och marknadsför den sedan till Scen eller Produktion miljö.

TIP
Det dataelement och den regelhändelsekod som visas i videon är tillgängliga som referens, expandera dragspelselementet nedan. Om du emellertid INTE använder Adobe-klientdatalagret måste du ändra nedanstående kod, men begreppet att definiera dataelementen och använda dem i regeldefinitionen gäller fortfarande.
Dataelement och regelhändelsekod
  • The Page Name Dataelementkod.

    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'];
    }
    
  • The Site Section Dataelementkod.

    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
    }
    
  • The Host Name Dataelementkod.

    code language-javascript
    if(window && window.location && window.location.hostname) {
        return window.location.hostname;
    }
    
  • The all pages - on load Regelhändelsekod

    code language-javascript
    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);
    });
    

The Översikt över taggar ger ingående kunskap om viktiga begrepp som dataelement, regler och tillägg.

Mer information om hur du integrerar AEM med Adobe Client Data Layer finns i Använda Adobe Client Data Layer med AEM Core Components Guide.

Koppla tagg-egenskap till AEM

Lär dig länka den nyligen skapade taggegenskapen till AEM via Adobe IMS och Adobe Launch Configuration i AEM. När en AEM as a Cloud Service miljö är etablerad genereras flera Adobe IMS-konfigurationer av det tekniska kontot automatiskt, inklusive Adobe Launch. För AEM 6.5 måste du dock konfigurera en manuellt.

När du har länkat taggegenskapen kan WKND-webbplatsen läsa in taggegenskapens JavaScript-bibliotek på webbsidorna med molntjänstkonfigurationen för Adobe Launch.

Verifiera inläsning av taggegenskap på WKND

Använda Adobe Experience Platform Debugger Krom eller Firefox kontrollerar du om taggegenskapen läses in på WKND-sidor. Du kan verifiera,

  • Taggegenskapsinformation som tillägg, version, namn med mera.
  • Plattforms-SDK-biblioteksversion, DataStream ID
  • XDM-objekt som del events attribut i Experience Platform Web SDK

Skapa datauppsättning - Experience Platform

De sidvisningsdata som samlas in med Web SDK lagras som datauppsättningar i Experience Platform. Datauppsättningen är en lagrings- och hanteringskonstruktion för en samling data, som en databastabell som följer ett schema. Lär dig hur du skapar en datauppsättning och konfigurerar den tidigare skapade datauppsättningen för att skicka data till Experience Platform.

The Datauppsättningar - översikt ger mer information om koncept, konfigurationer och andra funktioner för konsumtion.

WKND-sidvisningsdata i Experience Platform

Efter installationen av Web SDK med AEM, särskilt på WKND-webbplatsen, är det dags att generera trafik genom att navigera på webbplatssidorna. Bekräfta sedan att sidvisningsdata hämtas till datauppsättningen Experience Platform. I datauppsättningens användargränssnitt visas olika detaljer, t.ex. totala poster, storlek och inkapslade batchar, tillsammans med ett visuellt tilltalande stapeldiagram.

Sammanfattning

Snyggt jobb! Du har slutfört konfigurationen av AEM med Experience Platform Web SDK för att samla in och importera data från en webbplats. Med denna grund kan ni nu utforska fler möjligheter att förbättra och integrera produkter som Analytics, Target, Customer Journey Analytics (CJA) och många andra för att skapa innehållsrika, personaliserade upplevelser för era kunder. Fortsätt lära dig och utforska Adobe Experience Cloud fulla potential.

AVAILABILITY
Om du föredrar video från början till slut som täcker hela integrationsprocessen i stället för enskilda installationsstegsvideor kan du klicka på här för att komma åt den.

Ytterligare resurser

recommendation-more-help
bb44cebf-d964-4e3c-b64e-ce882243fe4d