DocumentaciónExperience PlatformTutorial web

Añadir el servicio de identidad de Adobe Experience Platform

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 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

  1. En el panel de navegación izquierdo, haga clic en Extensiones

  2. Haga clic en Catálogo para ir a la página Catálogo de extensiones

  3. Tenga en cuenta la variedad de extensiones disponibles en el catálogo.

  4. En el filtro de la parte superior, escriba "ID" para filtrar el catálogo.

  5. En la tarjeta del servicio de identidad de Adobe Experience Platform, haga clic en Instalar

    Instalación de la extensión del servicio de identidad

  6. Tenga en cuenta que el ID de su organización de Experience Cloud se ha detectado automáticamente.

  7. Deje todos los ajustes predeterminados y haga clic en Guardar en biblioteca y crear

    Guardar la extensión

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

  1. Abra el sitio de Luma.

  2. Asegúrese de que Debugger asigne la propiedad de etiqueta a su entorno de desarrollo, tal como se describe en la lección anterior.

  3. 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.

  4. 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:

    Compruebe que la extensión del servicio de identidad de Adobe Experience Platform esté implementada

  5. 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:
    Compruebe si hay una solicitud al servicio de identidad con el ID de su organización

  6. 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.

      Verifique la cookie “AMCV_”

¡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:

  1. Authentication State: para recopilar si el visitante ha iniciado sesión o no.
  2. 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

  1. Haga clic en Elementos de datos en el panel de navegación izquierdo

  2. Haga clic en el botón Agregar elemento de datos

    Haga clic en “Añadir elemento de datos”

  3. Asigne un nombre al elemento de datos Authentication State.

  4. Para el Tipo de elemento de datos, seleccione Código personalizado

  5. Haga clic en el botón Abrir editor

    Abra el editor para agregar el código personalizado para el elemento de datos .

  6. 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:

    code language-javascript 
    if (digitalData.user[0].profile[0].attributes.loggedIn)
    return "logged in"
else
    return "logged out"

  7. Haga clic en Guardar para guardar el código personalizado

    Guarde el código personalizado

  8. Mantenga el resto de configuraciones en sus valores predeterminados.

  9. 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.

    Guarde el elemento de datos

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

  1. Haga clic en el botón Agregar elemento de datos

    Añadir un elemento de datos

  2. Asigne un nombre al elemento de datos Email (Hashed).

  3. Para el Tipo de elemento de datos, seleccione Variable de JavaScript

  4. 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

  5. Mantenga el resto de configuraciones en sus valores predeterminados.

  6. Haga clic en Guardar en biblioteca para guardar el elemento de datos

    Guarde 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

  1. En el panel de navegación izquierdo, haga clic en Reglas

  2. Haga clic en Agregar regla para abrir el Generador de reglas.

    Añadir una regla

  3. Asigne un nombre a la regla All Pages - Library Loaded - Authenticated - 10.

    note tip
    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.

  4. En Eventos, haga clic en Agregar

    Añadir un evento

    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.

    Guardar el evento

  5. En condiciones, haga clic en Agregar

    Añadir una condición a la regla

    1. Para el Tipo de condición, seleccione Comparación de valores

    2. Haga clic en el icono de elemento de datos para abrir el modal del elemento de datos.

      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

      Establecer el estado de autenticación

  6. Asegúrese de que el operador es Equals.

  7. 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”.

  8. Haga clic en Conservar cambios

    Guardar la condición

  9. En Acciones, haga clic en Agregar

    Añadir una acción nueva

    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

      Configure la acción y guarde los cambios

  10. Haga clic en el botón Guardar en biblioteca y crear para guardar la regla

    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

  1. Abra el sitio de Luma.

  2. Asegúrese de que Debugger asigne la propiedad de etiqueta a su entorno de desarrollo, tal como se describe en la lección anterior

    Se muestra el entorno de desarrollo de etiquetas en Debugger

  3. Haga clic en el vínculo LOGIN en la esquina superior derecha del sitio de Luma

    Haga clic en LOGIN en la barra de navegación superior

  4. Escriba test@adobe.com como nombre de usuario.

  5. Escriba test como contraseña.

  6. Haga clic en el botón INICIAR SESIÓN

    Escriba las credenciales y haga clic en iniciar sesión

  7. 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

  1. Asegúrese de que la pestaña del sitio de Luma esté centrada.

  2. En Debugger, vaya a la pestaña del servicio de identidad de Adobe Experience Platform.

  3. Expandir su ID de organización.

  4. Haga clic en la celda con el valor Customer ID - crm_id.

  5. En el modal, observe el valor de ID de cliente y que se refleja el estado AUTHENTICATED:

    Confirmar el ID de cliente en Debugger

  6. 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:

    correo electrónico con hash en el código fuente

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
45774420-d03e-4a6b-94b5-cd639ae825b2