Actualizar el biblioteca de recopilación de datos para Audience Manager de AppMeasurement al SDK web
Previsto audiencia intended-audience
Este Página es para clientes Audience Manager y Adobe Analytics que utilizan el biblioteca JavaScript AppMeasurement para enviar datos web a Audience Manager.
Consulte la tabla siguiente para obtener instrucciones sobre los pasos de migración al SDK web, en función de su método de recopilación de datos actual.
Información general sobre migración overview
La migración desde al AppMeasurementSDK web es principalmente una migración Adobe Analytics. Para Audience Manager clientes, esta migración también incluye Audience Manager. Ambos deben migrarse juntos. Si trabaja principalmente con Audience Manager, asegúrese de involucrar a los Analytics equipo en esta migración.
Si usa AppMeasurement para Audience Manager recopilación de datos, actualmente está utilizando el Server-side Forwarding (SSF) enfoque para enviar datos de Analytics a Audience Manager. En esta configuración, el solicitud recopilación de datos Analytics se reenvía a Audience Manager, que también gestiona la respuesta Audience Manager al Página.
Este ha sido el enfoque estándar durante muchos años y es probable que sea su configuración actual. Si el AppMeasurement biblioteca contiene la AudienceManagement módulo y las llamadas al recopilación de datos incluyen la ruta en /10/ la solicitud (/b/ss/examplereportsuite/10/), esta guía es para usted.
Flujos de datos de SDK web frente a reenvío de servidor (SSF) data-flows
Conocer las diferencias de flujo de datos entre Analytics y Audience Manager al migrar al SDK web (y a la red perimetral) es crucial para las instrucciones que se indican a continuación.
Con del lado del servidor reenvío, el Analytics recopilación de datos regional nodo recopila los datos, los transforma en una señal aceptada por Audience Manager, los envía a Audience Manager y devuelve la respuesta Audience Manager al Página. A AudienceManagement continuación, la módulo del AppMeasurement biblioteca gestiona la respuesta (p. ej., soltar cookies o enviar URL destinos). Este proceso se denomina reenvío del lado del servidor porque Analytics reenvía los datos a Audience Manager utilizando servidores Adobe Systems.
Con el SDK web, la red perimetral envía datos a Analytics y Audience Manager en acciones independientes. El SDK web es un biblioteca único que envía datos a todas las soluciones y la red perimetral transforma los puntos de datos independientes de la solución en formatos específicos de la solución.
En este nuevo flujo de datos, todos los datos se envían a un flujo de datos de redperimetral, que puede configurar para enviar datos a Adobe Systems soluciones según sea necesario. Por Audience Manager, la habilitación del servicio de Audience Manager en el flujo de datos transforma XDM y Analytics los datos en señales aceptadas por Audience Manager. La red perimetral también devuelve la respuesta Audience Manager al Página, donde el SDK web administra la respuesta, de forma similar a cómo AppMeasurement y lo hizo el AudienceManagement módulo.
Migración de etiquetas frente a migración sin etiquetas tags-vs-non-tags
Tanto si utiliza etiquetas con la AppMeasurement extensión, la AppMeasurement biblioteca en otro sistema administración de etiquetas o la coloca AppMeasurement directamente en el Página, los pasos para migrar Audience Manager al SDK web son los mismos. Dado que la migración de Audience Manager depende de la migración de Analytics, los pasos para migrar desde al SDK web se determinan durante la migración de AppMeasurement Analytics.
Esa información se trata en la documentación Analytics para etiquetas o implementaciones basadas en JavaScript.
XDM y los data.__adobe. nodos xdm-data-nodes
Una de las funciones principales del SDK web es enviar datos a Real-Time Customer Data Platform (RTCDP). Para lograr esto y seguir recopilando datos para otras Soluciones Experience Cloud sin una implementación completa, los datos específicos de la solución se compartimentan dentro de la recopilación de datos llamada al servidor. Esta llamada utiliza un esquema JSON estandarizado denominado Modelo de datos de experiencia (XDM)
Los elementos independientes de la solución, como la información sobre el explorador y el dispositivos, se envían a la red de Edge en una estructura XDM predeterminada. La red perimetral transforma estos datos en formatos específicos de la solución. Sin embargo, los datos específicos de Target, Analytics y Audience Manager se almacenan en un nodo dedicado data.__adobe dentro de la carga útil XDM.
Por ejemplo:
- El variable Analytics
s.eVar1se representa en la carga útil XDM comodata.__adobe.analytics.evar1. - Un parámetro Target relacionado con Lealtad del cliente estado se almacena como
data.__adobe.target.loyaltyStatus.
Los datos del __adobe nodo se envían a las soluciones respectivas (gustar Analytics y Audience Manager) sin enviarse a Experience Platform, igualado si el servicio Experience Platform está habilitado en el flujo de datos. Esto significa que puede mantener sus configuraciones actuales para Analytics y Audience Manager mientras tiene la flexibilidad de asignar los elementos de datos necesarios a los elementos de esquema XDM para casos de uso en tiempo real en Experience Platform utilizando Data Prep for Data Collection.
Por ejemplo, la cadena Analytics s.products , que se utiliza para informar sobre el contenido de carro de compras durante el cierre de compra, todavía se puede enviar a Analytics y Audience Manager en su formato original. Al mismo tiempo, puede utilizar los elementos de esta cadena para crear esquemas de carro de compras XDM más intuitivos para casos de uso Experience Platform.
Dado que la mayoría de las implementaciones de Audience Manager dependen de Analytics datos reenviados a Audience Manager, es probable que muchas de las expresiones de rasgos Audience Manager se basen en Analytics variables (c_evar#, c_prop#, y c_events). Para evitar reconstruir expresiones de rasgos con formatos XDM durante la migración, la red perimetral está configurada de forma predeterminada para transformar cualquier variable Analytics que se encuentre en el data.__adobe.analytics nodo en señales Audience Manager. Un proceso de transformación similar ocurre en el flujo de trabajo de reenvío de del lado del servidor.
La red perimetral puede realizar esta transformación porque una sola llamada de recopilación de datos desde el Página se envía a un único flujo de datos que alimenta varias soluciones de Adobe Systems. Por lo tanto, la mayoría de las migraciones desde AppMeasurement al SDK web, tanto para Analytics como para Audience Manager, utilizarán principalmente el data.__adobe.analytics nodo.
La red perimetral transforma los datos de dispositivos y explorador de la carga útil XDM y los encabezados de paquetes en señales Audience Manager. Esto le permite seguir usando y h_ claves d_ de plataforma en Audience Manager expresiones de rasgos.
El data.__adobe.audiencemanager nodo data-note
El data.__adobe.audiencemanager nodo se utiliza para implementaciones Audience Manager que no dependen de Analytics. Almacena pares personalizados clave/valor Audience Manager que se enviaban previamente a través del biblioteca DIL biblioteca , como se describe en el guía de migración de extensiones de etiqueta.
Si bien la data.__adobe.audiencemanager nodo no es necesaria para la migración descrita en este guía, el nuevo flujo de datos que se explica aquí permite que los datos se envíen a Audience Manager sin registrarse en Analytics.
Si necesita enviar un par clave/valor personalizado a Audience Manager sin incluirlo en Analytics, puede usar el data.__adobe.audiencemanager nodo. Todos los conjuntos de datos de este nodo se anexarán a los datos de Analytics transformados en Audience Manager en el llamada al servidor de recopilación de datos.
Ventajas y desventajas de esta ruta de implementación
El uso de este enfoque de migración tiene ventajas y desventajas. Sopese cuidadosamente cada opción para decidir qué enfoque es mejor para su organización.
- Utiliza sus implementación existentes: Aunque este enfoque requiere algunos cambios implementación, no requiere una implementación completamente nueva desde cero. Puede usar el código y la capa de datos existentes con cambios mínimos en implementación lógica.
- No necesita un esquema: para este fase de migración al SDK web, no necesita un esquema XDM. En su lugar, puede rellenar el
dataobjeto, que envía los datos directamente a Audience Manager. Una vez completada la migración al SDK web, puede crear un esquema para su organización y utilizar la asignación de secuencias de datos para rellenar los campos XDM aplicables. Si se necesitara un esquema en este fase del proceso de migración, su organización se vería obligada a utilizar un esquema XDM Audience Manager. El uso de este esquema hace que sea más difícil para su organización utilizar sus propios esquema en el futuro.
- Deuda técnica de implementación: Dado que este enfoque utiliza una forma modificada de su implementación existente, puede ser más difícil rastrear implementación lógica y realizar cambios en el futuro cuando sea necesario.
- Requiere asignación para enviar datos a Platform: Cuando su organización esté lista para usar CDP en tiempo real, debe enviar datos a un conjunto de datos en Adobe Experience Platform. Esta acción requiere que cada campo del
dataobjeto sea una entrada en el herramienta de asignación del flujo de datos que lo asigna a un campo de esquema XDM. Para este flujo de trabajo, el mapeo solo debe realizarse una vez, y no implica realizar cambios implementación. Sin embargo, es un paso adicional que no es necesario al enviar datos en un objeto XDM.
Adobe Systems recomienda seguir esta ruta de implementación en los siguientes escenarios:
- Ya tiene un implementación que utiliza el biblioteca JavaScript Adobe Analytics AppMeasurement. Si tiene un implementación que usa la extensión de etiqueta de Audience Manager, seguir migre de la extensión de etiqueta de Audience Manager a la extensión de etiqueta del SDK web.
- Tiene intención de utilizar CDP en tiempo real en el futuro, pero no desea reemplazar su implementación de Audience Manager por un implementación de SDK web desde cero. La alternativa de reemplazar su implementación desde cero con el SDK web requiere el mayor esfuerzo, ya que necesita reconstruir todos sus rasgos Audience Manager para buscar datos con formato XDM. Sin embargo, también es la arquitectura implementación a largo plazo más viable. Si su organización está dispuesta a realizar el esfuerzo de una implementación de SDK web limpia, consulte la documentación del SDK web en lugar de usar este guía para obtener más información.
Pasos necesarios para migrar al SDK web
Siga los pasos que se indican a continuación para migrar la integración de recopilación de datos al SDK web.
añadir el servicio Audience Manager al flujo de datos que está utilizando en la migración de Analytics mencionada en el paso 1.
-
Navegue hasta experience.adobe.com e inicie sesión con sus credenciales.
-
Utilice el selector página de inicio o producto de la parte superior derecha para desplazarse hasta Data Collection.
-
En el navegación izquierdo, seleccione Datastreams.
-
Seleccione el flujo de datos que ha creado como parte de la migración de Analytics en el paso 1.
-
Seleccione Add Service.
-
En el menú desplegable de servicio, seleccione Audience Manager.
-
Compruebe las Cookie Destinations Enabled opciones y URL Destinations Enabled . Estas opciones permiten que la red perimetral devuelva esos tipos de destino Audience Manager al Página.
-
Asegúrese de que Enable XDM Flattened Fields esté deshabilitado. Esta opción deshabilita el transformación automático de variables Analytics en señales de Audience Manager. Esta opción está diseñada para mantener la compatibilidad con versiones anteriores para los usuarios que migraron al SDK web antes de que la red perimetral transformara automáticamente los datos de Analytics en señales Audience Manager.
note note NOTE La migración al SDK web con la Enabled XDM Flattened Fields opción activada requiere que todos los datos necesarios en Audience Manager formateen como XDM y que todas las características Audience Manager que utilizan props, eVars o eventos se actualicen para buscar datos con formato XDM. Adobe Systems recomienda dejar esta opción desactivada. 
-
Seleccione Save esta opción para guardar la configuración del flujo de datos.
El flujo de datos ya está listo para recibir y pasar datos a Audience Manager. Tenga en cuenta el ID del flujo de datos, ya que este ID es necesario al configurar el SDK web en código.
-
Navegue hasta experience.adobe.com e inicie sesión con sus credenciales.
-
Utilice el selector página de inicio o producto de la parte superior derecha para desplazarse hasta Data Collection.
-
En el navegación izquierdo, seleccione Datastreams.
-
Seleccione el flujo de datos que ha creado como parte de la migración de Analytics en el paso 1.
-
Seleccione Edit esta opción en la esquina superior derecha del Página de configuración del flujo de datos.
-
Expanda el Advanced Options menú desplegable y habilite la Third Party ID Sync funcionalidad si aún no está habilitada. Esta opción indica a la red perimetral que devuelva las sincronizaciones de ID de socio para socios de datos Audience Manager y Experience Platform.
-
En la mayoría de los casos, puede dejar el Third Party ID Sync Container ID campo en blanco. Se establecerá de forma predeterminada en
0. Sin embargo, si prefiere asegurarse de que se utiliza el ID de contenedor correcto, seguir los siguientes pasos:- Abra una ventana del explorador en modo incógnito o privado y navegue hasta una Página que forme parte de la migración.
- Utilice las herramientas de desarrollo de la explorador para filtrar por la llamada de red a
dpm.demdex.net/id. Esta llamada solo se activará en la primera Página de una primera visita, por lo que se necesita una explorador de incógnito o privada. - Ver la carga útil del solicitud. Si el
d_nsidparámetro es distinto de cero, cópielo en el Third Party ID Sync Container ID campo.
-
Seleccione Save.
El flujo de datos ya está listo para enviar datos a Audience Manager y pasar las respuestas Audience Manager al SDK web.
La mayoría de las implementaciones de Audience Manager usan reglas de combinación de perfiles en escenarios de personalización dispositivos y para ayudar a controlar para qué segmentos pueden calificar los visitantes según su estado de autenticación (sesión o desconexión). Las reglas de combinación de perfiles requieren que se envíe un identificador propiedad del cliente (ID de CRM, número de cuenta, etc.) al Audience Manager en cada llamada recopilación de datos después de la autenticación. Anteriormente, la setCustomerIDs función del Servicio de ID de visitante (visitor.js) se utilizaba para anexar ID de cliente a cada Analytics recopilación de datos llamada, que luego se reenviaba a Audience Manager.
Con el SDK web, estas identidades ahora deben enviarse a la red perimetral mediante una construcción XDM especial denominada IdentityMap.
Pasar identidades correctamente en un mapa de identidad requiere comprender los espacios de nombres de identidad y considerar cuidadosamente qué identidades pasar, especialmente cuando se envían datos a un Experience Platform sandbox. Este artículo describe estas consideraciones e instrucciones.
Una vez que determine qué identidades transferir y cuándo, seguir las guías para usar el elementoIdentity map de datos dentro de Identity map 🔗 Etiquetas o configúrelo manualmente como se describe en la información general dedatos de identidad para alinearlo con su estrategia de implementación del SDK web.
aam_uuidUna práctica estándar durante muchos años fue colocar el Audience Manager UUID (el valor en el cookie demdex de 3rd party) en un cookie de origen generalmente llamado aam_uuid.
Para establecer el cookie, debe introducir un nombre de cookie en el Name campo de la Unique User ID Cookie sección del Analytics etiqueta extensión o el uuidCookie campo al configurar el audienceManagementModule. Aunque normalmente se configura en el código, el cookie rara vez se usaba porque el valor UUID Audience Manager es un identificador entre dominios específico de dispositivos utilizado por plataformas publicitarias y proporciona poco valor como identificador de origen.
Si encuentra que su implementación requiere que este aam_uuid cookie se siga configurando después de la migración al SDK web, puede recuperar el UUID de Audience Manager de dos maneras.
-
Cada respuesta del extremo de interacción dered perimetral contiene una carga útil con
idnodos. Laidnodo de laCOREcarga útil del espacio de nombres contiene el UUID Audience Manager. -
Utilice el comando getIdentity del SDK web para recuperarlo. Utilice el
COREespacio de nombres como se describe en la documentación y recupere el valor delidentity.COREcampo en la respuesta.
Independientemente del método utilizado para recuperar el UUID Audience Manager, depende de su equipo de desarrollo analizar la respuesta, recuperar el UUID y establecer el cookie. No existe ninguna forma automática de establecer este cookie a través del SDK web.
Configurar el reenvío del lado del servidor y la Analytics de audiencia en el Administrador de grupos de informes de Analytics IU configure-ssf-analytics
Si está familiarizado con la función de reenvío de del lado del servidor Analytics, es posible que se pregunte: "¿Debo deshabilitar la configuración de reenvío de del lado del servidor en el Administrador de grupos de informes de Analytics IU para evitar enviar datos de Analytics a Audience Manager dos veces?".
La respuesta es no, no debe desactivar esta configuración, por las siguientes razones:
-
Cuando el servicio Audience Manager está habilitado en un flujo de datos, la red perimetral anexa el
cm.ssfvariable a todas las solicitudes de recopilación de datos enviadas a Analytics. Esto evita que los datos del Analytics también se envíen a Audience Manager. Todos los registros de garantía utilizados para validar la migración de Analytics mostrarán lacm.ssf=1variable cuando el servicio de Audience Manager esté habilitado en el flujo de datos. Consulte el Página de cumplimiento de Analytics y RGPD centrado en el reenvío de del lado del servidor para obtener más detalles. -
Esta configuración también habilita el flujo de datos para la Audience Analytics integración. Tal y como se describe en la descripción general de la Analytics de audiencia, se requiere del lado del servidor reenvío para esta integración, ya que la respuesta Audience Manager al servidor recopilación de datos de Analytics se añade al Analytics Visita antes de procesar. Un proceso similar ocurre dentro de la red de Edge. Cuando del lado del servidor reenvío está habilitado, la red perimetral agrega los segmentos necesarios de la respuesta Audience Manager a los datos enviados a Analytics.
En resumen, es importante que esta configuración permanezca habilitada para que Audience Analytics siga funcionando con un implementación de SDK web y no se cuente doble datos en Audience Manager.
Validación de la migración validation
Dado que todas las Adobe Systems soluciones ahora cuentan con una única llamada al SDK web, los pasos para validación pueden cambiar en función de las soluciones que ofrezca el SDK web.
Si Adobe Target o Adobe Systems Journey Optimizer (incluido Decisioning) forman parte de la pila de soluciones a la que presta servicio su implementación, tendrá varias llamadas de red a la red perimetral en el Página. Algunos de ellos están pensados para recuperar personalizaciones y ofertas, mientras que otros están pensados para recopilación de datos y sistema de informes.
Independientemente de su implementación, se aplican los principios generales siguientes para validar que los datos fluyan correctamente hacia y desde Audience Manager a través del SDK web.
-
La primera llamada de red para una visitante por primera Página será al
adobedc.demdex.netdominio y al/interactextremo. Para ver las llamadas de red realizadas por el SDK web, abra el pestaña de desarrollador del explorador web, haga clic en el pestaña Red y, a continuación, filtre por/interact.
Existen otros tipos de llamadas al SDK web, pero solointeractlas llamadas envían datos y obtienen una carga útil de respuesta de la red perimetral.
-
La respuesta a la primera llamada de red tiene varias cargas útiles. Uno de esos nodos de carga útil incluye varios subnodos de tipo
url. Estosurlnodos son las sincronizaciones de ID de terceros que históricamente fueron activadas por el Visitor ID servicio. Debe haber unurlnodo para cada sincronizar de ID de terceros que esté configurada en su contenedor (consulte el paso 3 anterior).
Además, puede filtrar y
demdexencontrar que cada una de las URL a las que se hace referencia en la carga útil activó su propia solicitud de red para la sincronización de ID tal gustar como lo hizo el Visitor ID servicio. Estas sincronizaciones de ID solo deben activarse la primera Página de una visitante por primera vez y solo una vez cada 14 días después de eso. -
Cualquier solicitud posterior
/interactutilizada para Analytics y Audience Manager recopilación de datos debe contener losdata.__adobe.analyticsnodos de la carga útil.
Audience Manager características que dependen de estas variables Analytics, así como las que usan las claves de plataforma
h_ORd_deben seguir rellenándose.note tip TIP Es posible que desee crear un rasgo prueba con un expresión regla que solo se pueda expresar si se recopilan los datos del SDK web. Dado que no hay desarrollo Audience Manager entorno y varios sitios podrían estar enviando datos a la misma instancia de Audience Manager, solo mirar los recuentos generales de la población puede no brindarle la validación necesaria. -
En la misma
/interactllamada donde se pasan Analytics variables, se puede encontrar cualquier destino cookie o URL en los nodos de carga útil de la respuesta. URL destinos estarán en cargas útiles de tipourl(solo gustar en sincronizaciones de ID de terceros) y cookie destinos estarán en cargas útiles de tipocookie.
También debe asegurarse de que las cookies se colocaron en el almacenamiento de cookie del explorador.
note tip TIP Al igual que en el paso validación anterior, calificar para una segmento que debe devolver un destino cookie es una forma segura de garantizar que los datos fluyan hacia y desde Audience Manager. -
Si necesita pasar ID de cliente adicionales a través del mapa de identidad, autentifíquese en el sitio y asegúrese de que las identidades y sus parámetros asociados se pasen en el nodo del mapa de identidad de la carga útil de solicitud.
note tip TIP Si Adobe Target es una de las soluciones receptoras y hay actividades Target que dependen de segmentos Audience Manager que requieren que se pase la identidad correcta, asegúrese de que el mapa de identidad se pasa en las /interactllamadas que se usan para recuperar personalizaciones y no solo en recopilación de datos llamadas. Adobe Target utilizará esas identidades en la llamada de del lado del servidor para Audience Manager al recuperar segmento información.