Esta lección le guiará por los pasos necesarios para implementar la extensión del servicio de ID de Adobe Experience Platform y enviar los ID de cliente.
El servicio de ID de Adobe Experience Platform establece un ID 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).
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 usar este contenido:
Al final de esta lección, debe poder:
Ya debería haber completado las lecciones en la Configuración de etiquetas para obtener más información.
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 ID
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 ID 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.
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 ID.
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 ID 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 ID
Abra el sitio de Luma.
Asegúrese de que Debugger asigne la propiedad de etiqueta a your Entorno de desarrollo, tal como se describe en la sección 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 Servicio de identidad debe rellenarse con el mismo ID de organización que se encontraba 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 ID 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:
Abra las herramientas para desarrolladores del navegador
Vaya a la pestaña Application
.
Amplíe Cookies
en el lado izquierdo.
Haga clic en el dominio https://luma.enablementadobe.com
.
Busque la cookie “AMCV_” en el lado derecho. Es posible que haya visto varias desde que cargó 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 ID, consulte la documentación.
A continuación, enviará un ID de cliente al servicio de ID. 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.
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 la navegación izquierda
Haga clic en el botón Añadir 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 conservar 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 elementos de datos. No necesitaremos hacer una "compilación" hasta que hayamos realizado todos nuestros cambios y estén listos para validar.
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 ID. 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 Añadir elemento de datos.
Asigne un nombre al elemento de datos Email (Hashed)
.
Para el Tipo de elemento de datos, seleccione Variable JavaScript.
Como nombre de la variable JavaScript, utilice el siguiente puntero a una variable en la capa de datos del sitio 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
El servicio de ID 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 Añadir regla para abrir el Generador de reglas.
Asigne un nombre a la regla All Pages - Library Loaded - Authenticated - 10
.
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 Añadir.
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
.En Condiciones (Conditions), haga clic en Añadir.
En Tipo de condición, seleccione Comparación de valores.
Haga clic en el para abrir el modal del elemento de datos.
En el modal del elemento de datos, haga clic en Estado de autenticación y, a continuación, haga 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 (Actions), haga clic en Añadir.
Para la variable Extensión select Servicio de ID de Experience Cloud
En Tipo de acción, seleccione Set Customer ID (establecer ID de cliente).
Para el Código de integración, introduzca crm_id
.
Para el Valor, abra el modal del selector de elementos de datos y seleccione Email (Hashed)
.
Para el Estado de autenticación, seleccione Autenticado.
Haga clic en el botón Conservar cambios para guardar la acción y regresar 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
.
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 your Entorno de desarrollo, tal como se describe en la sección 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 LOGIN.
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 ID 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 ID 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:
Las etiquetas también tienen abundantes funciones de registro de consola. Para activarlos, vaya a la Herramientas en Debugger y active la pestaña tags Consola Registro alternar.
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 “All Pages - Library Loaded - Authenticated - 10” se debe activar antes que la regla “All Pages - Library Loaded” y aparecer debajo de ella en el registro de consola de Debugger: