DocumentaciónAnalyticsGuía de implementación

Enviar datos a Adobe Analytics mediante la biblioteca JavaScript de Web SDK

Last update: Fri Sep 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Usuario
  • Administrador

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

  • Extensión de etiquetas Web SDK: Una instalación nueva de Web SDK con la extensión de etiquetas Web SDK. Es similar al método de biblioteca JavaScript de Web SDK (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 a Adobe.
  • Biblioteca JavaScript de AppMeasurement a Web SDK: Un enfoque sencillo y metódico para migrar a Web SDK, 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 de Web SDK (alloy.js).

Ventajas y desventajas de esta ruta de implementación

El uso de la biblioteca JavaScript de Web SDK 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.

Ventajas
Desventajas
  • 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 de Web SDK aplicables.
  • 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 de Web SDK, debe trabajar con el equipo de desarrollo para editar el código en el sitio. El método que usa la extensión de etiquetas Web SDK 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 Web SDK como AppMeasurement a la biblioteca de JavaScript de Web SDK utilizan este objeto data.
    • Omitir Adobe Analytics por completo: si va a implementar Web SDK, puede enviar esos datos a un conjunto de datos en Adobe Experience Platform para utilizarlos 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.
IMPORTANT
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 administradores o arquitectos de datos. 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 de Web SDK

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

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

Tarea
Más información
1
Asegúrese de haber definido un grupo de informes.
Administrador del grupo de informes
2
Configurar 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, Modelo de datos de experiencia (XDM).
Resumen de IU de esquemas
3
Creación de una capa de datos para administrar el seguimiento de los datos del sitio web.
Creación de una capa de datos
4
Instale 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
5
Configurar 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
6
Agregar 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
7
Configurar 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 Web SDK
Asignación de variables de objetos XDM
8
Ejecutar 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
9
Ampliación y validación de la implementación antes de llevarlo a producción.
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690