[Integrering]{class="badge positive"}

Integrera AEM Sites och Adobe Analytics

Lär dig hur du integrerar AEM Sites och Adobe Analytics med Adobe Analytics-taggtillägg med hjälp av de inbyggda funktionerna i Adobe Client Data Layer med AEM Core Components för att samla in data om en sida i Adobe Experience Manager Sites. Taggar i Experience Platform och Adobe Analytics-tillägget används för att skapa regler för att skicka siddata till Adobe Analytics.

Vad du ska bygga what-build

Spårning av siddata

I den här självstudiekursen kommer du att utlösa en taggregel baserat på en händelse från Adobe-klientdatalagret. Lägg också till villkor för när regeln ska utlösas och skicka sedan värdena Sidnamn och Sidmall för en AEM till Adobe Analytics.

Mål objective

  1. Skapa en händelsestyrd regel i taggegenskapen som hämtar ändringar från datalagret
  2. Mappa egenskaper för siddatalager till dataelement i taggegenskapen
  3. Samla in och skicka siddata till Adobe Analytics med hjälp av sidvisningsknappen

Förutsättningar

Följande krävs:

  • Taggegenskap i Experience Platform
  • Adobe Analytics test-/dev-rapportsprogram-ID och spårningsserver. I följande dokumentation finns information om hur du skapar en rapportsvit.
  • Webbläsartillägget Experience Platform Debugger. Skärmbilder i den här självstudiekursen som tagits från Chrome webbläsare.
  • (Valfritt) AEM Plats med datalagret Adobe-klienten aktiverad. I den här självstudien används den offentliga WKND-webbplatsen, men du får använda din egen webbplats.
NOTE
Behöver du hjälp med att integrera taggegenskap och AEM? Se den här videoserien.

Byt taggmiljö för WKND-plats

WKND är en offentlig webbplats som byggts utifrån ett öppen källkodsprojekt som utformats som referens och självstudiekurs för en AEM implementering.

I stället för att konfigurera en AEM miljö och installera WKND-kodbasen kan du använda felsökningsfunktionen Experience Platform för att växla den aktiva WKND-platsen till taggegenskapen . Du kan dock använda en egen AEM om den redan har Adobe-klientdatalagret aktiverat.

  1. Logga in på Experience Platform och skapa en taggegenskap (om du inte redan gjort det).

  2. Kontrollera att en inledande tagg för JavaScript bibliotek har skapats och befordrats till taggen environment.

  3. Kopiera JavaScript inbäddningskod från den taggmiljö där ditt bibliotek har publicerats.

    Kopiera taggegenskap för inbäddning av kod

  4. Öppna en ny flik i webbläsaren och gå till WKND-platsen

  5. Öppna webbläsartillägget Experience Platform Debugger

    Felsökning för Experience Platform

  6. Navigera till Experience Platform-taggar > Konfiguration och under Inmatade inbäddningskoder ersätt den befintliga inbäddningskoden med din inbäddningskod som kopierats från steg 3.

    Ersätt inbäddad kod

  7. Aktivera Konsolloggning och Lås felsökningsprogrammet på fliken WKND.

    Konsolloggning

Verifiera Adobe klientdatalager på WKND-plats

WKND-referensprojektet har skapats med AEM kärnkomponenter och Adobe-klientdatalagretär aktiverat som standard. Kontrollera sedan att datalagret för klienten i Adobe är aktiverat.

  1. Navigera till WKND-plats.

  2. Öppna webbläsarens utvecklarverktyg och gå till konsolen. Kör följande kommando:

    code language-js
    adobeDataLayer.getState();
    

    Ovanför kod returnerar det aktuella läget för Adobe-klientdatalagret.

    Adobe datalagrets läge

  3. Expandera svaret och inspektera posten page. Du bör se ett dataschema som följande:

    code language-json
    page-2eee4f8914:
        @type: "wknd/components/page"
        dc:description: WKND is a collective of outdoors, music, crafts, adventure sports, and travel enthusiasts that want to share our experiences, connections, and expertise with the world.
        dc:title: "WKND Adventures and Travel"
        repo:modifyDate: "2020-08-31T21:02:21Z"
        repo:path: "/content/wknd/us/en.html"
        xdm:language: "en-US"
        xdm:tags: ["Attract"]
        xdm:template: "/conf/wknd/settings/wcm/templates/landing-page-template"
    

    Om du vill skicka siddata till Adobe Analytics använder vi standardegenskaperna dc:title, xdm:language och xdm:template för datalagret.

    Mer information finns i sidschemat från huvudkomponentens datamodeller.

    note note
    NOTE
    Om du inte ser JavaScript-objektet adobeDataLayer? Kontrollera att datalagret Adobe Client har aktiverats på din plats.

Skapa en inläst sidregel

Adobe-klientdatalagret är ett händelsestyrt datalager. När AEM siddatalager läses in utlöses en cmp:show-händelse. Skapa en regel som aktiveras när händelsen cmp:show utlöses från siddatalagret.

  1. Navigera till Experience Platform och till taggegenskapen som är integrerad med AEM.

  2. Navigera till avsnittet Regler i gränssnittet för taggegenskaper och klicka sedan på Skapa ny regel.

    Skapa regel

  3. Namnge regeln Sida inläst.

  4. Klicka på Lägg till i underavsnittet Händelser för att öppna guiden Händelsekonfiguration.

  5. För fältet Händelsetyp väljer du Egen kod.

    Namnge regeln och lägg till den anpassade kodhändelsen

  6. Klicka på Öppna redigeraren i huvudpanelen och ange följande kodfragment:

    code language-js
    var pageShownEventHandler = function(evt) {
       // defensive coding to avoid a null pointer exception
       if(evt.hasOwnProperty("eventInfo") && evt.eventInfo.hasOwnProperty("path")) {
          //trigger the Tag Rule and pass event
          console.log("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 Tag Rule, passing in the new `event` object
          // the `event` obj can now be referenced by the reserved name `event` by other Tag 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);
    });
    

    Ovanstående kodfragment lägger till en händelseavlyssnare genom att överföra en funktion till datalagret. När händelsen cmp:show aktiveras anropas funktionen pageShownEventHandler. I den här funktionen läggs några säkerhetskontroller till och en ny event skapas med det senaste -läget för datalagretför komponenten som utlöste händelsen.

    Slutligen anropas funktionen trigger(event). Funktionen trigger() är ett reserverat namn i taggegenskapen och den utlöser regeln. Objektet event skickas som en parameter som i sin tur visas med ett annat reserverat namn i taggegenskapen. Dataelement i taggegenskapen kan nu referera till olika egenskaper med kodfragment som event.component['someKey'].

  7. Spara ändringarna.

  8. Klicka på Lägg till under Åtgärder för att öppna guiden Åtgärdskonfiguration.

  9. Välj Anpassad kod för fältet Åtgärdstyp.

    Åtgärdstyp för anpassad kod

  10. Klicka på Öppna redigeraren i huvudpanelen och ange följande kodfragment:

    code language-js
    console.log("Page Loaded ");
    console.log("Page name: " + event.component['dc:title']);
    console.log("Page type: " + event.component['@type']);
    console.log("Page template: " + event.component['xdm:template']);
    

    Objektet event skickas från metoden trigger() som anropas i den anpassade händelsen. Här är component den aktuella sidan som härleds från datalagret getState i den anpassade händelsen.

  11. Spara ändringarna och kör en build i taggegenskapen för att befordra koden till den miljö som används på AEM.

    note note
    NOTE
    Det kan vara användbart att använda Adobe Experience Platform Debugger för att växla inbäddningskoden till en Development -miljö.
  12. Navigera till AEM webbplats och öppna utvecklarverktygen för att visa konsolen. Uppdatera sidan så ser du att konsolmeddelandena har loggats:

Sidinlästa konsolmeddelanden

Skapa dataelement

Skapa sedan flera dataelement för att hämta olika värden från datalagret för klienten i Adobe. Som du såg i föregående övning är det möjligt att komma åt egenskaperna för datalagret direkt via anpassad kod. Fördelen med att använda dataelement är att de kan återanvändas i alla taggregler.

Dataelement mappas till egenskaperna @type, dc:title och xdm:template.

Komponentresurstyp

  1. Navigera till Experience Platform och till taggegenskapen som är integrerad med AEM.

  2. Navigera till avsnittet Dataelement och klicka på Skapa nytt dataelement.

  3. Ange komponentresurstypen för fältet Namn.

  4. Välj Anpassad kod för fältet Dataelementtyp.

    Komponentresurstyp

  5. Klicka på knappen Öppna redigeraren och ange följande i den anpassade kodredigeraren:

    code language-js
    if(event && event.component && event.component.hasOwnProperty('@type')) {
        return event.component['@type'];
    }
    
  6. Spara ändringarna.

    note note
    NOTE
    Kom ihåg att objektet event görs tillgängligt och omfång baserat på händelsen som utlöste egenskapen Rule i tagg. Värdet för ett dataelement anges inte förrän dataelementet är refererat i en regel. Det är därför säkert att använda det här dataelementet i en regel som Sidinläsning som skapades i föregående steg , men skulle inte vara säker att använda i andra sammanhang.

Sidnamn

  1. Klicka på knappen Lägg till dataelement

  2. Ange Sidnamn för fältet Namn.

  3. Välj Anpassad kod för fältet Dataelementtyp.

  4. Klicka på knappen Öppna redigeraren och ange följande i den anpassade kodredigeraren:

    code language-js
    if(event && event.component && event.component.hasOwnProperty('dc:title')) {
        return event.component['dc:title'];
    }
    
  5. Spara ändringarna.

Sidmall

  1. Klicka på knappen Lägg till dataelement

  2. Ange Sidmall för fältet Namn.

  3. Välj Anpassad kod för fältet Dataelementtyp.

  4. Klicka på knappen Öppna redigeraren och ange följande i den anpassade kodredigeraren:

    code language-js
    if(event && event.component && event.component.hasOwnProperty('xdm:template')) {
        return event.component['xdm:template'];
    }
    
  5. Spara ändringarna.

  6. Du bör nu ha tre dataelement som en del av din regel:

    Dataelement i regel

Lägg till analystillägget

Lägg sedan till Analytics-tillägget i taggegenskapen för att skicka data till en rapportserie.

  1. Navigera till Experience Platform och till taggegenskapen som är integrerad med AEM.

  2. Gå till Tillägg > Katalog

  3. Leta reda på tillägget Adobe Analytics och klicka på Installera

    Adobe Analytics-tillägg

  4. Under Bibliotekshantering > Rapportsviter anger du de ID:n för rapportsviten som du vill använda för varje taggmiljö.

    Ange ID:n för rapportsviten

    note note
    NOTE
    Det går bra att använda en rapportserie för alla miljöer i den här självstudiekursen, men i verkligheten vill du använda separata rapportsviter, som bilden nedan visar
    note tip
    TIP
    Vi rekommenderar att du använder alternativet Hantera biblioteket åt mig som inställning för bibliotekshantering eftersom det gör det mycket enklare att hålla AppMeasurement.js-biblioteket uppdaterat.
  5. Markera kryssrutan för att aktivera Använd Activity Map.

    Aktivera Använd Activity Map

  6. Under Allmänt > Spårningsserver anger du spårningsservern, till exempel tmd.sc.omtrdc.net. Ange din SSL-spårningsserver om din webbplats stöder https://

    Ange spårningsservrarna

  7. Klicka på Spara för att spara ändringarna.

Lägga till ett villkor i regeln Sidinläst

Uppdatera sedan regeln Sida inläst så att dataelementet Komponentresurstyp används, så att regeln bara aktiveras när händelsen cmp:show gäller för sidan. Andra komponenter kan utlösa händelsen cmp:show, till exempel utlöses den av komponenten Carousel när bildrutorna ändras. Därför är det viktigt att lägga till ett villkor för den här regeln.

  1. Navigera till regeln Sidinläsning som skapades tidigare i gränssnittet för taggegenskaper.

  2. Under Villkor klickar du på Lägg till för att öppna guiden Konfiguration av villkor.

  3. Välj alternativet Värdejämförelse för fältet Villkorstyp.

  4. Ange det första värdet i formulärfältet till %Component Resource Type%. Du kan använda dataelementikonen data-element-ikon för att välja dataelementet Component Resource Type . Låt jämförelseobjektet vara Equals.

  5. Ange det andra värdet som wknd/components/page.

    Villkorskonfiguration för regel för inläst sida

    note note
    NOTE
    Det går att lägga till det här villkoret i den anpassade kodfunktionen som avlyssnar händelsen cmp:show som skapades tidigare i självstudien. Om du lägger till den i användargränssnittet blir den synligare för ytterligare användare som kan behöva göra ändringar i regeln. Dessutom kan vi använda vårt dataelement!
  6. Spara ändringarna.

Ange analysvariabler och aktivera sidvisningsfunktionen

Regeln Sidinläsning visar för närvarande bara en konsolsats. Använd sedan dataelementen och Analytics-tillägget för att ange Analytics-variabler som en åtgärd i regeln Inläst sida. Vi har också ställt in en extra åtgärd för att utlösa sidvisningsBeacon och skicka insamlade data till Adobe Analytics.

  1. Ta bort åtgärden Core - Custom Code (konsolprogramsatserna) i regeln för sidinläsning: Ta bort: Core - Custom Code:

    Ta bort anpassad kodåtgärd

  2. Klicka på Lägg till under åtgärdsunderavsnittet för att lägga till en ny åtgärd.

  3. Ange typen Tillägg till Adobe Analytics och ställ in Åtgärdstyp till Ange variabler

    Ange åtgärdstillägg för analysuppsättningsvariabler

  4. Markera en tillgänglig eVar på huvudpanelen och ange som värde för dataelementets sidmall. Använd ikonen Dataelement för att välja elementet Sidmall.

    Ange som sidmall för eVar

  5. Bläddra nedåt, under Ytterligare inställningar ange Sidnamn till dataelementet Sidnamn:

    Variabeluppsättning för sidnamnsmiljö

  6. Spara ändringarna.

  7. Lägg sedan till en extra åtgärd till höger om Adobe Analytics - Ange variabler genom att trycka på ikonen plus :

    Lägg till ytterligare en taggregelåtgärd

  8. Ange typen Tillägg till Adobe Analytics och ställ in åtgärdstypen till Skicka Beacon. Eftersom den här åtgärden betraktas som en sidvy låter du standardspårningsinställningen vara s.t().

    Åtgärden Skicka Beacon Adobe Analytics

  9. Spara ändringarna. Regeln Sidinläsning bör nu ha följande konfiguration:

    Konfiguration av slutlig taggregel

    • 1. Lyssna efter händelsen cmp:show.
    • 2. Kontrollera att händelsen utlöstes av en sida.
    • 3. Ange analysvariabler för Sidnamn och Sidmall
    • 4. Skicka analyssidans vy
  10. Spara alla ändringar och bygg ditt taggbibliotek och marknadsför till rätt miljö.

Validera sidvyns beacon- och analysanrop

Nu när regeln Sidinläsning skickar analysfyren bör du kunna se analysspårningsvariablerna med hjälp av Experience Platform-felsökaren.

  1. Öppna WKND-platsen i webbläsaren.

  2. Klicka på felsökningsikonen Experience platform Debugger icon för att öppna Experience Platform Debugger.

  3. Kontrollera att felsökaren mappar taggegenskapen till din-utvecklingsmiljö, enligt beskrivningen ovan, och att Konsolloggning är markerad.

  4. Öppna Analytics-menyn och kontrollera att rapportsviten är inställd på din-rapportsvit. Sidnamnet ska också fyllas i:

    Flikfelsökning för analys

  5. Bläddra nedåt och expandera Nätverksförfrågningar. Du bör kunna hitta uppsättningen evar för sidmallen:

    Evar- och Page Name-uppsättning

  6. Gå tillbaka till webbläsaren och öppna utvecklarkonsolen. Klicka igenom Carousel överst på sidan.

    Klicka igenom karusellsidan

  7. Observera följande i webbläsarkonsolen:

    Villkoret är inte uppfyllt

    Detta beror på att Carousel utlöser en cmp:show-händelse , men på grund av vår kontroll av komponentresurstypen utlöses ingen händelse.

    note note
    NOTE
    Om du inte ser några konsolloggar kontrollerar du att Konsolloggning finns under Experience Platform-taggar i Felsökning för Experience Platform.
  8. Navigera till en artikelsida som Western Australia. Lägg märke till att sidnamnet och malltypen ändras.

Grattis!

Du har precis använt det händelsestyrda Adobe-klientdatalagret och -taggarna i Experience Platform för att samla in data från en AEM webbplats och skicka dem till Adobe Analytics.

Nästa steg

Titta på följande självstudiekurs för att lära dig hur du använder det händelsestyrda Adobe-klientdatalagret för att spåra klickningar på specifika komponenter på en Adobe Experience Manager-webbplats.

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