[Integración]{class="badge positive"}
Integración de AEM Sites y Adobe Analytics
Obtenga información sobre cómo integrar AEM Sites y Adobe Analytics con la extensión de etiquetas de Adobe Analytics, mediante las funciones integradas de la Capa de datos del cliente de Adobe AEM con componentes principales de para recopilar datos sobre una página en Adobe Experience Manager Sites. Etiquetas en el Experience Platform y el Extensión de Adobe Analytics se utilizan para crear reglas para enviar datos de página a Adobe Analytics.
Lo que va a generar what-build
En este tutorial, va a almacenar en déclencheur una regla de etiquetas basada en un evento de la capa de datos del cliente de Adobe. Además, agregue condiciones para cuándo se debe activar la regla y, a continuación, envíe el Nombre de página y Plantilla de página AEM valores de una página de a Adobe Analytics.
Objetivos objective
- Cree una regla impulsada por evento en la propiedad de etiqueta que capture los cambios de la capa de datos
- Asignar propiedades de capa de datos de página a elementos de datos en la propiedad de etiqueta
- Recopilación y envío de datos de página a Adobe Analytics mediante la señalización de vista de página
Requisitos previos
Se requiere lo siguiente:
- Propiedad de etiqueta en Experience Platform
- Adobe Analytics ID del grupo de informes de prueba/desarrollo y servidor de seguimiento. Consulte la siguiente documentación para creación de un grupo de informes.
- Experience Platform Debugger extensión del explorador. Capturas de pantalla de este tutorial capturadas desde el navegador Chrome.
- AEM (Opcional) Sitio de con Capa de datos del cliente de Adobe habilitada. Este tutorial utiliza el entorno público WKND sitio, pero puede utilizar su propio sitio.
Cambiar el entorno de etiquetas para el sitio WKND
El WKND es un sitio público creado sobre la base de un proyecto de código abierto diseñado como referencia y tutorial AEM para una implementación de la.
AEM En lugar de configurar un entorno de e instalar el código base de WKND, puede utilizar el depurador de Experience Platform para lo siguiente cambiar el live Sitio WKND hasta su propiedad de etiqueta. AEM Sin embargo, puede utilizar su propio sitio de la si ya tiene el Capa de datos del cliente de Adobe habilitada.
-
Inicie sesión en el Experience Platform y crear una propiedad Tag (si aún no lo ha hecho).
-
Asegúrese de que haya una etiqueta JavaScript inicial se ha creado la biblioteca y se promocionan a la etiqueta entorno.
-
Copie el código incrustado de JavaScript del entorno de etiquetas en el que se ha publicado la biblioteca.
-
En el explorador, abra una pestaña nueva y navegue hasta Sitio WKND
-
Abra la extensión del explorador de Experience Platform Debugger.
-
Vaya a Etiquetas de Experience Platform > Configuración y en Códigos incrustados insertados reemplazar el código incrustado existente con su código incrustado copiado del paso 3.
-
Activar Registro de consola y Bloquear Use el depurador en la pestaña WKND.
Comprobar la capa de datos del cliente de Adobe en el sitio WKND
El Proyecto de referencia de WKND AEM se crea con los componentes principales de la y tiene el Capa de datos del cliente de Adobe habilitada de forma predeterminada. A continuación, compruebe que la capa de datos del cliente de Adobe esté habilitada.
-
Vaya a Sitio WKND.
-
Abra las herramientas para desarrolladores del explorador y vaya al 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.
-
Expanda la respuesta e inspeccione el
page
entrada. Debería ver un esquema de datos como el siguiente: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"
Para enviar datos de página a Adobe Analytics, usemos las propiedades estándar como
dc:title
,xdm:language
, yxdm:template
de la capa de datos.Para obtener más información, consulte Esquema de página de los Esquemas de datos de componentes principales.
note note NOTE Si no ve la etiqueta adobeDataLayer
¿Objeto JavaScript? Asegúrese de que la variable Se ha habilitado la capa de datos del cliente de Adobe en el sitio.
Crear una regla de carga de página
La capa de datos del cliente de Adobe es un impulsado por eventos capa de datos. AEM Cuando se carga la capa de datos de la página de, se genera un déclencheur de cmp:show
evento. Cree una regla que se active cuando la variable cmp:show
se activa desde la capa de datos de página.
-
Vaya a Experience Platform AEM y luego a la propiedad de etiquetas integrada con el sitio de.
-
Vaya a Reglas en la interfaz de usuario de la propiedad de etiquetas y haga clic en Crear nueva regla.
-
Asignar un nombre a la regla Página cargada.
-
En el Eventos , haga clic en Añadir para abrir Configuración de eventos asistente.
-
Para Tipo de evento , seleccione Código personalizado.
-
Clic Abrir editor en el panel principal e introduzca el siguiente fragmento de código:
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); });
El fragmento de código anterior agrega un detector de eventos de inserción de una función en la capa de datos. Cuándo
cmp:show
se activa elpageShownEventHandler
se llama a la función. En esta función, se añaden algunas comprobaciones de coherencia y una nuevaevent
se construye con la última estado de la capa de datos para el componente que activó el evento.Finalmente, la
trigger(event)
se llama a la función. Eltrigger()
función es un nombre reservado en la propiedad etiqueta y déclencheur la regla. Elevent
El objeto 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 comoevent.component['someKey']
. -
Guarde los cambios.
-
Siguiente debajo de Acciones click Añadir para abrir Configuración de acción asistente.
-
Para Tipo de acción , elija Código personalizado.
-
Clic Abrir editor en el panel principal e introduzca el siguiente fragmento de código:
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']);
El
event
se pasa desde eltrigger()
método invocado en el evento personalizado. Aquí, elcomponent
es la página actual derivada de la capa de datosgetState
en el evento personalizado. -
Guarde los cambios y ejecute un generar en la propiedad tag para promocionar el código a entorno AEM se utiliza en el sitio de la.
note note NOTE Puede resultar útil utilizar la variable Adobe Experience Platform Debugger para cambiar el código incrustado a Desarrollo entorno. -
AEM Vaya al sitio de la y abra las herramientas para desarrolladores para ver la consola. Actualice la página y debería ver que se han registrado los mensajes de la consola:
Crear elementos de datos
A continuación, cree varios elementos de datos para capturar valores diferentes de la capa de datos del cliente de Adobe. Como se ha visto en el ejercicio anterior, es posible acceder a las propiedades de la capa de datos directamente a través del código personalizado. La ventaja de utilizar elementos de datos es que se pueden reutilizar en las reglas de etiquetas.
Los elementos de datos se asignan a @type
, dc:title
, y xdm:template
propiedades.
Tipo de medio de componente
-
Vaya a Experience Platform AEM y luego a la propiedad de etiquetas integrada con el sitio de.
-
Vaya a Elementos de datos y haga clic en Crear nuevo elemento de datos.
-
Para el Nombre , introduzca la variable Tipo de medio de componente.
-
Para el Tipo de elemento de datos , seleccione Código personalizado.
-
Clic Abrir editor e introduzca lo siguiente en el editor de código personalizado:
code language-js if(event && event.component && event.component.hasOwnProperty('@type')) { return event.component['@type']; }
-
Guarde los cambios.
note note NOTE Recuerde que la variable event
está disponible y su ámbito se basa en el evento que activó el Regla en la propiedad de etiqueta. El valor de un elemento de datos no se establece hasta que se define el elemento de datos referenciado dentro de una regla. Por lo tanto, es seguro utilizar este elemento de datos dentro de una regla como la Página cargada regla creada en el paso anterior pero no sería seguro utilizarlo en otros contextos.
Nombre de página
-
Clic Añadir elemento de datos botón
-
Para el Nombre , introduzca Nombre de página.
-
Para el Tipo de elemento de datos , seleccione Código personalizado.
-
Clic 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']; }
-
Guarde los cambios.
Plantilla de la página
-
Haga clic en Añadir elemento de datos botón
-
Para el Nombre , introduzca Plantilla de página.
-
Para el Tipo de elemento de datos , seleccione Código personalizado.
-
Clic Abrir editor e introduzca lo siguiente en el editor de código personalizado:
code language-js if(event && event.component && event.component.hasOwnProperty('xdm:template')) { return event.component['xdm:template']; }
-
Guarde los cambios.
-
Ahora debe tener tres elementos de datos como parte de la regla:
Añadir la extensión de Analytics
A continuación, añada la extensión de Analytics a la propiedad de etiquetas para enviar datos a un grupo de informes.
-
Vaya a Experience Platform AEM y luego a la propiedad de etiquetas integrada con el sitio de.
-
Ir a Extensiones > Catálogo
-
Busque el Adobe Analytics y haga clic en Instalar
-
En Administración de biblioteca > Grupos de informes, introduzca los id de los grupos de informes que desee utilizar con cada entorno de etiquetas.
note note NOTE Es aceptable utilizar un grupo de informes para todos los entornos en este tutorial, pero en la vida real le recomendamos utilizar grupos de informes separados, como se muestra en la siguiente imagen note tip TIP Se recomienda utilizar la variable Opción Administrar la biblioteca por mí como la configuración de Administración de biblioteca, ya que facilita en gran medida mantener la variable AppMeasurement.js
biblioteca actualizada. -
Marque la casilla para habilitar Usar Activity Map.
-
En General > Servidor de seguimiento, introduzca su servidor de seguimiento, por ejemplo,
tmd.sc.omtrdc.net
. Introduzca el servidor de seguimiento SSL si su sitio es compatible con.https://
-
Clic Guardar para guardar los cambios.
Añadir una condición a la regla Page Loaded
A continuación, actualice el Página cargada regla para utilizar Tipo de medio de componente elemento de datos para garantizar que la regla solo se active cuando el cmp:show
evento es para Página. Otros componentes pueden activar el cmp:show
, por ejemplo, el componente Carrusel lo activa cuando cambian las diapositivas. Por lo tanto, es importante agregar una condición para esta regla.
-
En la interfaz de usuario de la propiedad Etiqueta, vaya a Página cargada regla creada anteriormente.
-
En Condiciones click Añadir para abrir Configuración de condición asistente.
-
Para Tipo de condición , seleccione Value Comparison opción.
-
Establezca el primer valor del campo de formulario en
%Component Resource Type%
. Puede utilizar el icono de elemento de datos para seleccionar Tipo de medio de componente elemento de datos. Deje el comparador configurado como.Equals
. -
Establezca el segundo valor en
wknd/components/page
.note note NOTE Es posible añadir esta condición dentro de la función de código personalizado que escucha el cmp:show
evento creado anteriormente en el tutorial. Sin embargo, agregarla dentro de la interfaz de usuario da más visibilidad a los usuarios adicionales que pueden necesitar realizar cambios en la regla. Además, podemos utilizar nuestro elemento de datos. -
Guarde los cambios.
Establecer variables de Analytics y señalización de vista de página déclencheur
Actualmente la variable Página cargada La regla simplemente genera una instrucción de consola. A continuación, utilice los elementos de datos y la extensión de Analytics para establecer variables de Analytics como un acción en el Página cargada regla. También establecemos una acción adicional para almacenar en déclencheur la variable Señalización de vista de página y enviar los datos recopilados a Adobe Analytics.
-
En la regla Page Loaded, quitar el Core - Custom Code acción (instrucciones de la consola):
-
En la subsección Acciones, haga clic en Añadir para añadir una nueva acción.
-
Configure las variables Extensión escriba a Adobe Analytics y configure el Tipo de acción hasta Establecer variables
-
En el panel principal, seleccione un disponible eVar y se establece como el valor del elemento de datos Plantilla de página. Uso del icono Elementos de datos para seleccionar Plantilla de página Elemento.
-
Desplazarse hacia abajo, debajo de Configuración adicional set Nombre de página al elemento de datos Nombre de página:
-
Guarde los cambios.
-
A continuación, añada una acción adicional a la derecha de Adobe Analytics: Establecer variables pulsando el botón plus icono:
-
Configure las variables Extensión escriba a Adobe Analytics y configure el Tipo de acción hasta Send Beacon. Dado que esta acción se considera una vista de página, deje el seguimiento predeterminado establecido en
s.t()
. -
Guarde los cambios. El Página cargada La regla debe tener la configuración siguiente:
- 1. Escuche el
cmp:show
evento. - 2. Compruebe que el evento se activó mediante una página.
- 3. Establecer variables de Analytics para Nombre de página y Plantilla de página
- 4. Envío de la señalización de vista de página de Analytics
- 1. Escuche el
-
Guarde todos los cambios y cree su biblioteca de etiquetas, promocionando al entorno adecuado.
Validar la señalización de vista de página y la llamada de Analytics.
Ahora que la variable Página cargada La regla envía la señalización de Analytics. Debería poder ver las variables de seguimiento de Analytics mediante Experience Platform Debugger.
-
Abra el Sitio WKND en el explorador.
-
Haga clic en el icono Debugger para abrir Experience Platform Debugger.
-
Asegúrese de que Debugger asigne la propiedad de etiqueta a su Entorno de desarrollo, tal como se describió anteriormente y Registro de consola está marcada.
-
Abra el menú Analytics y compruebe que el grupo de informes está configurado en su grupo de informes. También debe rellenarse el Nombre de página:
-
Desplazarse hacia abajo y expandir Solicitudes de red. Debería ser capaz de encontrar el evar configure para el Plantilla de página:
-
Vuelva al explorador y abra la consola de desarrollador. Haga clic en Carrusel en la parte superior de la página.
-
Observe en la consola del explorador la instrucción de consola:
Esto se debe a que el carrusel hace un déclencheur a
cmp:show
evento pero debido a nuestra comprobación de la Tipo de medio de componente, no se activa ningún evento.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. -
Navegue hasta una página de artículo como Australia Occidental. Observe que Nombre de página y Tipo de plantilla cambian.
Enhorabuena.
Acaba de utilizar la capa de datos del cliente de Adobe impulsada por evento y las etiquetas en Experience Platform AEM para recopilar datos de página de un sitio de y enviarlos a Adobe Analytics.
Pasos siguientes
Consulte el siguiente tutorial para aprender a utilizar la capa de datos del cliente de Adobe impulsada por evento para lo siguiente seguimiento de clics de componentes específicos en un sitio de Adobe Experience Manager.