[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.

wat u spoor zult bouwen klikt

Doelstellingen objective

  1. Maak een gebeurtenisgestuurde regel in de eigenschap tag die de gebeurtenis cmp:click vastlegt.
  2. Filter de verschillende gebeurtenissen op componentenmiddeltype.
  3. 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:

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.

  1. Navigeer aan WKND Homepage

  2. 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.

    de staat van de Laag van Gegevens via browser console

  3. Vouw de reactie uit en zoek de items die vooraf aan de items button- en teaser-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.

  1. Navigeer naar Experience Platform en naar de tageigenschap die is geïntegreerd met de AEM-site.

  2. Navigeer aan de sectie van Regels in het Bezit UI van de Markering, dan klik voegt Regel toe.

  3. Noem de regel CTA klikte.

  4. Klik Gebeurtenissen > toevoegen om de tovenaar van de Configuratie van de Gebeurtenis te openen.

  5. Voor het Type van Gebeurtenis gebied, uitgezochte Code van de Douane.

    Naam de regel CTA klikte en voeg de gebeurtenis van de douanecode toe

  6. 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 functie componentClickedHandler aangeroepen. In deze functie, worden een paar gezondheidscontroles toegevoegd en een nieuw event voorwerp wordt geconstrueerd met de recentste staat van de gegevenslaagvoor de component die de gebeurtenis teweegbracht.

    Tot slot wordt de functie trigger(event) aangeroepen. De trigger() functie is een gereserveerde naam in het markeringsbezit en het brengt de regel teweeg. Het event -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, zoals event.component['someKey'] .

  7. Sla de wijzigingen op.

  8. Daarna onder Acties klik ​toevoegen om de tovenaar van de Configuratie van de Actie te openen.

  9. Voor gebied van het Type van Actie 0} {, kies de Code van de Douane .

    Type van de Actie van de Code van de Douane

  10. 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 methode trigger() die in de aangepaste gebeurtenis wordt aangeroepen. Het component -object is de huidige status van de component die is afgeleid van de methode data layer getState() en is het element dat de klik heeft geactiveerd.

  11. 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.
  12. Navigeer aan de Plaats WKNDen open de ontwikkelaarshulpmiddelen om de console te bekijken. Ook, selecteer het Logboek van het Behoud checkbox.

  13. Klik één van Taser of Knoop de knopen van CTA om aan een andere pagina te navigeren.

    Knoop van CTA om te klikken

  14. Neem in de ontwikkelaarsconsole waar dat CTA klikte regel is in brand gestoken:

    de Knoop van CTA klikte

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

  1. Navigeer naar Experience Platform en naar de tageigenschap die is geïntegreerd met de AEM-site.

  2. Navigeer aan de sectie van de Elementen van Gegevens 0} {en klik toevoegen Nieuw Element van Gegevens .

  3. Voor het gebied van de Naam, ga identiteitskaart van de Component in.

  4. Voor het Type van Element van Gegevens gebied, uitgezochte Code van de Douane.

    Vorm van het Element van Gegevens van identiteitskaart van de Component

  5. 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];
    }
    
  6. 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

  1. Navigeer aan de sectie van de Elementen van Gegevens 0} {en klik toevoegen Nieuw Element van Gegevens .

  2. Voor het gebied van de Naam, ga Titel van de Component in.

  3. Voor het Type van Element van Gegevens gebied, uitgezochte Code van de Douane.

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

  1. In het Bezit van de Markering UI, navigeer aan CTA klikte regel vroeger gecreeerd.

  2. Onder Voorwaarden klik ​toevoegen om de tovenaar van de Configuratie van de Voorwaarde te openen.

  3. Voor gebied van het Type van Voorwaarde 0} {, uitgezochte Code van de Douane .

    CTA klikte Code van de Douane van de Voorwaarde

  4. 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.

  5. Sla de wijzigingen op.

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.

  1. In CTA klikte regel, verwijdert de Kern - de actie van de Code van de Douane (de consoleverklaringen):

    verwijder de actie van de douanecode

  2. Onder Acties, voegt de klik ​toe om een actie tot stand te brengen.

  3. Plaats het type van Uitbreiding aan Adobe Analytics en plaats het Type van Actie aan Vastgestelde Variabelen.

  4. Plaats de volgende waarden voor eVars, Props, en Gebeurtenissen:

    • evar8 - %Component ID%
    • prop8 - %Component ID%
    • event8

    plaats eVar Prop en gebeurtenissen

    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 zoals button-2e6d32893a . Als u %Component Title% gebruikt, krijgt u een mensvriendelijkere naam, maar de waarde is mogelijk niet uniek.
  5. Daarna, voeg een extra Actie rechts van Adobe Analytics toe - plaats Variabelen door het plus pictogram te tikken:

    voeg een Extra Actie aan de Regel van de Markering toe

  6. Plaats het type van de Uitbreiding 0} {aan Adobe Analytics en plaats het Type van Actie aan verzendt Baken .

  7. Onder Volgend plaatsen het radioknoop aan s.tl().

  8. Voor het Type van Verbinding gebied, kies Douane Verbinding en voor de Naam van de Verbinding plaatsen de waarde aan: %Component Title%: CTA Clicked

    Configuratie voor Send het baken van de Verbinding

    Bovenstaande config combineert de dynamische variabele van de Titel van de Component van het gegevenselement ​en het statische koord CTA klikte.

  9. Sla de wijzigingen op. De CTA klikte regel zou nu de volgende configuratie moeten hebben:

    Definitieve Configuratie van de Regel van de Markering

    • 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).
  10. 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.

  1. Open de Plaats WKNDin uw browser.

  2. Klik het Debugger pictogram het platform Debugger van de Ervaring pictogram om Debugger van Experience Platform te openen.

  3. 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.

  4. Open het menu van Analytics en verifieer dat de rapportreeks aan uw rapportreeks wordt geplaatst.

    het tabdebugger van de Analyse

  5. In browser, klik één van Taser of Knoop van de Knoop CTA om aan een andere pagina te navigeren.

    Knoop van CTA om te klikken

  6. 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 worden gevolgd

  7. Ga terug naar de browser en open de ontwikkelaarsconsole. Navigeer naar de voettekst van de site en klik op een van de navigatiekoppelingen:

    klik de verbinding van de Navigatie in footer

  8. 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.

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