Enviar datos a Adobe Analytics mediante la biblioteca JavaScript del SDK web

Última actualización: 5 de mayo de 2025

Creado para:

  • Usuario
  • Administrador

Esta ruta de implementación implica una nueva instalación del SDK web mediante la biblioteca JavaScript del SDK web. Otras rutas de implementación se tratan en páginas independientes:

  • Extensión de etiqueta del SDK web: Una instalación nueva del SDK web que usa la extensión de etiqueta del SDK web. Es similar al método de biblioteca JavaScript del SDK web (esta página), excepto que la implementación se administra mediante etiquetas en la recopilación de datos de Adobe Experience Platform. Requiere el grupo de campos Adobe Analytics ExperienceEvent, que incluye variables típicas de Analytics que se deben incluir en el esquema XDM.
  • Extensión de Analytics a la extensión de SDK web: adopte un enfoque suave y metódico para pasar de la extensión de etiquetas de Adobe Analytics a la extensión de etiquetas de SDK web. Este método suprime la necesidad de utilizar XDM hasta que su organización esté lista para utilizar los servicios de Adobe Experience Platform, como Customer Journey Analytics. Utilice el objeto data en lugar del objeto xdm para enviar datos al Adobe.
  • AppMeasurement a la biblioteca JavaScript del SDK web: Un enfoque sencillo y metódico para migrar al SDK web, excepto que no utiliza etiquetas. En su lugar, puede quitar manualmente la biblioteca de recopilación de datos de Adobe Analytics (AppMeasurement.js) y reemplazarla por la biblioteca de JavaScript del SDK web (alloy.js).

Ventajas y desventajas de esta ruta de implementación

El uso de la biblioteca JavaScript del SDK web para enviar datos a Adobe Analytics tiene ventajas y desventajas. Valore cuidadosamente cada opción para decidir qué enfoque es el mejor para su organización.

VentajasDesventajas
  • Enfoque directo: Esta ruta de implementación es más sencilla que los enfoques que mueven las implementaciones de Adobe Analytics existentes. Si no tiene una implementación de Adobe Analytics actual de la que preocuparse, rellene los campos XDM aplicables del SDK web.
  • Esquema predefinido: Si su organización no necesita su propio esquema, puede usar simplemente el esquema orientado a Adobe Analytics. Este concepto se aplica incluso cuando se mueve hacia Customer Journey Analytics; el concepto de props y eVars no se aplica a Customer Journey Analytics, pero puede seguir utilizando props y eVars como dimensiones personalizadas simples.
  • Los cambios de implementación requieren la intervención del desarrollador: Si desea realizar cambios en la implementación del SDK web, debe trabajar con el equipo de desarrollo para editar el código del sitio. El método que usa la extensión de etiqueta del SDK web evita esta desventaja.
  • Bloqueado en mediante un esquema específico: cuando su organización se traslade a Customer Journey Analytics, debe elegir continuar usando el esquema de Adobe Analytics o migrar al esquema de su propia organización (que sería un conjunto de datos independiente). Si su organización desea evitar el esquema de Adobe Analytics y la migración a un conjunto de datos independiente al pasar a Customer Journey Analytics, Adobe recomienda uno de los dos métodos siguientes:
    • Utilice el objeto data: El objeto data le permite enviar datos a Adobe Analytics sin ajustarse a un esquema XDM. Una vez creado el esquema de su organización, puede utilizar la asignación de secuencia de datos para asignar data campos de objeto a XDM. Tanto la extensión Analytics a la extensión del SDK web como el AppMeasurement a la biblioteca JavaScript del SDK web utilizan este objeto data.
    • Omitir Adobe Analytics por completo: si va a implementar el SDK web, puede enviar esos datos a un conjunto de datos en Adobe Experience Platform para su uso en Customer Journey Analytics. Puede utilizar cualquier esquema que desee; Adobe Analytics no participa en absoluto en este flujo de trabajo y, por lo tanto, no requiere el grupo de campos Adobe Analytics ExperienceEvent. Este método incurre en la menor cantidad de deuda técnica, pero también deja a Adobe Analytics fuera del panorama por completo.
IMPORTANTE
Este método de implementación requiere que utilice un esquema configurado para Adobe Analytics. Si su organización planea utilizar su propio esquema con Customer Journey Analytics en el futuro, el uso del esquema de Adobe Analytics puede crear confusión para los administradores de datos o los arquitectos. Existen varias opciones para mitigar este obstáculo:
  • Puede utilizar el esquema de Adobe Analytics en CJA. Tenga en cuenta que CJA no tiene un concepto de props o eVars; se tratan como cualquier otro campo de esquema. Tenga en cuenta también que el uso del esquema de Adobe Analytics en CJA puede dificultar el uso de otros servicios de plataforma, como Adobe Journey Optimizer o Real-time Customer Data Platform.
  • Puede utilizar el objeto de datos, de forma similar a un flujo de trabajo de migración. Tenga en cuenta que el uso del objeto de datos requiere que asigne cada campo de objeto de datos a un campo de esquema XDM.
  • Puede omitir la implementación de Adobe Analytics por completo y enviar datos a Adobe Experience Platform con su propio esquema. Este enfoque es ideal a largo plazo y permite a su organización empezar a utilizar Customer Journey Analytics.

Pasos necesarios para implementar la biblioteca JavaScript del SDK web

Una información general de alto nivel de las tareas de implementación:

Cómo implementar Adobe Analytics mediante el flujo de trabajo del SDK web, tal como se describe en esta sección.

TareaMás información
1Asegúrese de haber definido un grupo de informes.Administrador del grupo de informes
2Configurar esquemas. Para estandarizar la recopilación de datos para su uso en todas las aplicaciones que aprovechan Adobe Experience Platform, Adobe ha creado el estándar abierto y documentado públicamente, Experience Data Model (XDM).Resumen de IU de esquemas
3Creación de una capa de datos para administrar el seguimiento de los datos del sitio web.Creación de una capa de datos
4Instale la versión independiente precompilada. Puede hacer referencia a la biblioteca (alloy.js) en la red de distribución de contenido (CDN) directamente en su página, o bien, descargue y aloje en su propia infraestructura. Alternativamente, puede utilizar el paquete NPM.Instalación de la versión independiente precompilada y Uso del paquete NPM
5Configurar una secuencia de datos. Una secuencia de datos representa la configuración del lado del servidor al implementar los SDK web de Adobe Experience Platform.Configurar una secuencia de datos
6Agregar un servicio de Adobe Analytics a su secuencia de datos. Este servicio controla si los datos se envían a Adobe Analytics y cómo, y a qué grupo o grupos de informes se envían específicamente.Agregar el servicio Adobe Analytics a una secuencia de datos
7Configurar el SDK web. Asegúrese de que la biblioteca que instaló en el paso 4 esté configurada correctamente con el ID de secuencia de datos (anteriormente conocido como id. de configuración de Edge (datastreamId)), id. de organización (orgId) y otras opciones disponibles. Asegúrese de que la asignación de variables sea correcta.Configurar el SDK web
Asignación de variables de objetos XDM
8Ejecutar comandos o seguimiento de eventos. Una vez implementado el código base en la página web, puede empezar a ejecutar comandos y rastrear eventos con el SDK.Envío de eventos
9Ampliación y validación de la implementación antes de llevarlo a producción.
recommendation-more-help