Actualizar la biblioteca de recopilación de datos para Audience Manager de AppMeasurement a Web SDK
Destinatarios previstos intended-audience
Esta página es para clientes de Audience Manager y Adobe Analytics que usan la biblioteca de JavaScript AppMeasurement para enviar datos web a Audience Manager.
Consulte la tabla siguiente para obtener instrucciones sobre los pasos de migración a Web SDK, según el método de recopilación de datos actual.
Información general sobre migración overview
La migración de AppMeasurement a Web SDK es principalmente una migración de Adobe Analytics. Para los clientes de Audience Manager, esta migración también incluye Audience Manager. Ambos deben migrarse juntos. Si trabaja principalmente con Audience Manager, asegúrese de implicar al equipo de Analytics en esta migración.
Si usa AppMeasurement para la recopilación de datos de Audience Manager, actualmente está usando el método Server-side Forwarding (SSF) para enviar datos de Analytics a Audience Manager. Con esta configuración, la solicitud de recopilación de datos de Analytics se reenvía a Audience Manager, que también gestiona la respuesta de Audience Manager a la página.
Este ha sido el enfoque estándar durante muchos años y es probable que sea su configuración actual. Si la biblioteca AppMeasurement contiene el módulo AudienceManagement y las llamadas de recopilación de datos incluyen la ruta de acceso /10/ en la solicitud (/b/ss/examplereportsuite/10/), esta guía es para usted.
Reenvío del lado del servidor (SSF) frente a flujos de datos de Web SDK data-flows
Comprender las diferencias del flujo de datos entre Analytics y Audience Manager al pasar a Web SDK (y Edge Network) es crucial para las instrucciones siguientes.
Con el reenvío del lado del servidor, el nodo de recopilación de datos regionales de Analytics recopila los datos, los transforma en una señal aceptada por Audience Manager, los envía a Audience Manager y devuelve la respuesta de Audience Manager a la página. A continuación, el módulo AudienceManagement de la biblioteca AppMeasurement se encarga de la respuesta (por ejemplo, soltar cookies y enviar destinos de URL). Este proceso se denomina reenvío del lado del servidor porque Analytics reenvía los datos a Audience Manager mediante los servidores de Adobe.
Con Web SDK, Edge Network envía datos a Analytics y Audience Manager en acciones independientes. Web SDK es una biblioteca única que envía datos a todas las soluciones y Edge Network transforma los puntos de datos no relacionados con las soluciones en formatos específicos de las soluciones.
En este nuevo flujo de datos, todos los datos se envían a un conjunto de datos de Edge Network, que puede configurar para enviar datos a las soluciones de Adobe según sea necesario. Para Audience Manager, habilitar el servicio Audience Manager en el conjunto de datos transforma los datos de XDM y Analytics en señales aceptadas por Audience Manager. Edge Network también devuelve la respuesta de Audience Manager a la página, donde Web SDK administra la respuesta, de forma similar a como lo hicieron AppMeasurement y el módulo AudienceManagement.
Migración de etiquetas frente a no etiquetas tags-vs-non-tags
Tanto si está utilizando etiquetas con la extensión AppMeasurement, la biblioteca AppMeasurement en otro sistema de administración de etiquetas como si está colocando AppMeasurement directamente en la página, los pasos para migrar Audience Manager a Web SDK son los mismos. Dado que la migración de Audience Manager depende de la migración de Analytics, los pasos para migrar de AppMeasurement a Web SDK se determinan durante la migración de Analytics.
Esa información se explica en la documentación de Analytics para implementaciones basadas en Tags o JavaScript.
XDM y los nodos data.__adobe. xdm-data-nodes
Una de las funciones principales de Web SDK es enviar datos a Real-Time Customer Data Platform (RTCDP). Para conseguirlo y seguir recopilando datos para otras soluciones de Experience Cloud sin una reimplementación completa, los datos específicos de la solución se dividen en compartimentos dentro de la llamada al servidor de recopilación de datos. Esta llamada usa un esquema JSON estandarizado denominado Experience Data Model (XDM)
Los elementos no relacionados con las soluciones, como la información sobre el explorador y el dispositivo, se envían a Edge Network en una estructura XDM predeterminada. Edge Network transforma estos datos en formatos específicos de cada solución. Sin embargo, los datos específicos de Target, Analytics y Audience Manager se almacenan en un nodo data.__adobe específico dentro de la carga útil XDM.
Por ejemplo:
- La variable de Analytics
s.eVar1se representa en la carga útil XDM comodata.__adobe.analytics.evar1. - Un parámetro de Target relacionado con el estado de lealtad del cliente se almacena como
data.__adobe.target.loyaltyStatus.
Los datos del nodo __adobe se envían a las soluciones respectivas (como Analytics y Audience Manager) sin enviarse a Experience Platform, aunque el servicio de Experience Platform esté habilitado en la secuencia de datos. Esto significa que puede mantener las configuraciones actuales para Analytics y Audience Manager, al tiempo que tiene la flexibilidad de asignar los elementos de datos necesarios a elementos de esquema XDM para casos de uso en tiempo real en Experience Platform mediante Preparación de datos para la recopilación de datos.
Por ejemplo, la cadena s.products de Analytics, que se usa para informar del contenido del carro de compras durante el cierre de compra, 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 XDM más intuitivos para los casos de uso de Experience Platform.
Dado que la mayoría de las implementaciones de Audience Manager dependen de los datos de Analytics reenviados a Audience Manager, muchas de las expresiones de rasgos de Audience Manager probablemente se basen en variables de Analytics (c_evar#, c_prop# y c_events). Para evitar la reconstrucción de expresiones de rasgos mediante formatos XDM durante la migración, Edge Network está configurado de forma predeterminada para transformar cualquier variable de Analytics que se encuentre en el nodo data.__adobe.analytics en señales de Audience Manager. Un proceso de transformación similar se produce en el flujo de trabajo de reenvío del lado del servidor.
Edge Network puede realizar esta transformación porque se envía una sola llamada de recopilación de datos desde la página a un único conjunto de datos que alimenta varias soluciones de Adobe. Por lo tanto, la mayoría de las migraciones de AppMeasurement a Web SDK tanto para Analytics como para Audience Manager utilizarán principalmente el nodo data.__adobe.analytics.
Edge Network transforma los datos de dispositivos y exploradores de la carga útil XDM y los encabezados de paquetes en señales de Audience Manager. Esto le permite seguir utilizando h_ y d_ claves de plataforma en expresiones de rasgos de Audience Manager.
El nodo data.__adobe.audiencemanager data-note
El nodo data.__adobe.audiencemanager se usa para implementaciones de Audience Manager que no dependen de Analytics. Almacena pares de clave/valor Audience Manager personalizados que se enviaron anteriormente a través de la biblioteca DIL, tal como se describe en la guía de migración de la extensión de etiquetas.
Aunque el nodo data.__adobe.audiencemanager no es necesario para la migración descrita en esta guía, el nuevo flujo de datos que se explica aquí permite enviar datos a Audience Manager sin que se registren en Analytics.
Si necesita enviar un par clave/valor personalizado a Audience Manager sin incluirlo en Analytics, puede utilizar el nodo data.__adobe.audiencemanager. Cualquier conjunto de datos de este nodo se anexará a los datos de Analytics transformados por Audience Manager en la 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. Valore cuidadosamente cada opción para decidir qué enfoque es el mejor para su organización.
- Utiliza su implementación existente: Aunque este enfoque requiere algunos cambios de implementación, no requiere una implementación completamente nueva desde cero. Puede utilizar la capa de datos y el código existentes con cambios mínimos en la lógica de implementación.
- No requiere un esquema: Para esta fase de migración a Web SDK, no necesita un esquema XDM. En su lugar, puede rellenar el objeto
data, que envía datos directamente a Audience Manager. Una vez completada la migración a Web SDK, puede crear un esquema para su organización y utilizar la asignación de flujos de datos para rellenar los campos XDM aplicables. Si se requiere un esquema en esta fase del proceso de migración, su organización se vería obligada a utilizar un esquema XDM de Audience Manager. El uso de este esquema dificulta que su organización utilice su propio esquema en el futuro.
- Deuda técnica de la implementación: dado que este método usa una forma modificada de la implementación existente, puede ser más difícil rastrear la lógica de la implementación y realizar cambios en el futuro cuando sea necesario.
- Requiere asignación para enviar datos a la plataforma: cuando su organización esté lista para usar Real-Time CDP, debe enviar datos a un conjunto de datos en Adobe Experience Platform. Esta acción requiere que cada campo del objeto
datasea una entrada en la herramienta de asignación de secuencia de datos que lo asigne a un campo de esquema XDM. La asignación solo debe realizarse una vez para este flujo de trabajo y no implica realizar cambios de implementación. Sin embargo, es un paso adicional que no es necesario al enviar datos en un objeto XDM.
Adobe recomienda seguir esta ruta de implementación en los siguientes casos:
- Tiene una implementación existente de mediante la biblioteca JavaScript de Adobe Analytics AppMeasurement. Si tiene una implementación con la extensión de etiquetas de Audience Manager, siga Migrar de la extensión de etiquetas de Audience Manager a la extensión de etiquetas de Web SDK en su lugar.
- Tiene intención de utilizar Real-Time CDP en el futuro, pero no desea reemplazar la implementación de Audience Manager con una implementación de Web SDK desde cero. La alternativa de reemplazar la implementación desde cero con Web SDK requiere el mayor esfuerzo, ya que necesita reconstruir todos los rasgos de Audience Manager para buscar datos con formato XDM. Sin embargo, también es la arquitectura de implementación a largo plazo más viable. Si su organización desea realizar el esfuerzo de una implementación limpia de Web SDK, consulte la Documentación de Web SDK en lugar de esta guía para obtener más detalles.
Pasos necesarios para migrar a Web SDK
Siga los pasos a continuación para migrar la integración de recopilación de datos a Web SDK.
Añada el servicio Audience Manager al conjunto de datos que está utilizando en la migración de Analytics mencionada en el paso 1.
-
Vaya a experience.adobe.com e inicie sesión con sus credenciales.
-
Utilice la página de inicio o el selector de producto en la parte superior derecha para navegar a Data Collection.
-
En el panel de navegación izquierdo, seleccione Datastreams.
-
Seleccione el conjunto de datos que creó como parte de la migración de Analytics en el paso 1.
-
Seleccione Add Service.
-
En el menú desplegable del servicio, seleccione Audience Manager.
-
Compruebe las opciones Cookie Destinations Enabled y URL Destinations Enabled. Estas opciones permiten a Edge Network devolver esos tipos de destinos de Audience Manager a la página.
-
Asegúrese de que Enable XDM Flattened Fields esté deshabilitado. Esta opción deshabilita la transformación automática de variables de 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 a Web SDK antes de que Edge Network transformara automáticamente los datos de Analytics en señales de Audience Manager.
note NOTE La migración a Web SDK con la opción Enabled XDM Flattened Fields habilitada requiere que todos los datos necesarios en Audience Manager con formato XDM y todas las características de Audience Manager que utilizan props, eVars o eventos se actualicen para buscar datos con formato XDM en su lugar. Adobe recomienda dejar esta opción desactivada. -
Seleccione Save para guardar la configuración de la secuencia de datos.
El conjunto de datos ya está listo para recibir y pasar datos a Audience Manager. Tenga en cuenta el ID de la secuencia de datos, ya que este ID es necesario al configurar Web SDK en el código.
-
Vaya a experience.adobe.com e inicie sesión con sus credenciales.
-
Utilice la página de inicio o el selector de producto en la parte superior derecha para navegar a Data Collection.
-
En el panel de navegación izquierdo, seleccione Datastreams.
-
Seleccione el conjunto de datos que creó como parte de la migración de Analytics en el paso 1.
-
Seleccione Edit en la esquina superior derecha de la página de configuración de la secuencia de datos.
-
Expanda el menú desplegable Advanced Options y habilite la funcionalidad Third Party ID Sync si aún no está habilitada. Esta opción indica a Edge Network que devuelva las sincronizaciones de ID de socio para los socios de datos de Audience Manager y Experience Platform.
-
En la mayoría de los casos, puede dejar en blanco el campo Third Party ID Sync Container ID. Lo hará de forma predeterminada en
0. Sin embargo, si prefiere asegurarse de que se utiliza el ID de contenedor correcto, siga los siguientes pasos:- Abra una ventana del explorador en modo incógnito o privado y vaya a una página que forme parte de la migración.
- Utilice las herramientas para desarrolladores del explorador para filtrar la llamada de red a
dpm.demdex.net/id. Esta llamada solo se activa en la primera página de una primera visita, por lo que se necesita un explorador de incógnito o privado. - Consultar la carga útil de la solicitud. Si el parámetro
d_nsides diferente a cero, cópielo en el campo Third Party ID Sync Container ID.
-
Seleccione Save.
El conjunto de datos está listo para enviar datos a Audience Manager y pasar las respuestas de Audience Manager a Web SDK.
La mayoría de las implementaciones de Audience Manager usan Reglas de combinación de perfiles en escenarios de personalización entre dispositivos y para ayudar a controlar para qué segmentos pueden calificar los visitantes según su estado de autenticación (con sesión iniciada o cerrada). Las reglas de combinación de perfiles requieren que se envíe a Audience Manager un identificador de propiedad del cliente (ID de CRM, número de cuenta, etc.) en cada llamada de recopilación de datos después de la autenticación. Anteriormente, la función setCustomerIDs del servicio de ID de visitante (visitor.js) se usaba para anexar los ID de cliente a cada llamada de recopilación de datos de Analytics, que luego se reenviaba a Audience Manager.
Con Web SDK, estas identidades ahora deben enviarse a Edge Network mediante una construcción XDM especial llamada IdentityMap.
Pasar las identidades correctamente en un mapa de identidad requiere comprender áreas de nombres de identidad y considerar cuidadosamente qué identidades pasar, especialmente al enviar datos a una zona protegida de Experience Platform. Este artículo describe estas consideraciones e instrucciones.
Una vez que determine qué identidades pasar y cuándo, siga las guías para usar el Identity map Identity map elemento de datos en las etiquetas o configúrelo manualmente como se describe en la descripción general de datos de identidad para alinearlo con su estrategia de implementación de Web SDK.
aam_uuid de origenUna práctica estándar durante muchos años fue colocar el UUID de Audience Manager (el valor de la cookie demdex de terceros) en una cookie de origen generalmente denominada aam_uuid.
Para establecer la cookie, debe escribir un nombre de cookie en el campo Name de la sección Unique User ID Cookie de la extensión de etiqueta de Analytics o en el campo uuidCookie al configurar audienceManagementModule. Aunque normalmente se configura en el código, la cookie rara vez se utilizaba porque el valor UUID de Audience Manager es un identificador entre dominios específico del dispositivo que utilizan las plataformas publicitarias y proporciona poco valor como identificador de origen.
Si su implementación requiere que esta cookie de aam_uuid se siga configurando después de la migración a Web SDK, puede recuperar el UUID de Audience Manager de dos formas.
-
Cada respuesta del extremo de interacción de Edge Network contiene una carga útil con
idnodos. El nodoidde la carga útil del espacio de nombresCOREcontiene el UUID de Audience Manager. -
Utilice el comando getIdentity de Web SDK para recuperarlo. Utilice el área de nombres
COREcomo se describe en la documentación y recupere el valor del campoidentity.COREen la respuesta.
Independientemente del método utilizado para recuperar el UUID de Audience Manager, depende de su equipo de desarrollo analizar la respuesta, recuperar el UUID y establecer la cookie. No existe una forma automática de configurar esta cookie a través de Web SDK.
Configuración del reenvío del lado del servidor y Audience Analytics en la interfaz de usuario del administrador de grupos de informes de Analytics configure-ssf-analytics
Si está familiarizado con la función reenvío del lado del servidor de Analytics, podría preguntarse: “¿Debo deshabilitar la configuración del reenvío del lado del servidor en la interfaz de usuario del administrador de grupos de informes de Analytics para evitar que se envíen datos de Analytics a Audience Manager dos veces?”.
La respuesta es no, no debe deshabilitar esta configuración por los siguientes motivos:
-
Cuando el servicio de Audience Manager está habilitado en una secuencia de datos, Edge Network anexa la variable
cm.ssfa todas las solicitudes de recopilación de datos enviadas a Analytics. Esto evita que los datos de Analytics también se envíen a Audience Manager. Cualquier registro de Assurance utilizado para validar la migración de Analytics mostrará la variablecm.ssf=1cuando el servicio de Audience Manager esté habilitado en el conjunto de datos. Consulte la página de cumplimiento de RGPD y Analytics centrada en el reenvío del lado del servidor para obtener más información. -
Esta configuración también habilita el flujo de datos para la integración de Audience Analytics. Como se describe en la descripción general de Audience Analytics, el reenvío del lado del servidor es necesario para esta integración porque la respuesta de Audience Manager al servidor de recopilación de datos de Analytics se agrega a la visita de Analytics antes de procesarse. Un proceso similar ocurre dentro de Edge Network. Cuando el reenvío del lado del servidor está habilitado, Edge Network agrega los segmentos necesarios de la respuesta de 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 una implementación de Web SDK y que no se cuenten dos veces los datos en Audience Manager.
Validación de la migración validation
Ahora que todas las soluciones de Adobe se atienden con una sola llamada de Web SDK, los pasos de validación pueden cambiar según las soluciones que ofrezca Web SDK.
Si Adobe Target o Adobe Journey Optimizer (incluido Decisioning) forman parte de la pila de soluciones a las que atiende su implementación, tendrá varias llamadas de red a Edge Network en la página. Algunos de ellos están pensados para recuperar personalizaciones y ofertas, mientras que otros están pensados para la recopilación de datos y la creación de informes.
Independientemente de la implementación, los principios generales siguientes se aplican para validar que los datos fluyen correctamente desde y hacia Audience Manager a través de Web SDK.
-
La primera llamada de red para un visitante de primera página será al dominio
adobedc.demdex.nety al extremo/interact. Puede ver las llamadas de red realizadas por Web SDK abriendo la ficha de desarrollador en el explorador web, haciendo clic en la ficha Red y filtrando/interact.
Existen otros tipos de llamadas a Web SDK, pero solo las llamadas deinteractenvían datos a y obtienen una carga de respuesta de Edge Network. -
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. Estos nodosurlson sincronizaciones de ID de terceros que el servicio Visitor ID activó históricamente. Debe haber un nodourlpara cada sincronización de ID de terceros configurada en su contenedor (consulte el paso 3 anterior).Además, puede filtrar por
demdexy encontrar que cada una de las direcciones URL a las que se hace referencia en la carga útil activó su propia solicitud de red para la sincronización de ID como lo hizo el servicio Visitor ID. Estas sincronizaciones de ID solo deben activarse en la primera página de un visitante que acceda por primera vez y solo una vez cada 14 días después de esa fecha. -
Cualquier solicitud posterior
/interactutilizada para la recopilación de datos de Analytics y Audience Manager debe contener los nodosdata.__adobe.analyticsen la carga útil.Las características de Audience Manager que dependen de estas variables de Analytics, así como las características que usan las claves de plataforma
h_od_, deben seguir rellenándose.note tip TIP Es posible que desee crear un rasgo de prueba con una expresión de regla que solo se pueda expresar si se recopilan los datos de Web SDK. Dado que no hay ningún entorno de desarrollo de Audience Manager y que es posible que varios sitios envíen datos a la misma instancia de Audience Manager, basta con observar los recuentos de población generales para comprobar que no le proporcionan la validación necesaria. -
En la misma llamada
/interacten la que se pasan variables de Analytics, se puede encontrar cualquier cookie o destino de URL en los nodos de carga útil de la respuesta. Los destinos de URL estarán en cargas útiles de tipourl(como en las sincronizaciones de ID de terceros) y los destinos de cookies estarán en cargas útiles de tipocookie.También debe asegurarse de que las cookies se hayan colocado en el almacenamiento de cookies del explorador.
note tip TIP Al igual que en el paso de validación anterior, la calificación para un segmento que deba devolver un destino de cookie es una manera determinada 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, autentique el sitio y asegúrese de que las identidades y sus parámetros asociados se pasan en el nodo del mapa de identidad de la carga útil de la solicitud.
note tip TIP Si Adobe Target es una de las soluciones de recepción y hay actividades de Target que dependen de segmentos de Audience Manager que requieren que se pase la identidad correcta, asegúrese de que el mapa de identidad se pase en las llamadas de /interactque se utilizan para recuperar personalizaciones y no solo en llamadas de recopilación de datos. Adobe Target utilizará esas identidades en la llamada del lado del servidor a Audience Manager al recuperar información del segmento.