DocumentaciónExperience PlatformTutorial de SDK web

Configuración de Adobe Analytics con el SDK web de Adobe Experience Platform

Last update: Sat Jun 01 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Principiante
  • Intermedio
  • Desarrollador

Obtenga información sobre cómo configurar Adobe Analytics mediante SDK web de Adobe Experience Platform, cree reglas de etiquetas para enviar datos a Adobe Analytics y valide que Analytics está capturando los datos según lo esperado.

Adobe Analytics es una aplicación líder del sector que le permite comprender a sus clientes como personas y dirigir su negocio con inteligencia de clientes.

Diagrama del SDK web a Adobe Analytics

Objetivos de aprendizaje

Al final de esta lección, debe poder:

  • Configuración de una secuencia de datos para habilitar Adobe Analytics
  • Saber qué campos XDM estándar se asignan automáticamente a variables de Analytics
  • Establecer variables de Analytics en el objeto de datos
  • Enviar datos a otro grupo de informes anulando el conjunto de datos
  • Validar variables de Adobe Analytics mediante Debugger y Assurance

Requisitos previos

Para completar esta lección, primero debe:

  • Estar familiarizado con Adobe Analytics y tener acceso a él.

  • Tener al menos un ID de grupo de informes de prueba o desarrollo. Si no dispone de un grupo de informes de prueba o desarrollo que pueda utilizar para este tutorial, cree uno.

  • Complete las lecciones anteriores de las secciones Configuración inicial y Configuración de etiquetas de este tutorial.

Configuración de la secuencia de datos

El SDK web de Platform envía datos del sitio web al Edge Network de Platform. A continuación, la secuencia de datos indica al Edge Network de Platform a qué grupos de informes de Adobe Analytics se deben enviar los datos.

  1. Ir a Recopilación de datos interfaz

  2. En el panel de navegación izquierdo, seleccione Datastreams

  3. Seleccione el creado anteriormente Luma Web SDK: Development Environment secuencia de datos

    Seleccione la secuencia de datos del SDK web de Luma

  4. Seleccionar Añadir servicio
    Añadir un servicio al conjunto de datos

  5. Seleccionar Adobe Analytics como el Servicio

  6. Introduzca el ID del grupo de informes del grupo de informes de desarrollo

  7. Seleccionar Guardar

    Análisis de guardado de flujo de datos

    note tip
    TIP
    Agregar más grupos de informes seleccionando Agregar grupo de informes es equivalente al etiquetado de grupos múltiples.
WARNING
En este tutorial, solo puede configurar el grupo de informes de Adobe Analytics para su entorno de desarrollo. Al crear flujos de datos para su propio sitio web, debe crear flujos de datos y grupos de informes adicionales para los entornos de ensayo y producción.

Establecer variables de Analytics

Existen varias formas de establecer variables de Analytics en una implementación de SDK web:

  1. Asignación automática de campos XDM a variables de Analytics (automática).
  2. Establecer campos en la variable data objeto (recomendado).
  3. Asigne campos XDM a variables de Analytics en reglas de procesamiento de Analytics (ya no se recomienda).
  4. Asigne a variables de Analytics directamente en el esquema XDM (ya no se recomienda).

A partir de mayo de 2024, ya no necesita crear un esquema XDM para implementar Adobe Analytics con el SDK web de Platform. El data objeto (y el data.variable elemento de datos que ha creado en Creación de elementos de datos ) para configurar todas las variables de Analytics personalizadas. La configuración de estas variables en el objeto de datos resultará familiar a los clientes de Analytics existentes, es más eficaz que el uso de la interfaz de reglas de procesamiento y evita que datos innecesarios ocupen espacio en los perfiles de cliente en tiempo real (importante si tiene Real-time Customer Data Platform o Journey Optimizer).

Campos asignados automáticamente

Muchos campos XDM se asignan automáticamente a variables de Analytics. Para obtener la lista más actualizada de asignaciones, consulte Asignación de variables de Analytics en Adobe Experience Edge.

Esto ocurre si incluso si no ha definido un esquema personalizado. El SDK web de Experience Platform recopila automáticamente algunos datos y los envía al Edge Network de Platform como campos XDM. Por ejemplo, el SDK web lee la dirección URL de la página actual y la envía como campo XDM web.webPageDetails.URL. Este campo se reenvía a Adobe Analytics y rellena automáticamente los informes de URL de la página en Adobe Analytics.

Si implementa un SDK web para Adobe Analytics con un esquema XDM, como ha hecho en este tutorial, algunos de los campos XDM que ha implementado se asignan automáticamente a variables de Analytics, como se describe en esta tabla:

Variables asignadas automáticamente de XDM a Analytics
variable de Adobe Analytics
identitymap.ecid.[0].id
mid
web.webPageDetails.name
s.pageName
web.webPageDetails.server
s.server
web.webPageDetails.siteSection
s.channel
commerce.productViews.value
prodView
commerce.productListViews.value
scView
commerce.checkouts.value
scCheckout
commerce.purchases.value
compra
commerce.order.currencyCode
s.currencyCode
commerce.order.purchaseID
s.purchaseID
productListItems[].SKU
s.products=;product name;;;; (primary; consulte la nota más abajo)
productListItems[].name
s.products=;product name;;;; (reserva: consulte la nota más abajo)
productListItems[].quantity
s.products=;;product quantity;;;
productListItems[].priceTotal
s.product=;;;product price;;

Las secciones individuales de la cadena de producto de Analytics se configuran mediante diferentes variables XDM en la variable productListItems objeto.

NOTE
El 18 de agosto de 2022, productListItems[].SKU tiene prioridad para la asignación al nombre del producto en la variable s.products.
El valor establecido en productListItems[].name se asigna al nombre del producto solo si productListItems[].SKU no existe. De lo contrario, no está asignado y disponible en los datos de contexto.
No establezca una cadena vacía o nulo como productListItems[].SKU. Esto tiene el efecto no deseado de asignar al nombre del producto en la variable s.products.

Establecer variables en el objeto de datos

Pero, ¿qué sucede con las eVars, las props y los eventos? Configuración de variables en data es la forma recomendada de establecer estas variables de Analytics con el SDK web. La configuración de variables en el objeto de datos también puede sobrescribir cualquiera de las variables asignadas automáticamente.

En primer lugar, ¿cuál es el data objeto? En cualquier evento del SDK web puede enviar dos objetos con datos personalizados, el xdm y el objeto data objeto. Ambos se envían al Edge Network de Platform, pero solo el xdm se envía al conjunto de datos del Experience Platform. Propiedades en la data el objeto se puede asignar en Edge a xdm Los campos que utilizan la función Preparación de datos para la recopilación de datos, pero de lo contrario no se envían al Experience Platform. Esto lo convierte en una forma ideal de enviar datos a aplicaciones como Analytics, que no están creadas de forma nativa en Experience Platform.

Estos son los dos objetos de una llamada genérica del SDK web:

objetos data y xdm

Adobe Analytics está configurado para buscar cualquier propiedad en data.__adobe.analytics y utilizarlos para variables de Analytics.

Ahora veamos cómo funciona esto. Vamos a establecer eVar1 y prop1 con su nombre de página y vea cómo se puede sobrescribir el valor asignado a XDM

  1. Abra la regla de etiqueta all pages - library loaded - set global variables - 1
  2. Añadir un nuevo Acción
  3. Seleccionar SDK web de Adobe Experience Platform extensión
  4. Seleccionar Tipo de acción as Actualizar variable
  5. Seleccionar data.variable como el Elemento de datos
  6. Seleccione el análisis objeto
  7. Establecer eVar1 como el page.pageInfo.pageName elemento de datos
  8. Establecer prop1 para copiar el valor de eVar1
  9. Para probar la sobrescritura de valores asignados a XDM, en la variable Propiedad adicional establece el nombre de la página como un valor estático test
  10. Guarde la regla

Ahora, es necesario incluir el objeto de datos en la regla de evento de envío.

  1. Abra la regla de etiqueta all pages - library loaded - send event - 50
  2. Abra el Enviar evento acción
  3. Seleccionar data.variable como el Datos
  4. Seleccionar Conservar cambios
  5. Seleccionar Guardar

Envío de datos a otro grupo de informes

Es posible que desee cambiar a qué grupos de informes de Adobe Analytics se envían los datos cuando los visitantes se encuentran en determinadas páginas. Esto requiere una configuración tanto en el conjunto de datos como en una regla.

Configuración de la secuencia de datos para la anulación de un grupo de informes

Para configurar la configuración de anulación de grupos de informes de Adobe Analytics en el conjunto de datos:

  1. Abra su secuencia de datos

  2. Edite el Adobe Analytics mediante la apertura de la más y, a continuación, seleccione Editar

    Sobrescribir la secuencia de datos

  3. Seleccionar Opciones avanzadas para abrir Anulaciones de grupos de informes

  4. Seleccione los grupos de informes que desee anular. En este caso, Web SDK Course Dev y Web SDK Course Stg

  5. Seleccionar Guardar

    Sobrescribir la secuencia de datos

Configuración de una regla para una anulación de grupo de informes

Vamos a crear una regla para enviar una llamada de vista de página adicional a un grupo de informes diferente. Utilice la función de anulación de la secuencia de datos para cambiar el grupo de informes de una página mediante Enviar evento Acción.

  1. Cree una nueva regla y asígnele el nombre homepage - library loaded - AA report suite override - 51

  2. Seleccione el signo más debajo de Evento para añadir un nuevo déclencheur

  3. En Extensión, seleccione Núcleo

  4. En Tipo de evento, seleccione Library Loaded (Page Top)

  5. Seleccionar para abrir Opciones avanzadas, escriba 51. Esto garantiza que la regla se ejecute después de que all pages - library loaded - send event - 50 que establece el XDM de línea base con el Actualizar variable tipo de acción.

  6. Seleccionar Conservar cambios

    Anulación de grupo de informes de Analytics

  7. En Condiciones, seleccione para Añadir

  8. Salir Tipo de lógica as Normal

  9. Salir Extensiones as Núcleo

  10. Seleccionar Tipo de condición as Ruta sin cadena de consulta

  11. A la derecha, deje el Regex alternancia deshabilitada

  12. En ruta igual a set /content/luma/us/en.html. Para el sitio de demostración de Luma, garantiza que la regla solo contenga déclencheur en la página principal

  13. Seleccionar Conservar cambios

    Condición de anulación de grupo de informes de Analytics

  14. En Acciones select Añadir

  15. Como el Extensión, seleccione SDK web de Adobe Experience Platform

  16. Como el Tipo de acción, seleccione Enviar evento

  17. Como el Datos XDM, seleccione la xdm.variable.content elemento de datos que ha creado en Creación de elementos de datos lección

  18. Como el Datos, seleccione la data.variable elemento de datos que ha creado en Creación de elementos de datos lección

    Anulación de flujo de datos de Analytics

  19. Desplácese hacia abajo hasta el Anulaciones de configuraciones de flujo de datos sección

  20. Deje el Desarrollo pestaña seleccionada.

    note tip
    TIP
    Esta pestaña determina en qué entorno de etiquetas se produce la anulación. Para este ejercicio, solo debe especificar el entorno de desarrollo, pero cuando implemente esto en producción, recuerde hacerlo también en Producción entorno.

  21. Seleccione el Sandbox que está utilizando para el tutorial

  22. Seleccione el Datastream, en este caso Luma Web SDK: Development Environment

  23. En Grupos de informes, seleccione el grupo de informes para el que desee anular la selección. En este caso, tmd-websdk-course-stg.

  24. Seleccionar Conservar cambios

  25. Y Guardar su regla

    Anulación de flujo de datos de Analytics

Cree su entorno de desarrollo

Añada las reglas actualizadas a su Luma Web SDK Tutorial y reconstruya su entorno de desarrollo.

¡Felicidades! El siguiente paso es validar la implementación de Adobe Analytics mediante el SDK web de Experience Platform.

Validar Adobe Analytics con Debugger

Obtenga información sobre cómo validar que Adobe Analytics está capturando el ECID, las vistas de página, la cadena de producto y los eventos de comercio electrónico con la función Edge Trace de Experience Platform Debugger.

En el Depurador En esta lección, ha aprendido a inspeccionar la solicitud XDM del lado del cliente con Platform Debugger y la consola de desarrollador del explorador, que es similar a cómo depurar un AppMeasurement.js Implementación de Analytics. También ha aprendido a validar las solicitudes del lado del servidor de Platform Edge Network enviadas a aplicaciones de Adobe y a ver una carga útil completamente procesada mediante Assurance.

Para validar que Analytics captura correctamente los datos mediante el SDK web de Experience Platform, debe ir dos pasos más allá para:

  1. Valide cómo procesa los datos el objeto XDM en el Edge Network de Platform mediante la función de seguimiento de Edge de Experience Platform Debugger
  2. Validar cómo Analytics procesa completamente los datos mediante Adobe Experience Platform Assurance

Validación de ID de Experience Cloud

  1. Vaya a la Sitio de demostración de Luma

  2. Seleccione el botón de inicio de sesión en la parte superior derecha y utilice las credenciales u: test@adobe.com p: test para autenticarse

  3. Abra Experience Platform Debugger y cambie la propiedad de etiquetas del sitio a su propia propiedad de desarrollo

  4. Para habilitar el seguimiento de Edge, vaya a Experience Platform Debugger, en el panel de navegación izquierdo, seleccione Registros, luego seleccione la Edge y seleccione. Connect

    Conectar seguimiento de Edge

  5. Estará vacío por ahora

    Seguimiento de Edge conectado

  6. Actualice la página de Luma y vuelva a comprobar Experience Platform Debugger. Debería ver los datos que llegan. La fila que empieza por Asignación automática de Analytics es la señalización de Adobe Analytics

  7. Seleccione para abrir ambos mappedQueryParams y la segunda lista desplegable para ver las variables de Analytics

    Seguimiento de Edge de señalizaciones de Analytics

    note tip
    TIP
    La segunda lista desplegable corresponde al ID del grupo de informes de Analytics al que está enviando los datos. Debe coincidir con su propio grupo de informes, no con el de la captura de pantalla.

  8. Desplazarse hacia abajo para buscar c.a.x.identitymap.ecid.[0].id. Es una variable de datos de contexto que captura el ECID

  9. Desplácese hacia abajo hasta que vea el informe de Analytics. mid variable. Ambos ID coinciden con el ID de Experience Cloud del dispositivo.

  10. En el sitio de Luma,

    Analytics ECID

    note note
    NOTE
    Como ha iniciado sesión, dedique un momento a validar el ID autenticado 112ca06ed53d3db37e4cea49cc45b71e para el usuario test@adobe.com también se captura en el c.a.x.identitymap.lumacrmid.[0].id

Validación de anulación de grupo de informes

Arriba configuró una anulación de secuencia de datos para el Página principal de Luma. Para validar esta configuración

  1. Busque una fila con Configuración de flujo de datos después de aplicar el reemplazo. Aquí encontrará el grupo de informes principal y los grupos de informes adicionales que se configuraron para las anulaciones del grupo de informes.

    Validación de lista de anulación de grupos de informes de Analytics

  2. Desplácese hacia abajo hasta la fila que comience por Asignación automática de Analytics y compruebe que la variable reportSuiteIds muestra el grupo de informes que especificó en las configuraciones de anulación

    Validación de llamada de anulación de grupo de informes de Analytics

Validación de vistas de página de contenido

Vaya a una página de producto como la Página de productos de Didi Sport Watch. Compruebe que Analytics captura las vistas de páginas de contenido.

  1. Buscar: c.a.x.web.webpagedetails.pageviews.value=1.

  2. Desplácese hacia abajo para ver el gn variable. Es la sintaxis dinámica de Analytics para s.pageName variable. Captura el nombre de página de la capa de datos.

    Cadena de producto de Analytics

Validación de eventos de cadena de producto y comercio electrónico

Dado que ya se encuentra en una página de producto, este ejercicio sigue utilizando el mismo seguimiento de Edge para validar que Analytics capture los datos del producto. Tanto la cadena de producto como los eventos de comercio electrónico se asignan automáticamente a variables XDM de Analytics. Siempre y cuando haya asignado a la aplicación adecuada productListItem Variable XDM al configuración de un esquema XDM para Adobe Analytics, el Edge Network de Platform se encarga de asignar los datos a las variables de análisis adecuadas.

En primer lugar, valide que la variable Product String se ha establecido

  1. Buscar: c.a.x.productlistitems.[0].sku. La variable captura el valor del elemento de datos asignado al productListItems.item1.sku anteriormente en esta lección

  2. Busque también. c.a.x.productlistitems.[0]._experience.analytics.customdimensions.evars.evar1. La variable captura el valor del elemento de datos asignado productListItems.item1._experience.analytics.customdimensions.evars.evar1

  3. Desplácese hacia abajo para ver el pl variable. Es la sintaxis dinámica de la variable de cadena de producto de Analytics

  4. Tenga en cuenta que el nombre del producto de la capa de datos está asignado tanto a la variable c.a.x.productlistitems.[0].sku y el product parámetro de la cadena de products. Además, el título de producto de la capa de datos se asigna a la evar1 de comercialización en la cadena de productos.

    Cadena de producto de Analytics

    El seguimiento de Edge trata commerce eventos de forma ligeramente diferente a productList dimensiones. No ve una variable de datos de contexto asignada de la misma manera que ve el nombre del producto asignado a c.a.x.productlistitem.[0].name arriba. En su lugar, el seguimiento de Edge muestra la asignación automática del evento final en Analytics event variable. El Edge Network de plataforma lo asigna en consecuencia, siempre y cuando se asigne al XDM adecuado commerce mientras que configuración del esquema para Adobe Analytics; en este caso, la variable commerce.productViews.value=1.

  5. Vuelva a la ventana de Experience Platform Debugger y desplácese hacia abajo hasta el events se establece en. prodView

  6. Tenga en cuenta también c.a.x.eventType se establece en commerce.productViews ya que se encuentra en una página de producto.

    note tip
    TIP
    El ecommerce - pdp library loaded - AA (order 20) La regla de sobrescribe el valor de eventType configurado por el all pages global content variables - library loaded - AA (order 1) regla tal como se establece en déclencheur más adelante en la secuencia

    Vista de producto de Analytics

Validar el resto de los eventos de comercio electrónico y las cadenas de producto establecidas para Analytics.

  1. Añadir Reloj Didi Sport al carro

  2. Vaya a la Página de carrito, compruebe el seguimiento de Edge para

    • eventType establezca en commerce.productListViews
    • events: "scView", y
    • se establece la cadena de producto

    Vista de carro de Analytics

  3. Continúe con el cierre de compra, compruebe el seguimiento de Edge para

    • eventType establezca en commerce.checkouts
    • events: "scCheckout", y
    • se establece la cadena de producto

    Cierre de Analytics

  4. Rellene solo el Nombre y Apellidos en el formulario de envío y seleccione Continuar. En la página siguiente, seleccione Realizar pedido

  5. En la página de confirmación, marque Rastro de Edge para

    • eventType establezca en commerce.purchases
    • Evento de compra configurado events: "purchase"
    • Variable de código de moneda establecida cc: "USD"
    • ID de compra configurado en pi
    • Cadena de producto pl definición del nombre, cantidad y precio del producto

    Compra de Analytics

Validar Adobe Analytics con Assurance

Adobe Experience Platform Assurance le ayuda a inspeccionar, probar, simular y validar la forma en que recopila datos o sirve las experiencias con su sitio web y aplicación móvil.

En el ejercicio anterior validó que Adobe Analytics está capturando el ECID, las vistas de página, la cadena de producto y los eventos de comercio electrónico con la función Edge Trace de Experience Platform Debugger. A continuación, valide esos mismos eventos mediante Adobe Experience Platform Assurance, una interfaz alternativa para acceder a los mismos datos en el seguimiento de Edge.

Como aprendió en el Assurance En esta lección, hay varias formas de iniciar una sesión de Assurance. Dado que ya tiene abierto el Adobe Experience Platform Debugger con una sesión de seguimiento de Edge iniciada desde el último ejercicio, le recomendamos que acceda a Assurance a través de Debugger:
Assurance mediante la recopilación de datos de Adobe Experience Platform

Dentro de "Tutorial 3 de SDK web" Centro de sesión de Assurance "hitdebugger" en la barra de búsqueda de eventos para filtrar los resultados a los datos posteriores al procesamiento de Adobe Analytics.
Datos posteriores al procesamiento de Assurance Adobe Analytics

Validación de ID de Experience Cloud

Para validar que Adobe Analytics está capturando el ECID, seleccione una señalización y abra la carga útil. El proveedor de esta señalización debe ser com.adobe.analytics.hitdebugger
Validación de Adobe Analytics con Assurance

Luego desplácese hacia abajo hasta mcvisId para validar que el ECID se captura correctamente
Validación de ID de Experience Cloud con Assurance

Validación de vistas de página de contenido

Con la misma señalización, compruebe que las vistas de página de contenido estén asignadas a la variable de Adobe Analytics correcta.
Desplácese hacia abajo hasta pageName para validar que la variable Page Name se captura correctamente
Validación del nombre de página con Assurance

Validación de eventos de cadena de producto y comercio electrónico

Siguiendo los mismos casos de uso de validación utilizados al validar con Experience Platform Debugger anteriormente, siga utilizando la misma señalización para validar el Ecommerce Events y el Product String.

  1. Busque la carga útil en la que eventos contain prodView
    Validación de cadenas de producto con Assurance
  2. Desplácese hacia abajo hasta product-string para validar el Product String.
    • Tenga en cuenta Product SKU y Merchandizing eVar1.
  3. Desplácese hacia abajo y valide que prop1, que configuró con reglas de procesamiento en la sección anterior, contiene el Product SKU
    Cadena de producto con validación de variables de comercialización con Assurance

Siga validando la implementación revisando el carro de compras, el cierre de compra y los eventos de compra.

  1. Busque la carga útil en la que eventos contain scView y valide la cadena de producto.
    Validación de cadenas de producto con Assurance
  2. Busque la carga útil en la que eventos contain scCheckout y valide la cadena de producto.
    Validación de cadenas de producto con Assurance
  3. Busque la carga útil en la que eventos contain purchase
    Validación de cadenas de producto con Assurance
  4. Al validar el purchase evento, tenga en cuenta que la variable Product String debe contener el Product SKU, Product Quantity , y Product Total Price.
  5. Además, para el purchase validar que la variable purchase-id y/o purchaseId están configuradas

¡Felicidades! ¡Tú lo hiciste! Este es el final de la lección y ahora está listo para implementar Adobe Analytics con el SDK web de Platform para su propio sitio web.

Siguiente:

NOTE
Gracias por dedicar su tiempo a conocer el SDK web de Adobe Experience Platform. Si tiene preguntas, desea compartir comentarios generales o tiene sugerencias sobre contenido futuro, compártalas en este Entrada de discusión de la comunidad Experience League
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4