Añadir el servicio de ID de Adobe Experience Platform

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

NOTA

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:

  • El platform launch (lado del cliente) ahora es tags
  • El lado del servidor de platform launch es ahora event forwarding
  • Las configuraciones de Edge ahora son datastreams

Objetivos de aprendizaje

Al final de esta lección, debe poder:

  • Añadir la extensión del servicio de ID
  • 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 ID

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

  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 ID de Adobe Experience Platform, haga clic en Instalar.

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

  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

NOTA

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.

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

  1. Abra el sitio de Luma.

  2. Asegúrese de que Debugger asigne la propiedad tag 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 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:

    Compruebe que la extensión del servicio de ID 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 ID 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 ID 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 cargó 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 ID, consulte la documentación.

Envío de los ID de cliente

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.

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 Añadir 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:

    if (digitalData.user[0].profile[0].attributes.loggedIn)
        return "logged in"
    else
        return "logged out"
    
  7. Haga clic en Guardar para conservar 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 regresar a la página de elementos de datos. No necesitaremos hacer una "compilación" hasta que hayamos realizado todos nuestros cambios y estén listos para validar.

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

  1. Haga clic en el botón Añadir 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 JavaScript.

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

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

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

  2. Haga clic en Añadir regla para abrir el Generador de reglas.

    Añadir una regla

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

    SUGERENCIA

    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 Añadir.

    Añadir un evento

    1. En Tipo de evento, seleccione Biblioteca cargada (Principio de página) [Library Loaded (Page Top)].
    2. Expanda la sección Opciones avanzadas y, para Pedido, introduzca 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 (Conditions), haga clic en Añadir.

    Añadir una condición a la regla

    1. En 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, haga clic en Estado de autenticación y, a continuación, haga 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 (Actions), haga clic en Añadir.

    Añadir una acción nueva

    1. Para Extension seleccione Servicio de ID de Experience Cloud

    2. En Tipo de acción, seleccione Set Customer ID (establecer ID de cliente).

    3. Para el Código de integración, introduzca crm_id.

    4. Para el Valor, 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 regresar 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 tag a su entorno de desarrollo, tal como se describe en la lección anterior

    El entorno de desarrollo de etiquetas que se muestra 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 LOGIN.

    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 ID 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 ID 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 pestaña Tools en Debugger y active la opción tags Console Logging.

Alternar en el registro de consola de 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 “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:

Pestaña Logs de Debugger

Siguiente: “Añadir Adobe Target” >

En esta página