Documentación Experience Platform Tutorial de SDK web

Configuración del Audience Manager con el SDK web de Platform

Última actualización: 5 de mayo de 2025

Temas:

Creado para:

Principiante
Intermedio
Desarrollador

Obtenga información sobre cómo configurar Adobe Audience Manager con el SDK web de Adobe Experience Platform y validar la implementación mediante un destino de cookie.

Adobe Audience Manager es la solución de Adobe Experience Cloud que proporciona todo lo necesario para recopilar información comercial relevante acerca de los visitantes del sitio, crear segmentos comercializables y ofrecer contenido y publicidad segmentada a la audiencia adecuada.

Diagrama de SDK web y Adobe Audience Manager

Objetivos de aprendizaje

Al final de esta lección, debe poder:

Configuración de una secuencia de datos para habilitar Audience Manager
Habilitar un destino de cookie en Audience Manager
Valide la implementación del Audience Manager confirmando la calificación de la audiencia con el Adobe Experience Platform Debugger.

Requisitos previos

Para completar esta lección, primero debe:

Complete las lecciones anteriores de las secciones Configuración inicial y Configuración de etiquetas de este tutorial.
Tener acceso a Adobe Audience Manager y los permisos adecuados para crear, leer y escribir características, segmentos y destinos. Para obtener más información, consulte Control de acceso basado en roles de Audience Manager.

Configuración de la secuencia de datos

La implementación del Audience Manager mediante el SDK web de Platform difiere de la implementación mediante reenvío del lado del servidor (SSF). El reenvío del lado del servidor pasa los datos de solicitud de Adobe Analytics al Audience Manager. Una implementación del SDK web de Platform pasa los datos XDM enviados al Edge Network de Platform al Audience Manager. El Audience Manager está habilitado en el conjunto de datos:

Ir a la interfaz de recopilación de datos
En el panel de navegación izquierdo, seleccione Datastreams
Seleccione la secuencia de datos Luma Web SDK: Development Environment creada anteriormente
Seleccionar Agregar servicio
Seleccione Adobe Audience Manager como servicio
Confirme que Destinos de cookies habilitados y Destinos de URL habilitados están seleccionados
Seleccionar Guardar

Crear una fuente de datos

A continuación, cree un Source de datos, una herramienta fundamental para organizar los datos dentro de Audience Manager:

Ir a la interfaz de Audience Manager
Seleccione Datos de audiencia en la barra de navegación superior
Seleccione Fuentes de datos en el menú desplegable
Seleccione el botón Agregar nuevo de la parte superior de la página Fuentes de datos
Asigne un nombre descriptivo a Data Source. Para la configuración inicial, puede asignar un nombre a este(a) Platform Web SDK tutorial.
Establecer tipo de identificador en cookie
En la sección Controles de exportación de datos, seleccione Sin restricciones
Guardar el Source de datos

Crear un rasgo

Una vez guardado el Data Source, configure un rasgo. Los rasgos son una combinación de una o más señales en Audience Manager. Cree una característica para los visitantes de la página principal.

NOTE

Todos los datos XDM se envían al Audience Manager si están habilitados en el conjunto de datos, pero los datos pueden tardar 24 horas hasta que estén disponibles en el informe Señales no utilizadas. Cree rasgos explícitos para los datos XDM que desee utilizar inmediatamente en Audience Manager, tal como se describe en este ejercicio.

Seleccionar datos de audiencia > rasgos
Seleccionar Agregar nuevo > rasgo basado en reglas
Asigne un nombre descriptivo y una descripción a su característica, Luma homepage view
Seleccione el Source de datos que creó en la sección anterior.
Seleccione una carpeta en la que guardar el rasgo en el panel de la derecha. Es posible que desee crear una carpeta seleccionando el icono + junto a una carpeta principal existente. Puede asignar un nombre a esta nueva carpeta Platform Web SDK tutorial.
Expanda el símbolo de intercalación Expresión de característica y seleccione Generador de expresiones. Debe proporcionar un par de valor clave que signifique una visita a la página principal.
Abra la página principal de Luma (asignada a su propiedad de etiquetas) y el Adobe Experience Platform Debugger, y actualice la página.
Consulte las Solicitudes de red y los detalles del evento para el SDK web de Platform para encontrar la clave y el valor del nombre para la página principal.
Vuelva al Generador de expresiones en la interfaz de usuario del Audience Manager e introduzca la clave como web.webPageDetails.name y el valor de content:luma:us:en. Este paso garantiza que active una característica cada vez que cargue la página principal.
Guardar el rasgo.

Crear un segmento

Los siguientes pasos son crear un segmento y asignar el rasgo recién definido a este segmento.

Seleccione Datos de audiencia en la barra de navegación superior y seleccione Segmentos
Seleccione Agregar nuevo en la parte superior izquierda de la página para abrir el generador de segmentos
Asigne a su segmento un nombre descriptivo y una descripción, como Platform Web SDK - Homepage visitors
Seleccione una carpeta en la que se guardará el segmento en el panel de la derecha. Es posible que desee crear una carpeta seleccionando el icono + junto a una carpeta principal existente. Puede asignar un nombre a esta nueva carpeta Platform Web SDK tutorial.
Añada un código de integración, que en este caso es un conjunto aleatorio de números.
En la sección Data Source, seleccione Audience Manager y el origen de datos que creó anteriormente
Expanda la sección Características y busque la característica que ha creado
Seleccione Agregar característica.
Seleccione Guardar en la parte inferior de la página

Crear un destino

A continuación, cree un destino basado en cookies con Generador de destinos. El Generador de destinos permite crear y administrar destinos de servidor a servidor, direcciones URL y cookies.

Abra el Generador de destinos seleccionando Destinos en el menú Datos de audiencia de la barra de navegación superior
Seleccionar Crear destino
Escriba un nombre y una descripción, Platform Web SDK tutorial
Como categoría, seleccione Personalizado
Como tipo, seleccione cookie
Abra la sección Configuración para escribir los detalles sobre el destino de la cookie
Asigne un nombre descriptivo a su cookie, platform_web_sdk_tutorial
Como dominio de cookies, agregue el dominio del sitio donde planea la integración para la entrada del tutorial en el dominio de Luma luma.enablementadobe.com
Como opción Publish data to, seleccione Solo los dominios seleccionados
Seleccione su dominio si aún no lo ha agregado
Como Formato de datos, seleccione Clave única y asígnele una clave a la cookie. Para este tutorial, use segment como valor clave.
Finalmente, seleccione Guardar para guardar los detalles de configuración de destino.
En la sección Asignaciones de segmentos, usa la función Buscar y agregar segmentos para buscar tu Platform Web SDK - Homepage visitors creado anteriormente y selecciona Agregar.
Una vez que agregue el segmento, se abrirá una ventana emergente en la que debe proporcionar un valor esperado para la cookie. Para este ejercicio, introduzca el valor "visitante".
Seleccionar Guardar
Seleccionar Listo

El periodo de asignación de segmentos requiere que se activen unas horas. Una vez finalizado, puede actualizar la interfaz del Audience Manager y ver que la lista Segmentos asignados se ha actualizado.

Validación del segmento

Unas horas después de la creación inicial del segmento, puede validar que funciona correctamente.

En primer lugar, confirme que puede optar al segmento

Abra la página principal del sitio de demostración de Luma con él asignado a su propiedad de etiquetas para cumplir los requisitos para el segmento recién creado.
Abra la ficha herramientas para desarrolladores > Red de su explorador
Filtrar a la solicitud del SDK web de Platform usando interact como filtro de texto
Seleccione una llamada y abra la ficha Vista previa para ver los detalles de la respuesta
Expanda payload para ver los detalles de la cookie esperados, tal como se configuró anteriormente en el Audience Manager. En este ejemplo, verá el nombre de cookie esperado platform_web_sdk_tutorial.
Abra la ficha Aplicación y abra Cookies desde el menú Almacenamiento.
Seleccione el dominio https://luma.enablementadobe.com y confirme que la cookie se ha escrito correctamente en la lista

Por último, debe abrir el segmento en la interfaz de Audience Manager y asegurarse de que Poblaciones de segmentos haya incrementado:

Audience Manager de Adobe Experience Platform Agregar característica

Ahora que ha completado esta lección, debe poder ver cómo el SDK web de Platform pasa datos a Audience Manager y puede establecer una cookie de origen específica de un segmento con un destino de cookie.

NOTE

Gracias por dedicar su tiempo a conocer el SDK web de Adobe Experience Platform. Si tiene preguntas, desea compartir comentarios generales o tiene sugerencias sobre contenido futuro, compártalas en esta publicación de debate de la comunidad de Experience League

recommendation-more-help