DocumentaciónAEMTutoriales de AEMTutoriales de AEM Sites

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

Integración de AEM Sites y SDK web de Experience Platform

Last update: Tue Sep 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Principiante
  • Intermedio
  • Administrador
  • Desarrollador

[AEM Sites as a Cloud Service]{class="badge informative"}

Aprenda a integrar AEM as a Cloud Service con el Experience Platform SDK web. Este paso fundamental es esencial para integrar productos de Adobe Experience Cloud, como Adobe Analytics, Target o productos innovadores recientes como Real-time Customer Data Platform, Customer Journey Analytics y Journey Optimizer.

También aprenderá a recopilar y enviar WKND: datos de vista de página del proyecto de Adobe Experience Manager de ejemplo en el Experience Platform.

Después de completar esta configuración, ha implementado una base sólida. Además, está listo para avanzar en la implementación del Experience Platform mediante aplicaciones como Real-time Customer Data Platform (Real-Time CDP), Customer Journey Analytics (CJA) y Adobe Journey Optimizer (AJO). La implementación avanzada ayuda a mejorar la participación de los clientes mediante la estandarización de la web y los datos de los clientes.

Requisitos previos

Se requiere lo siguiente al integrar el SDK web de Experience Platform.

AEM En como Cloud Service:

En Experience Platform:

  • Acceso a la zona protegida Prod de producción predeterminada.
  • Acceso a Esquemas en Administración de datos
  • Acceso a Conjuntos de datos en Administración de datos
  • Acceso a Datastreams en Recopilación de datos
  • Acceso a Etiquetas en Recopilación de datos

Si no cuenta con los permisos necesarios, el administrador del sistema que use Adobe Admin Console podrá concederle los permisos necesarios.

video poster

https://video.tv.adobe.com/v/3418856?quality=12&learn=on

Crear esquema XDM: Experience Platform

El esquema del modelo de datos de experiencia (XDM) le ayuda a estandarizar los datos de experiencia del cliente. Para recopilar los datos de WKND pageview, cree un esquema XDM y utilice los grupos de campos AEP Web SDK ExperienceEvent proporcionados por el Adobe para la recopilación de datos web.

Existen modelos genéricos y específicos de sectores como, por ejemplo, minoristas, de servicios financieros, de atención sanitaria y muchos más, un conjunto de modelos de datos de referencia. Consulte Descripción general de los modelos de datos de sector para obtener más información.

video poster

https://video.tv.adobe.com/v/3436002?quality=12&learn=on&captions=spa

Obtenga información acerca del esquema XDM y conceptos relacionados, como grupos de campos, tipos, clases y tipos de datos de la descripción general del sistema XDM.

La descripción general del sistema XDM es un excelente recurso para obtener información sobre el esquema XDM y conceptos relacionados, como grupos de campos, tipos, clases y tipos de datos. Proporciona una comprensión completa del modelo de datos XDM y cómo crear y administrar esquemas XDM para estandarizar los datos en la empresa. Explórela para comprender mejor el esquema XDM y cómo puede beneficiar a los procesos de recopilación y administración de datos.

Crear secuencia de datos: Experience Platform

Un flujo de datos indica al Edge Network de Platform a dónde enviar los datos recopilados. Por ejemplo, se puede enviar a Experience Platform, Analytics o Adobe Target.

video poster

https://video.tv.adobe.com/v/3418895?quality=12&learn=on

Familiarícese con el concepto de flujos de datos y temas relacionados, como el control y la configuración de datos, en la página de Información general de flujos de datos.

Crear propiedad de etiqueta: Experience Platform

Obtenga información sobre cómo crear una propiedad de etiqueta en Experience Platform para agregar la biblioteca JavaScript del SDK web al sitio web de WKND. La propiedad de etiquetas recién definida tiene los siguientes recursos:

  • Extensiones de etiquetas: Core y SDK web de Adobe Experience Platform
  • Elementos de datos: elementos de datos de tipo de código personalizado que extraen nombre de página, sección de sitio y nombre de host mediante la capa de datos del cliente de Adobe del sitio WKND. Además, el elemento de datos de tipo Objeto XDM que cumple con la compilación del esquema XDM WKND recién creado anteriormente del paso Crear esquema XDM.
  • Regla: enviar datos al Edge Network de Platform cada vez que se visita una página web de WKND mediante el evento cmp:show activado por la capa de datos del cliente de Adobe.

Al generar y publicar la biblioteca de etiquetas con Flujo de publicación, puede usar el botón Agregar todos los recursos modificados. Para seleccionar todos los recursos, como Data Element, Rule y Tag Extensions, en lugar de identificar y seleccionar un recurso individual. Además, durante la fase de desarrollo, puede publicar la biblioteca solo en el entorno Development y luego verificarla y promocionarla al entorno Stage o Production.

video poster

https://video.tv.adobe.com/v/3418896?quality=12&learn=on

TIP
El elemento de datos y el código de evento de regla que se muestran en el vídeo están disponibles para su referencia, expanda el elemento de acordeón siguiente. Sin embargo, si NO utiliza la capa de datos del cliente de Adobe, debe modificar el siguiente código, pero se sigue aplicando el concepto de definir los elementos de datos y utilizarlos en la definición de regla.
Elemento de datos y código de regla-evento

  • El código del elemento de datos Page Name.

    code language-javascript 
    if(event && event.component && event.component.hasOwnProperty('dc:title')) {
    // return value of 'dc:title' from the data layer Page object, which is propogated via 'cmp:show` event
    return event.component['dc:title'];
}

  • El código del elemento de datos Site Section.

    code language-javascript 
    if(event && event.component && event.component.hasOwnProperty('repo:path')) {
let pagePath = event.component['repo:path'];

let siteSection = '';

//Check of html String in URL.
if (pagePath.indexOf('.html') > -1) {
 siteSection = pagePath.substring(0, pagePath.lastIndexOf('.html'));

 //replace slash with colon
 siteSection = siteSection.replaceAll('/', ':');

 //remove `:content`
 siteSection = siteSection.replaceAll(':content:','');
}

    return siteSection
}

  • El código del elemento de datos Host Name.

    code language-javascript 
    if(window && window.location && window.location.hostname) {
    return window.location.hostname;
}

  • El código de evento de regla all pages - on load

    code language-javascript 
    var pageShownEventHandler = function(evt) {
// defensive coding to avoid a null pointer exception
if(evt.hasOwnProperty("eventInfo") && evt.eventInfo.hasOwnProperty("path")) {
    // trigger tags Rule and pass event
    console.debug("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 tags Rule, passing in the new 'event' object
    // the 'event' obj can now be referenced by the reserved name 'event' by other tags 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);
});

La descripción general de etiquetas proporciona información detallada sobre conceptos importantes, como elementos de datos, reglas y extensiones.

AEM Para obtener información adicional sobre la integración de componentes principales de con la capa de datos del cliente de Adobe, consulte la Guía de uso de la capa de datos del cliente de Adobe AEM con componentes principales.

AEM Conectar la propiedad de etiqueta a la

AEM Descubra cómo vincular la propiedad de etiquetas creada recientemente a las etiquetas a través de Adobe IMS y a las etiquetas en Configuración de Adobe Experience Platform AEM en. Cuando se establece un entorno de AEM as a Cloud Service, se generan automáticamente varias configuraciones de cuenta técnica de IMS de Adobe, incluidas las etiquetas. Para obtener instrucciones paso a paso, consulte Conectar AEM Sites con la propiedad Tag mediante IMS.

AEM Sin embargo, para la versión 6.5 de la aplicación, debe configurar una manualmente.

Después de vincular la propiedad de etiqueta, el sitio WKND puede cargar la biblioteca de JavaScript de la propiedad de etiqueta en las páginas web mediante las etiquetas de la configuración del servicio en la nube de Adobe Experience Platform.

Verificar la propiedad de etiqueta al cargarse en WKND

Con la extensión de Adobe Experience Platform Debugger Chrome, compruebe si la propiedad de etiqueta se está cargando en páginas WKND. Puede verificar lo siguiente:

  • Detalles de la propiedad de etiquetas, como extensión, versión, nombre y más.
  • Versión de biblioteca del SDK web de Platform, ID de flujo de datos
  • Objeto XDM como parte events atributo en el SDK web de Experience Platform

video poster

https://video.tv.adobe.com/v/3418897?quality=12&learn=on

Crear conjunto de datos: Experience Platform

Los datos de vista de página recopilados mediante el SDK web se almacenan en el lago de datos del Experience Platform como conjuntos de datos. El conjunto de datos es una construcción de almacenamiento y administración para una colección de datos, como una tabla de base de datos, que sigue un esquema. Obtenga información sobre cómo crear un conjunto de datos y configurar la secuencia de datos creada anteriormente para enviar datos al Experience Platform.

video poster

https://video.tv.adobe.com/v/3418898?quality=12&learn=on

La descripción general de conjuntos de datos proporciona más información sobre conceptos, configuraciones y otras capacidades de ingesta.

Datos de vista de página WKND en el Experience Platform

AEM Después de configurar el SDK web con el SDK de, sobre todo en el sitio WKND, es hora de generar tráfico navegando por las páginas del sitio. A continuación, confirme que los datos de la vista de página se están introduciendo en el conjunto de datos del Experience Platform. En la interfaz de usuario del conjunto de datos, se muestran varios detalles, como los registros totales, el tamaño y los lotes ingeridos, junto con un gráfico de barras visualmente atractivo.

video poster

https://video.tv.adobe.com/v/3418899?quality=12&learn=on

Resumen

¡Buen trabajo! AEM Ha completado la configuración de la configuración de con el SDK web de Experience Platform para recopilar e introducir datos de un sitio web. Con esta base, ahora puede explorar más posibilidades para mejorar e integrar productos como Analytics, Target, Customer Journey Analytics (CJA) y muchos otros para crear experiencias enriquecidas y personalizadas para sus clientes. Siga aprendiendo y explorando para liberar todo el potencial de Adobe Experience Cloud.

video poster

https://video.tv.adobe.com/v/3418900?quality=12&learn=on

AVAILABILITY
Si prefiere el vídeo completo que cubre todo el proceso de integración en lugar de los vídeos de pasos de configuración individuales, puede hacer clic aquí para acceder a él.

Recursos adicionales

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