[Integratie]{class="badge positive"}

Aangeklikte component bijhouden met Adobe Analytics

Gebruik de gebeurtenis-gedreven Laag van de Gegevens van de Cliënt van de Adobe met AEM Componenten van de Kernom 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:

Inspect the Button and Teaser schema

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();
    

    Boven code keert de huidige staat van de Gegevens van de Cliënt van de Adobe Laag terug.

    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.

Creeer een CTA klikte regel

De Laag van Gegevens van de Cliënt van de 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 het Experience Platform en naar de eigenschap tag 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 regelCTA 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 AEMPlaats wordt gebruikt.

    note note
    NOTE
    Het kan nuttig zijn om het 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 CTA knopen om aan een andere pagina te navigeren.

    Knoop CTA te klikken

  14. Merk in de ontwikkelaarsconsole op dat de CTA geklikte regel in brand is gestoken:

    CTA Geklikte Knoop

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 het Experience Platform en naar de eigenschap tag 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.

Voeg een voorwaarde aan de CTA geklikte regel toe

Daarna, werk CTA geklikte regel bij om ervoor te zorgen dat de regel slechts brandt wanneer de cmp:click gebeurtenis voor a Taser of a Knoop in brand wordt gestoken. Aangezien Taser's CTA als een afzonderlijk object in de gegevenslaag wordt beschouwd, is het belangrijk dat u het bovenliggende element controleert om te controleren of het van een Taser afkomstig is.

  1. In het Bezit van de Markering UI, navigeer aan CTA geklikte 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 een CTA binnen a Taser was.

  5. Sla de wijzigingen op.

Momenteel voert de CTA geklikte regel eenvoudig een consoleverklaring uit. 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 eVarProp en gebeurtenissen

    note note
    NOTE
    Hier wordt %Component ID% gebruikt omdat het een unieke herkenningsteken voor CTA waarborgt die werd 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 geklikte 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 CTA klikte regel verzendt het baken van Analytics, zou u de Analytics volgende variabelen moeten kunnen zien gebruikend debugger van het Experience Platform.

  1. Open de Plaats WKNDin uw browser.

  2. Klik het Debugger pictogram van de Ervaring het platform Debugger van de Ervaring pictogram om Debugger van het 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 CTA knopen om aan een andere pagina te navigeren.

    Knoop CTA te klikken

  6. Terugkeer aan debugger van het Experience Platform en rol neer en breid Verzoeken van het Netwerk uit > Uw Reeks van het Rapport. U zou de 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 "Aangepaste 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 de Markeringen van het Experience Platform in Debugger van het Experience Platform wordt gecontroleerd.

Gefeliciteerd!

U gebruikte enkel de gebeurtenis-gedreven Laag en Markering van de Gegevens van de Adobe van de Cliënt in Experience Platform om de kliks van specifieke componenten op een AEM plaats te volgen.

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