Documentación Experience Platform Tutorial web

Añadir el servicio de identidad de Adobe Experience Platform

5 de mayo de 2025

Temas:

Creado para:

Principiante
Intermedio
Desarrollador

Esta lección le guiará por los pasos necesarios para implementar la extensión del servicio de identidad de Adobe Experience Platform y enviar los ID de cliente.

El servicio de identidad de Adobe Experience Platform establece un identificador de visitante común en todas las soluciones de Adobe para potenciar las funciones de Experience Cloud, como el uso compartido de audiencias entre soluciones. También puede enviar sus propios ID de cliente al servicio para permitir integraciones y segmentaciones en todos los dispositivos con los sistemas de administración de la relación con los clientes (CRM).

NOTE

Adobe Experience Platform Launch se está integrando en Adobe Experience Platform como un conjunto de tecnologías de recopilación de datos. Se han implementado varios cambios terminológicos en la interfaz que debe tener en cuenta al utilizar este contenido:

El platform launch (lado del cliente) ahora es tags
El lado del servidor de platform launch ahora es event forwarding
Ahora, las configuraciones de Edge son datastreams

Objetivos de aprendizaje

Al final de esta lección, debe poder:

Añadir la extensión del servicio de identidad
Crear un elemento de datos para recopilar los ID de cliente.
Crear una regla que utilice la acción “Set Customer ID” (establecer ID de cliente) para enviar los ID de cliente a Adobe.
Utilizar la función de orden de reglas para secuenciar las reglas que se activan con el mismo evento.

Requisitos previos

Ya debería haber completado las lecciones en la sección Configurar etiquetas.

Añadir la extensión del servicio de identidad

Dado que es la primera extensión que añade, a continuación le ofrecemos una descripción general rápida de lo que son las extensiones. Las extensiones son una de las funciones principales de las etiquetas. Una extensión es una integración creada por Adobe, un socio de Adobe o cualquier cliente de Adobe que añada opciones nuevas e ilimitadas a las etiquetas que puede incorporar a un sitio web. Si piensa en las etiquetas como un sistema operativo, las extensiones son las aplicaciones que instala para que las etiquetas puedan hacer lo que usted necesite.

Para añadir la extensión de servicio de identidad

En el panel de navegación izquierdo, haga clic en Extensiones
Haga clic en Catálogo para ir a la página Catálogo de extensiones
Tenga en cuenta la variedad de extensiones disponibles en el catálogo.
En el filtro de la parte superior, escriba "ID" para filtrar el catálogo.
En la tarjeta del servicio de identidad de Adobe Experience Platform, haga clic en Instalar
Tenga en cuenta que el ID de su organización de Experience Cloud se ha detectado automáticamente.
Deje todos los ajustes predeterminados y haga clic en Guardar en biblioteca y crear

NOTE

Cada versión de la extensión del servicio de ID incluye una versión específica de VisitorAPI.js que se indica en la descripción de la extensión. Para actualizar la versión VisitorAPI.js, actualice la extensión del servicio de identidad.

Validación de la extensión

La extensión del servicio de ID es una de las pocas extensiones de etiqueta que realiza una solicitud sin tener que utilizar una acción de regla. La extensión realiza automáticamente una solicitud al servicio de identidad en la primera carga de página de la primera visita a un sitio web. Una vez solicitado el ID, se almacena en una cookie de origen que comienza con “AMCV_”.

Para validar la extensión del servicio de identidad

Abra el sitio de Luma.
Asegúrese de que Debugger asigne la propiedad de etiqueta a su entorno de desarrollo, tal como se describe en la lección anterior.
En la pestaña Resumen de Debugger, la sección de etiquetas debe indicar que se ha implementado la extensión del servicio de ID de Adobe Experience Platform.
Además, en la pestaña Resumen, la sección del servicio de ID debe rellenarse con el mismo ID de organización mostrado en la pantalla de configuración de la extensión en la interfaz de recopilación de datos:
La solicitud inicial para recuperar el ID de visitante puede aparecer en la pestaña del servicio de identidad de Debugger. Puede que ya se haya solicitado, por lo que no debe preocuparse si no la ve:
Después de la solicitud inicial para recuperar el ID de visitante, el ID se almacena en una cookie cuyo nombre comienza con AMCV_. Puede confirmar que la cookie se ha configurado haciendo lo siguiente:
1. Abra las herramientas para desarrolladores del navegador
2. Vaya a la pestaña Application.
3. Amplíe Cookies en el lado izquierdo.
4. Haga clic en el dominio https://luma.enablementadobe.com.
5. Busque la cookie “AMCV_” en el lado derecho. Es posible que haya visto varias desde que ha cargado el sitio de Luma usando tanto su propiedad de etiqueta codificada como también la asignada a la suya propia.

¡Ya está! ¡Ha añadido su primera extensión! Para obtener más información sobre las opciones de configuración del servicio de identidad, consulte la documentación.

Envío de los ID de cliente

A continuación, enviará un ID de cliente al servicio de identidad. Esto le permite integrar su CRM con Experience Cloud, así como rastrear a los visitantes entre dispositivos.

En la lección anterior Añadir elementos de datos, reglas y bibliotecas ha creado un elemento de datos y lo ha utilizado en una regla. Ahora se utilizan las mismas técnicas para enviar un ID de cliente cuando se autentica al visitante.

Creación de elementos de datos para el ID de cliente

Comience creando dos elementos de datos:

Authentication State: para recopilar si el visitante ha iniciado sesión o no.
Email (Hashed): para recopilar la versión con hash de la dirección de correo electrónico (utilizada como ID de cliente) de la capa de datos.

Para crear el elemento de datos del estado de autenticación

Haga clic en Elementos de datos en el panel de navegación izquierdo
Haga clic en el botón Agregar elemento de datos
Asigne un nombre al elemento de datos Authentication State.
Para el Tipo de elemento de datos, seleccione Código personalizado
Haga clic en el botón Abrir editor

.
En la ventana Editar código, utilice el siguiente código para devolver valores de “logged in” (sesión iniciada) o “logged out” (sesión finalizada) según un atributo de la capa de datos del sitio de Luma:
if (digitalData.user[0].profile[0].attributes.loggedIn) return "logged in" else return "logged out"
Haga clic en Guardar para guardar el código personalizado
Mantenga el resto de configuraciones en sus valores predeterminados.
Haga clic en Guardar en biblioteca para guardar el elemento de datos y volver a la página de elementos de datos. No tendremos que hacer una "compilación" hasta que hayamos realizado todos los cambios y estemos listos para validarla.

Al conocer el estado de autenticación del usuario, sabe cuándo debe existir un ID de cliente en la página para enviarlo al servicio de identidad. El siguiente paso es crear un elemento de datos para el propio ID de cliente. En el sitio de muestra de Luma se utiliza la versión con hash de la dirección de correo electrónico del visitante.

Para añadir el elemento de datos para el correo electrónico con hash

Haga clic en el botón Agregar elemento de datos
Asigne un nombre al elemento de datos Email (Hashed).
Para el Tipo de elemento de datos, seleccione Variable de JavaScript
Como nombre de variable de JavaScript, use el siguiente puntero a una variable en la capa de datos del sitio de Luma: digitalData.user.0.profile.0.attributes.username
Mantenga el resto de configuraciones en sus valores predeterminados.
Haga clic en Guardar en biblioteca para guardar el elemento de datos

Añadir una regla para enviar los ID de cliente

El servicio de identidad de Adobe Experience Platform pasa los ID de cliente en reglas mediante una acción denominada “Set Customer ID” (establecer ID de cliente). Cree una regla para activar esta acción cuando se autentique el visitante.

Para crear una regla para enviar los ID de cliente

En el panel de navegación izquierdo, haga clic en Reglas
Haga clic en Agregar regla para abrir el Generador de reglas.
Asigne un nombre a la regla All Pages - Library Loaded - Authenticated - 10.

TIP
Esta convención de nombres indica que está activando esta regla en la parte superior de todas las páginas cuando el usuario está autenticado y que tendrá un orden de "10". El uso de una convención de nombres como esta (en lugar de asignarle un nombre para las soluciones activadas en las acciones) le permitirá minimizar el número total de reglas que necesita la implementación.
En Eventos, haga clic en Agregar
1. Para el Tipo de evento, seleccione Biblioteca cargada (Principio de página)
2. Expanda la sección Opciones avanzadas y para el Pedido escriba 10. El orden controla la secuencia de reglas activadas por el mismo evento. Las reglas con un orden inferior se activan antes que las reglas con un orden superior. En este caso, debe configurar el ID de cliente antes de activar la solicitud de Target, lo que se explica en la siguiente lección con una regla con un orden de 50.
3. Haga clic en el botón Conservar cambios para volver al Generador de reglas.
En condiciones, haga clic en Agregar
1. Para el Tipo de condición, seleccione Comparación de valores
2. Haga clic en el para abrir el modal del elemento de datos.
3. En el modal del elemento de datos, haz clic en Estado de autenticación y luego haz clic en Seleccionar
Asegúrese de que el operador es Equals.
Escriba “logged in” en el campo de texto, lo que hace que la regla se active siempre que el elemento de datos “Estado de autenticación” (Authentication State) tenga el valor “logged in”.
Haga clic en Conservar cambios
En Acciones, haga clic en Agregar
1. Para la extensión, seleccione Servicio de ID de Experience Cloud
2. Para el tipo de acción, seleccione Establecer ID de cliente
3. Para el código de integración, escriba crm_id
4. Para Value, abra el modal del selector de elementos de datos y seleccione Email (Hashed)
5. Para el estado de autenticación, seleccione Autenticado
6. Haga clic en el botón Conservar cambios para guardar la acción y volver al Generador de reglas
Haga clic en el botón Guardar en biblioteca y crear para guardar la regla

Ha creado una regla que enviará el ID de cliente como variable crm_id cuando el visitante se autentique. Ya que especificó el orden como 10, esta regla se activará antes de la regla All Pages - Library Loaded que se cree en la lección Añadir elementos de datos, reglas y bibliotecas, que utiliza el valor de orden predeterminado de 50.

Validación de los ID de cliente

Para validar su trabajo, iniciará sesión en el sitio de Luma para confirmar el comportamiento de la nueva regla.

Para iniciar sesión en el sitio Luma

Abra el sitio de Luma.
Asegúrese de que Debugger asigne la propiedad de etiqueta a su entorno de desarrollo, tal como se describe en la lección anterior
Haga clic en el vínculo LOGIN en la esquina superior derecha del sitio de Luma
Escriba test@adobe.com como nombre de usuario.
Escriba test como contraseña.
Haga clic en el botón INICIAR SESIÓN
Vuelva a la página principal.

Ahora, confirme que el ID de cliente se envía al servicio mediante la extensión de Debugger.

Para validar que el servicio de identidad está pasando el ID del cliente

Asegúrese de que la pestaña del sitio de Luma esté centrada.
En Debugger, vaya a la pestaña del servicio de identidad de Adobe Experience Platform.
Expandir su ID de organización.
Haga clic en la celda con el valor Customer ID - crm_id.
En el modal, observe el valor de ID de cliente y que se refleja el estado AUTHENTICATED:
Tenga en cuenta que puede confirmar el valor de correo electrónico con hash observando el código fuente de la página de Luma y la propiedad de nombre de usuario. Debe coincidir con el valor que se ve en Debugger:

Sugerencias de validación adicionales

Las etiquetas también tienen abundantes funciones de registro de consola. Para activarlos, vaya a la ficha Herramientas en Debugger y active la opción Registro de consola de etiquetas.

Activar el registro de consola de las etiquetas

Esto activa el registro de la consola, tanto en la consola del navegador como en la pestaña Logs de Debugger. Debería ver el registro de todas las reglas creadas hasta el momento. Tenga en cuenta que las nuevas entradas de registro se añaden en la parte superior de la lista, por lo que la regla “Todas las páginas - Biblioteca cargada - Autenticado - 10” se debe activar antes que la regla “Todas las páginas - Biblioteca cargada” y aparecer debajo de ella en el registro de consola de Debugger:

Pestaña Logs de Debugger

Siguiente: "Añadir Adobe Target" >

recommendation-more-help