[Integratie]{class="badge positive"}
Aangeklikte component bijhouden met Adobe Analytics
Gebruik de gebeurtenis-gedreven Laag van de Gegevens van de Cliënt van Adobe met de Componenten van de Kern van AEMom kliks van specifieke componenten op een plaats van Adobe Experience Manager te volgen. Leer hoe u regels in de eigenschap tag gebruikt om te luisteren naar klikgebeurtenissen, deze te filteren op component en de gegevens te verzenden naar een Adobe Analytics met een spoorkoppelingsbaken.
Wat u gaat bouwen what-build
Het WKND-marketingteam is geïnteresseerd in de vraag welke Call to Action (CTA)
-knoppen het beste op de startpagina uitvoeren. In dit leerprogramma, laten wij een regel aan het markeringsbezit toevoegen dat op de cmp:click
gebeurtenissen van Taser en Knoop componenten luistert. Vervolgens verzendt u de component-id en een nieuwe gebeurtenis naar Adobe Analytics naast het trackkoppelingsbaken.
Doelstellingen objective
- Maak een gebeurtenisgestuurde regel in de eigenschap tag die de gebeurtenis
cmp:click
vastlegt. - Filter de verschillende gebeurtenissen op componentenmiddeltype.
- Stel de component-id in en verzend een gebeurtenis naar Adobe Analytics met het trackkoppelingsbaken.
Vereisten
Dit leerprogramma is een voortzetting van verzamel paginagegevens met Adobe Analyticsen veronderstelt dat u hebt:
- A bezit van de Markering met de toegelaten uitbreiding van Adobe Analytics
- Adobe Analytics test/dev- rapportreeks identiteitskaart en volgende server. Zie de volgende documentatie voor het creëren van een rapportreeks.
- Debugger van Experience Platformbrowser uitbreiding die met uw markeringsbezit wordt gevormd op de wordt geladen plaats WKNDof een plaats van AEM met de toegelaten Laag van Gegevens van Adobe.
Het knop- en teasschema controleren
Alvorens regels in het markeringsbezit tot stand te brengen, is het nuttig om het schema voor de Knoop en het Taserte herzien en hen in de implementatie van de gegevenslaag te inspecteren.
-
Navigeer aan WKND Homepage
-
Open de de ontwikkelaarshulpmiddelen van browser en navigeer aan de Console. Voer de volgende opdracht uit:
code language-js adobeDataLayer.getState();
Met de bovenstaande code wordt de huidige status van de Adobe Client Data Layer geretourneerd.
-
Vouw de reactie uit en zoek de items die vooraf aan de items
button-
enteaser-xyz-cta
zijn toegewezen. U zou een gegevensschema als het volgende moeten zien:Knopschema:
code language-json button-2e6d32893a: @type: "wknd/components/button" dc:title: "View All" parentId: "page-2eee4f8914" repo:modifyDate: "2020-07-11T22:17:55Z" xdm:linkURL: "/content/wknd/us/en/magazine.html"
Teaserschema:
code language-json teaser-da32481ec8-cta-adf3c09db9: @type: "wknd/components/teaser/cta" dc:title: "Surf's Up" parentId: "teaser-da32481ec8" xdm:linkURL: "/content/wknd/us/en/magazine/san-diego-surf.html"
Boven gegevensdetails zijn gebaseerd op het Schema van het Punt van de Component/van de Container. De nieuwe tagregel gebruikt dit schema.
Een op CTA geklikte regel maken
De Laag van Gegevens van de Cliënt van Adobe is een gebeurtenis gedreven gegevenslaag. Wanneer op een Core-component wordt geklikt, wordt een cmp:click
-gebeurtenis verzonden via de gegevenslaag. Laten we een regel maken om naar de gebeurtenis cmp:click
te luisteren.
-
Navigeer naar Experience Platform en naar de tageigenschap die is geïntegreerd met de AEM-site.
-
Navigeer aan de sectie van Regels in het Bezit UI van de Markering, dan klik voegt Regel toe.
-
Noem de regel CTA klikte.
-
Klik Gebeurtenissen > toevoegen om de tovenaar van de Configuratie van de Gebeurtenis te openen.
-
Voor het Type van Gebeurtenis gebied, uitgezochte Code van de Douane.
-
Klik Open Redacteur in het belangrijkste paneel en ga het volgende codefragment in:
code language-js var componentClickedHandler = function(evt) { // defensive coding to avoid a null pointer exception if(evt.hasOwnProperty("eventInfo") && evt.eventInfo.hasOwnProperty("path")) { //trigger Tag Rule and pass event console.debug("cmp:click 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 Property 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:click into the data layer window.adobeDataLayer.push(function (dl) { //add event listener for `cmp:click` and callback to the `componentClickedHandler` function dl.addEventListener("cmp:click", componentClickedHandler); });
Het bovenstaande codefragment voegt een gebeurtenisluisteraar toe door een functiein de gegevenslaag te duwen. Wanneer de gebeurtenis
cmp:click
wordt geactiveerd, wordt de functiecomponentClickedHandler
aangeroepen. In deze functie, worden een paar gezondheidscontroles toegevoegd en een nieuwevent
voorwerp wordt geconstrueerd met de recentste staat van de gegevenslaagvoor de component die de gebeurtenis teweegbracht.Tot slot wordt de functie
trigger(event)
aangeroepen. Detrigger()
functie is een gereserveerde naam in het markeringsbezit en het brengt de regel teweeg. Hetevent
-object wordt doorgegeven als een parameter die vervolgens weer wordt weergegeven door een andere gereserveerde naam in de eigenschap tag. Gegevenselementen in de eigenschap tag kunnen nu verwijzen naar verschillende eigenschappen met behulp van een codefragment, zoalsevent.component['someKey']
. -
Sla de wijzigingen op.
-
Daarna onder Acties klik toevoegen om de tovenaar van de Configuratie van de Actie te openen.
-
Voor gebied van het Type van Actie 0} {, kies de Code van de Douane .
-
Klik Open Redacteur in het belangrijkste paneel en ga het volgende codefragment in:
code language-js console.debug("Component Clicked"); console.debug("Component Path: " + event.path); console.debug("Component type: " + event.component['@type']); console.debug("Component text: " + event.component['dc:title']);
Het object
event
wordt doorgegeven via de methodetrigger()
die in de aangepaste gebeurtenis wordt aangeroepen. Hetcomponent
-object is de huidige status van de component die is afgeleid van de methode data layergetState()
en is het element dat de klik heeft geactiveerd. -
Sparen de veranderingen en stel a in werking bouwtin het markeringsbezit om de code aan het milieute bevorderen dat op uw Plaats van AEM wordt gebruikt.
note note NOTE Het kan nuttig zijn om Adobe Experience Platform Debuggerte gebruiken om de ingebedde code aan het milieu van de a Ontwikkeling te schakelen. -
Navigeer aan de Plaats WKNDen open de ontwikkelaarshulpmiddelen om de console te bekijken. Ook, selecteer het Logboek van het Behoud checkbox.
-
Klik één van Taser of Knoop de knopen van CTA om aan een andere pagina te navigeren.
-
Neem in de ontwikkelaarsconsole waar dat CTA klikte regel is in brand gestoken:
Gegevenselementen maken
Maak vervolgens gegevenselementen om de component-id en de titel vast te leggen waarop is geklikt. Tijdens de vorige exercitie was de uitvoer van event.path
ongeveer gelijk aan component.button-b6562c963d
en de waarde van event.component['dc:title']
was ongeveer als "Trips weergeven".
Component-id
-
Navigeer naar Experience Platform en naar de tageigenschap die is geïntegreerd met de AEM-site.
-
Navigeer aan de sectie van de Elementen van Gegevens 0} {en klik toevoegen Nieuw Element van Gegevens .
-
Voor het gebied van de Naam, ga identiteitskaart van de Component in.
-
Voor het Type van Element van Gegevens gebied, uitgezochte Code van de Douane.
-
Klik Open de knoop van de Redacteur en ga het volgende in de redacteur van de douanecode in:
code language-js if(event && event.path && event.path.includes('.')) { // split on the `.` to return just the component ID return event.path.split('.')[1]; }
-
Sla de wijzigingen op.
note note NOTE Rappel dat het event
voorwerp beschikbaar wordt gemaakt en scoped gebaseerd op de gebeurtenis die de Regel in markeringsbezit teweegbracht. De waarde van een Element van Gegevens wordt niet geplaatst tot het Element van Gegevens binnen een Regel van verwijzingen wordt voorzien. Daarom is het veilig om dit Element van Gegevens binnen een Regel als de Geladen Pagina** regel te gebruiken die in de vorige stap wordt gecreeerd maar zou niet veilig zijn om in andere contexten te gebruiken.
Componenttitel
-
Navigeer aan de sectie van de Elementen van Gegevens 0} {en klik toevoegen Nieuw Element van Gegevens .
-
Voor het gebied van de Naam, ga Titel van de Component in.
-
Voor het Type van Element van Gegevens gebied, uitgezochte Code van de Douane.
-
Klik Open de knoop van de Redacteur en ga het volgende in de redacteur van de douanecode in:
code language-js if(event && event.component && event.component.hasOwnProperty('dc:title')) { return event.component['dc:title']; }
-
Sla de wijzigingen op.
Een voorwaarde toevoegen aan de op CTA geklikte regel
Daarna, werk de CTA geklikte regel bij om ervoor te zorgen dat de regel slechts in brand steekt wanneer de cmp:click
gebeurtenis voor a Taser of a Knoop in brand wordt gestoken. Aangezien de CTA van de Teaser als een afzonderlijk voorwerp in de gegevenslaag wordt beschouwd, is het belangrijk om de ouder te controleren om te verifiëren het uit een Teaser kwam.
-
In het Bezit van de Markering UI, navigeer aan CTA klikte regel vroeger gecreeerd.
-
Onder Voorwaarden klik toevoegen om de tovenaar van de Configuratie van de Voorwaarde te openen.
-
Voor gebied van het Type van Voorwaarde 0} {, uitgezochte Code van de Douane .
-
Klik Open Redacteur en ga het volgende in de redacteur van de douanecode in:
code language-js if(event && event.component && event.component.hasOwnProperty('@type')) { // console.log("Event Type: " + event.component['@type']); //Check for Button Type OR Teaser CTA type if(event.component['@type'] === 'wknd/components/button' || event.component['@type'] === 'wknd/components/teaser/cta') { return true; } } // none of the conditions are met, return false return false;
De bovenstaande code controleert eerst om te zien of was het middeltype van a Knoop of als het middeltype van CTA binnen a Taser was.
-
Sla de wijzigingen op.
Analysevariabelen instellen en Track Link Beacon activeren
Momenteel klikt de CTA regel eenvoudig output een consoleverklaring. Daarna, gebruik de gegevenselementen en de uitbreiding van de Analyse om de variabelen van de Analyse als actie te plaatsen. Laten wij ook een extra actie plaatsen om de Verbinding van het Spoor teweeg te brengen en de verzamelde gegevens naar Adobe Analytics te verzenden.
-
In CTA klikte regel, verwijdert de Kern - de actie van de Code van de Douane (de consoleverklaringen):
-
Onder Acties, voegt de klik toe om een actie tot stand te brengen.
-
Plaats het type van Uitbreiding aan Adobe Analytics en plaats het Type van Actie aan Vastgestelde Variabelen.
-
Plaats de volgende waarden voor eVars, Props, en Gebeurtenissen:
evar8
-%Component ID%
prop8
-%Component ID%
event8
note note NOTE Hier wordt %Component ID%
gebruikt omdat het een unieke id garandeert voor de CTA waarop is geklikt. Een mogelijk nadeel van het gebruik van%Component ID%
is dat het rapport Analytics waarden bevat zoalsbutton-2e6d32893a
. Als u%Component Title%
gebruikt, krijgt u een mensvriendelijkere naam, maar de waarde is mogelijk niet uniek. -
Daarna, voeg een extra Actie rechts van Adobe Analytics toe - plaats Variabelen door het plus pictogram te tikken:
-
Plaats het type van de Uitbreiding 0} {aan Adobe Analytics en plaats het Type van Actie aan verzendt Baken .
-
Onder Volgend plaatsen het radioknoop aan
s.tl()
. -
Voor het Type van Verbinding gebied, kies Douane Verbinding en voor de Naam van de Verbinding plaatsen de waarde aan:
%Component Title%: CTA Clicked
Bovenstaande config combineert de dynamische variabele van de Titel van de Component van het gegevenselement en het statische koord CTA klikte.
-
Sla de wijzigingen op. De CTA klikte regel zou nu de volgende configuratie moeten hebben:
- 1. Luister naar de
cmp:click
-gebeurtenis. - 2. Controle dat de gebeurtenis door a Knoop of Taser werd teweeggebracht.
- 3. Vastgestelde variabelen van de Analyse om identiteitskaart van de Component als eVar, pro, en een gebeurtenis te volgen.
- 4. verzend het Baken van de Verbinding van het Spoor van Analytics (en niet behandelt het als paginamening).
- 1. Luister naar de
-
Sla alle wijzigingen op en maak uw tagbibliotheek, waarbij u een upgrade uitvoert naar de juiste omgeving.
Valideer de vraag van het Beacon en van de Analyse van de Verbinding van het Spoor
Nu de CTA klikte regel het baken van Analytics verzendt, zou u de het volgen variabelen van Analytics moeten kunnen zien gebruikend Debugger van Experience Platform.
-
Open de Plaats WKNDin uw browser.
-
Klik het Debugger pictogram
-
Zorg ervoor dat Debugger het markeringsbezit aan in kaart brengt uw milieu van de Ontwikkeling, zoals vroeger beschreven en het Loggen van de Console wordt gecontroleerd.
-
Open het menu van Analytics en verifieer dat de rapportreeks aan uw rapportreeks wordt geplaatst.
-
In browser, klik één van Taser of Knoop van de Knoop CTA om aan een andere pagina te navigeren.
-
Terugkeer aan de Debugger van Experience Platform en rol neer en breid Verzoeken van het Netwerk > Uw Reeks van het Rapport uit. U zou eVar, prop, en gebeurtenis moeten kunnen vinden reeks.
{de gebeurtenissen van 0} Analytics, evar, en prop die op klik
-
Ga terug naar de browser en open de ontwikkelaarsconsole. Navigeer naar de voettekst van de site en klik op een van de navigatiekoppelingen:
-
Neem in de browser console het bericht "Douane Code"voor regel "CTA Clicked"niet werd ontmoet waar.
Het bovenstaande bericht is omdat de component van de Navigatie a
cmp:click
gebeurtenis teweegbrengt maar wegens Voorwaarde aan de regeldie het middeltype controleert geen actie wordt genomen.note note NOTE Als u geen consolelogboeken ziet, zorg ervoor dat het Registreren van de Console onder Tags van Experience Platform in Debugger van Experience Platform wordt gecontroleerd.
Gefeliciteerd!
U hebt zojuist de gebeurtenisgestuurde Adobe Client Data Layer en -tag in Experience Platform gebruikt om de klikgebeurtenissen van specifieke componenten op een AEM-site bij te houden.