[Integración]{class="badge positive"}

Seguimiento de componentes en los que se hizo clic con Adobe Analytics

Use la capa de datos del cliente de Adobe AEM con componentes principales impulsada por eventos para rastrear clics de componentes específicos en un sitio de Adobe Experience Manager. Obtenga información sobre cómo utilizar las reglas en la propiedad tag para detectar eventos de clic, filtrar por componente y enviar los datos a un Adobe Analytics con una señalización de seguimiento de vínculos.

Lo que va a generar what-build

El equipo de marketing de WKND está interesado en saber qué botones de Call to Action (CTA) funcionan mejor en la página de inicio. En este tutorial, vamos a agregar una regla a la propiedad de etiqueta que escucha los eventos cmp:click de los componentes Teaser y Button. A continuación, envíe el ID de componente y un nuevo evento a Adobe Analytics junto con la señalización de seguimiento de vínculos.

Lo que generará rastreará clics

Objetivos objective

  1. Cree una regla controlada por evento en la propiedad de etiqueta que capture el evento cmp:click.
  2. Filtre los diferentes eventos por tipo de recurso de componente.
  3. Establezca el ID de componente y envíe un evento a Adobe Analytics con la señalización de seguimiento de vínculos.

Requisitos previos

Este tutorial es una continuación de Recopilar datos de página con Adobe Analytics y supone que tiene lo siguiente:

Inspect: Esquema de botón y teaser

Antes de crear reglas en la propiedad de etiqueta, es útil revisar el esquema para Button y Teaser e inspeccionarlos en la implementación de la capa de datos.

  1. Navegar a página principal de WKND

  2. Abra las herramientas para desarrolladores del explorador y vaya a la Consola. Ejecute el siguiente comando:

    code language-js
    adobeDataLayer.getState();
    

    El código anterior devuelve el estado actual de la capa de datos del cliente de Adobe.

    Estado de capa de datos a través de la consola del explorador

  3. Expanda la respuesta y busque las entradas con el prefijo button- y teaser-xyz-cta. Debería ver un esquema de datos como el siguiente:

    Esquema de botón:

    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"
    

    Esquema de teaser:

    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"
    

    Los detalles de los datos anteriores se basan en el Esquema de componente/elemento del contenedor. La nueva regla de etiquetas utiliza este esquema.

Crear una regla en la que se hizo clic

La capa de datos del cliente de Adobe es una capa de datos impulsada por event. Cada vez que se hace clic en un componente principal, se envía un evento cmp:click a través de la capa de datos. Para escuchar el evento cmp:click, vamos a crear una regla

  1. Vaya a Experience Platform AEM y luego a la propiedad de etiquetas integrada con el sitio de.

  2. Vaya a la sección Reglas en la interfaz de usuario de la propiedad de etiquetas y haga clic en Agregar regla.

  3. Asigne un nombre a la regla CTA en la que se hizo clic.

  4. Haga clic en Eventos > Agregar para abrir el asistente de Configuración de eventos.

  5. Para el campo Tipo de evento, seleccione Código personalizado.

    Asigne un nombre a la regla CTA en la que se hizo clic y agregue el evento de código personalizado

  6. Haga clic en Abrir editor en el panel principal e introduzca el siguiente fragmento de código:

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

    El fragmento de código anterior agrega un detector de eventos al insertar una función en la capa de datos. Cada vez que se activa el evento cmp:click, se llama a la función componentClickedHandler. En esta función, se agregan algunas comprobaciones y se construye un nuevo objeto event con el último estado de la capa de datos del componente que activó el evento.

    Finalmente se llama a la función trigger(event). La función trigger() es un nombre reservado en la propiedad de etiqueta y déclencheur la regla. El objeto event se pasa como parámetro, que a su vez se expone con otro nombre reservado en la propiedad de etiqueta. Los elementos de datos de la propiedad de etiqueta ahora pueden hacer referencia a varias propiedades mediante fragmentos de código como event.component['someKey'].

  7. Guarde los cambios.

  8. A continuación, en Acciones, haga clic en Agregar para abrir el asistente de Configuración de la acción.

  9. Para el campo Tipo de acción, elija Código personalizado.

    Tipo de acción de código personalizado

  10. Haga clic en Abrir editor en el panel principal e introduzca el siguiente fragmento de código:

    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']);
    

    El objeto event se ha pasado desde el método trigger() llamado en el evento personalizado. El objeto component es el estado actual del componente derivado del método de la capa de datos getState() y es el elemento que activó el clic.

  11. AEM Guarde los cambios y ejecute una compilación en la propiedad de etiquetas para promocionar el código al entorno utilizado en el sitio de la.

    note note
    NOTE
    Puede resultar útil usar el Adobe Experience Platform Debugger para cambiar el código incrustado a un entorno Development.
  12. Vaya al sitio WKND y abra las herramientas para desarrolladores para ver la consola. Seleccione también la casilla de verificación Conservar registro.

  13. Haga clic en uno de los botones de CTA Teaser o Button para desplazarse a otra página.

    Botón CTA para hacer clic

  14. Observe en la consola del desarrollador que la regla CTA Clicked se ha activado:

    Se hizo clic en el botón CTA

Crear elementos de datos

A continuación, cree elementos de datos para capturar el ID y el título del componente en el que se hizo clic. Recuerde que en el ejercicio anterior el resultado de event.path era similar a component.button-b6562c963d y el valor de event.component['dc:title'] era similar a "Ver viajes".

ID de componente

  1. Vaya a Experience Platform AEM y luego a la propiedad de etiquetas integrada con el sitio de.

  2. Vaya a la sección Elementos de datos y haga clic en Agregar nuevo elemento de datos.

  3. Para el campo Nombre, escriba ID de componente.

  4. Para el campo Tipo de elemento de datos, seleccione Código personalizado.

    Formulario de elemento de datos de ID de componente

  5. Haga clic en el botón Abrir editor e introduzca lo siguiente en el editor de código personalizado:

    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. Guarde los cambios.

    note note
    NOTE
    Recuerde que el objeto event está disponible y con ámbito en función del evento que activó la regla en la propiedad de etiqueta. No se establece el valor de un elemento de datos hasta que se haga referencia al elemento de datos 1} en una regla. Por lo tanto, es seguro usar este elemento de datos dentro de una regla como la regla Page Loaded creada en el paso anterior pero no sería seguro usarla en otros contextos.

Título del componente

  1. Vaya a la sección Elementos de datos y haga clic en Agregar nuevo elemento de datos.

  2. Para el campo Nombre, escriba Título del componente.

  3. Para el campo Tipo de elemento de datos, seleccione Código personalizado.

  4. Haga clic en el botón Abrir editor e introduzca lo siguiente en el editor de código personalizado:

    code language-js
    if(event && event.component && event.component.hasOwnProperty('dc:title')) {
        return event.component['dc:title'];
    }
    
  5. Guarde los cambios.

Añadir una condición a la regla en la que se hizo clic en la CTA

A continuación, actualice la regla CTA Clicked para asegurarse de que la regla solo se active cuando el evento cmp:click se active para un Teaser o un Botón. Dado que la CTA del teaser se considera un objeto independiente en la capa de datos, es importante comprobar que el elemento principal para verificar que proviene de un teaser.

  1. En la interfaz de usuario de la propiedad Tag, navegue hasta la regla CTA en la que se hizo clic creada anteriormente.

  2. En Condiciones, haga clic en Agregar para abrir el asistente de Configuración de condición.

  3. Para el campo Tipo de condición, seleccione Código personalizado.

    Código personalizado de condición en la que se hizo clic

  4. Haga clic en Abrir editor e introduzca lo siguiente en el editor de código personalizado:

    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;
    

    El código anterior primero comprueba si el tipo de recurso era de Button o si el tipo de recurso era de una CTA dentro de un Teaser.

  5. Guarde los cambios.

Establecer variables de Analytics y señalización de seguimiento de vínculos de déclencheur

Actualmente, la regla CTA en la que se hizo clic simplemente genera una instrucción de consola. A continuación, use los elementos de datos y la extensión de Analytics para establecer las variables de Analytics como una acción. Vamos a definir una acción adicional para almacenar en déclencheur el vínculo de seguimiento y enviar los datos recopilados a Adobe Analytics.

  1. En la regla CTA Clicked, quitar la acción Core - Custom Code (las instrucciones de la consola):

    Quitar acción de código personalizado

  2. En Acciones, haga clic en Agregar para crear una acción.

  3. Establezca el tipo de Extension en Adobe Analytics y establezca Action Type en Set Variables.

  4. Establezca los siguientes valores para eVars, Props y Events:

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

    Definir prop. y eventos de eVar

    note note
    NOTE
    Aquí se usa %Component ID%, ya que garantiza un identificador único para la CTA en la que se hizo clic. Un posible inconveniente de usar %Component ID% es que el informe de Analytics contiene valores como button-2e6d32893a. Si se usa %Component Title%, se daría un nombre más descriptivo pero el valor podría no ser único.
  5. A continuación, agregue una acción adicional a la derecha de Adobe Analytics - Set Variables tocando el icono plus:

    Agregar una acción adicional a la regla de etiquetas

  6. Establezca el tipo de Extension en Adobe Analytics y establezca Action Type en Send Beacon.

  7. En Seguimiento establezca el botón de opción en s.tl().

  8. Para el campo Tipo de vínculo, elija Vínculo personalizado y para Nombre de vínculo establezca el valor en: %Component Title%: CTA Clicked:

    Configuración de la señalización de vínculo de envío

    La configuración anterior combina la variable dinámica del elemento de datos Título del componente y la cadena estática CTA en la que se hizo clic.

  9. Guarde los cambios. La regla CTA en la que se hizo clic debe tener la configuración siguiente:

    Configuración final de la regla de etiquetas

    • 1. Escuche el evento cmp:click.
    • 2. Compruebe que el evento se activó mediante un botón o un teaser.
    • 3. configuró variables de Analytics para que hicieran un seguimiento de ID de componente como eVar, prop y evento.
    • 4. envía la señalización de seguimiento de vínculos de Analytics (y no la trata como una vista de página).
  10. Guarde todos los cambios y cree su biblioteca de etiquetas, promocionando al entorno adecuado.

Validación de la señalización de seguimiento de vínculos y la llamada de Analytics

Ahora que la regla CTA en la que se hizo clic envía la señalización de Analytics, debería poder ver las variables de seguimiento de Analytics mediante Experience Platform Debugger.

  1. Abra el sitio WKND en su explorador.

  2. Haga clic en el icono de Debugger Experience Platform Debugger para abrir Experience Platform Debugger.

  3. Asegúrese de que Debugger asigne la propiedad de etiqueta a su entorno de desarrollo, tal como se describió anteriormente, y de que se compruebe Registro de consola.

  4. Abra el menú Analytics y verifique que el grupo de informes esté establecido en su grupo de informes.

    Debugger de ficha de Analytics

  5. En el explorador, haga clic en uno de los botones de CTA Teaser o Button para desplazarse a otra página.

    Botón CTA para hacer clic

  6. Vuelva a Experience Platform Debugger y desplácese hacia abajo para expandir Solicitudes de red > Su grupo de informes. Debería poder encontrar el conjunto eVar, prop y evento.

    Eventos, evar y prop de Analytics rastreados al hacer clic

  7. Vuelva al explorador y abra la consola de desarrollador. Navegue hasta el pie de página del sitio y haga clic en uno de los vínculos de navegación:

    Haga clic en Vínculo de navegación en el pie de página

  8. Observe que en la consola del explorador no se cumplió el mensaje "Código personalizado" para la regla "CTA en la que se hizo clic".

    El mensaje anterior se debe a que el componente de navegación no almacena en déclencheur un evento cmp:click pero debido a Condición de la regla que comprueba el tipo de recurso para la que no se realiza ninguna acción.

    note note
    NOTE
    Si no ve ningún registro de consola, asegúrese de que Registro de consola esté marcado en Etiquetas de Experience Platform en Experience Platform Debugger.

Enhorabuena.

Acaba de utilizar el Adobe impulsado por evento Capa de datos del cliente y Experience Platform AEM en para rastrear los clics de componentes específicos en un sitio de.

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