[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
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
- Skapa en händelsestyrd regel i taggegenskapen som hämtar ändringar från datalagret
- Mappa egenskaper för siddatalager till dataelement i taggegenskapen
- 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.
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.
-
Logga in på Experience Platform och skapa en taggegenskap (om du inte redan gjort det).
-
Kontrollera att en inledande tagg för JavaScript bibliotek har skapats och befordrats till taggen environment.
-
Kopiera JavaScript inbäddningskod från den taggmiljö där ditt bibliotek har publicerats.
-
Öppna en ny flik i webbläsaren och gå till WKND-platsen
-
Öppna webbläsartillägget Experience Platform Debugger
-
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.
-
Aktivera Konsolloggning och Lås felsökningsprogrammet på fliken WKND.
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.
-
Navigera till WKND-plats.
-
Ö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.
-
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
ochxdm: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.
-
Navigera till Experience Platform och till taggegenskapen som är integrerad med AEM.
-
Navigera till avsnittet Regler i gränssnittet för taggegenskaper och klicka sedan på Skapa ny regel.
-
Namnge regeln Sida inläst.
-
Klicka på Lägg till i underavsnittet Händelser för att öppna guiden Händelsekonfiguration.
-
För fältet Händelsetyp väljer du Egen kod.
-
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 funktionenpageShownEventHandler
. I den här funktionen läggs några säkerhetskontroller till och en nyevent
skapas med det senaste -läget för datalagretför komponenten som utlöste händelsen.Slutligen anropas funktionen
trigger(event)
. Funktionentrigger()
är ett reserverat namn i taggegenskapen och den utlöser regeln. Objektetevent
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 somevent.component['someKey']
. -
Spara ändringarna.
-
Klicka på Lägg till under Åtgärder för att öppna guiden Åtgärdskonfiguration.
-
Välj Anpassad kod för fältet Åtgärdstyp.
-
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 metodentrigger()
som anropas i den anpassade händelsen. Här ärcomponent
den aktuella sidan som härleds från datalagretgetState
i den anpassade händelsen. -
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ö. -
Navigera till AEM webbplats och öppna utvecklarverktygen för att visa konsolen. Uppdatera sidan så ser du att konsolmeddelandena har loggats:
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
-
Navigera till Experience Platform och till taggegenskapen som är integrerad med AEM.
-
Navigera till avsnittet Dataelement och klicka på Skapa nytt dataelement.
-
Ange komponentresurstypen för fältet Namn.
-
Välj Anpassad kod för fältet Dataelementtyp.
-
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']; }
-
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
-
Klicka på knappen Lägg till dataelement
-
Ange Sidnamn för fältet Namn.
-
Välj Anpassad kod för fältet Dataelementtyp.
-
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']; }
-
Spara ändringarna.
Sidmall
-
Klicka på knappen Lägg till dataelement
-
Ange Sidmall för fältet Namn.
-
Välj Anpassad kod för fältet Dataelementtyp.
-
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']; }
-
Spara ändringarna.
-
Du bör nu ha tre dataelement som en del av din regel:
Lägg till analystillägget
Lägg sedan till Analytics-tillägget i taggegenskapen för att skicka data till en rapportserie.
-
Navigera till Experience Platform och till taggegenskapen som är integrerad med AEM.
-
Gå till Tillägg > Katalog
-
Leta reda på tillägget Adobe Analytics och klicka på Installera
-
Under Bibliotekshantering > Rapportsviter anger du de ID:n för rapportsviten som du vill använda för varje taggmiljö.
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. -
Markera kryssrutan för att aktivera Använd Activity Map.
-
Under Allmänt > Spårningsserver anger du spårningsservern, till exempel
tmd.sc.omtrdc.net
. Ange din SSL-spårningsserver om din webbplats stöderhttps://
-
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.
-
Navigera till regeln Sidinläsning som skapades tidigare i gränssnittet för taggegenskaper.
-
Under Villkor klickar du på Lägg till för att öppna guiden Konfiguration av villkor.
-
Välj alternativet Värdejämförelse för fältet Villkorstyp.
-
Ange det första värdet i formulärfältet till
%Component Resource Type%
. Du kan använda dataelementikonen för att välja dataelementet Component Resource Type . Låt jämförelseobjektet varaEquals
. -
Ange det andra värdet som
wknd/components/page
.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! -
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.
-
Ta bort åtgärden Core - Custom Code (konsolprogramsatserna) i regeln för sidinläsning: Ta bort: Core - Custom Code:
-
Klicka på Lägg till under åtgärdsunderavsnittet för att lägga till en ny åtgärd.
-
Ange typen Tillägg till Adobe Analytics och ställ in Åtgärdstyp till Ange variabler
-
Markera en tillgänglig eVar på huvudpanelen och ange som värde för dataelementets sidmall. Använd ikonen för att välja elementet Sidmall.
-
Bläddra nedåt, under Ytterligare inställningar ange Sidnamn till dataelementet Sidnamn:
-
Spara ändringarna.
-
Lägg sedan till en extra åtgärd till höger om Adobe Analytics - Ange variabler genom att trycka på ikonen plus :
-
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()
. -
Spara ändringarna. Regeln Sidinläsning bör nu ha följande konfiguration:
- 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
- 1. Lyssna efter händelsen
-
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.
-
Öppna WKND-platsen i webbläsaren.
-
Klicka på felsökningsikonen för att öppna Experience Platform Debugger.
-
Kontrollera att felsökaren mappar taggegenskapen till din-utvecklingsmiljö, enligt beskrivningen ovan, och att Konsolloggning är markerad.
-
Öppna Analytics-menyn och kontrollera att rapportsviten är inställd på din-rapportsvit. Sidnamnet ska också fyllas i:
-
Bläddra nedåt och expandera Nätverksförfrågningar. Du bör kunna hitta uppsättningen evar för sidmallen:
-
Gå tillbaka till webbläsaren och öppna utvecklarkonsolen. Klicka igenom Carousel överst på sidan.
-
Observera följande i webbläsarkonsolen:
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. -
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.