DocumentaciónAnalyticsGuía de implementación

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

Last update: Thu Apr 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • User
  • Admin

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 de SDK web: una instalación nueva del SDK web que utiliza 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 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 del 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 data en lugar del objeto xdm objeto para enviar datos al Adobe.
  • AppMeasurement a la biblioteca JavaScript del SDK web: un enfoque suave 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 reemplácelo por la biblioteca 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.

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 aplicables del SDK web.
  • Esquema predefinido: Si su organización no necesita su propio esquema, simplemente puede utilizar 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 en el sitio. El enfoque que utiliza la variable Extensión de etiqueta de SDK web evita esta desventaja.
  • Bloqueado en mediante un esquema específico: Cuando su organización se traslada a Customer Journey Analytics, debe elegir continuar utilizando 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 data objeto: El data 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 flujos de datos para asignar data campos de objeto a XDM. Tanto la Extensión de Analytics a SDK web y AppMeasurement a la biblioteca JavaScript del SDK web use esto data objeto.
    • 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.
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 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:

Implementar Adobe Analytics mediante el flujo de trabajo del SDK web 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
Configuración de 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
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 ( ).edgeConfigId)), id de organización (orgId) y otras opciones disponibles. Asegúrese de que la asignación de variables sea correcta.
Configuración del SDK web
Asignación de variables de objeto 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