Ingestar datos de flujo continuo

En esta lección, los datos se transmitirán al Experience Platform mediante el SDK web.

Hay dos tareas principales que debemos completar en la interfaz de Adobe Experience Platform Launch:

  • En primer lugar, necesitamos crear una configuración de Edge que indique a los servidores Adobe dónde deben ir los datos (por ejemplo, plataforma, Adobe Analytics, Adobe Target, etc.) después de que el SDK web los haya enviado a la red de Edge. Todos los clientes del SDK web deben realizar este paso, independientemente de cómo implementen el SDK web
  • En segundo lugar, debemos implementar el SDK web. El SDK web se puede implementar mediante la interfaz de Launch o mediante el archivo javascript sin procesar, alloy.js. En este tutorial, utilizaremos la interfaz Launch. Este tutorial se centrará únicamente en la cantidad mínima de funciones necesarias para implementar una implementación sencilla de Web SDK para transmitir datos a Experience Platform y no pretende ser un tutorial de Launch completo.

Los ingenieros de datos deberán ingerir datos de flujo continuo fuera de este tutorial. Al implementar los SDK de Adobe Experience Platform para móviles o web, normalmente un desarrollador web o móvil también participará en los pasos de etiquetado y/o inicio.

Antes de comenzar los ejercicios, vea estos dos vídeos cortos para obtener más información sobre la ingestión de datos de flujo continuo y el SDK web:

NOTA

Aunque este tutorial se centra en transmitir la ingestión desde sitios web con SDK web, también puede transmitir datos mediante el SDK de Adobe Mobile, Apache Kafka Connect y otros mecanismos.

Se requieren permisos

En la lección Configurar permisos, configure todos los controles de acceso que necesite para completar esta lección, específicamente:

  • Elementos de permisos Iniciar > Derechos de propiedad > Aprobar, Desarrollar, Administrar Entornos, Administrar extensiones y Publicar<a112 13/>
  • Elemento de permiso Iniciar > Derechos de Compañía > Administrar propiedades
  • Acceso de rol de usuario al perfil del producto Luma Tutorial Launch
  • Acceso de la función de administrador al perfil del producto Luma Tutorial Launch
  • Elementos de permisos Plataforma > Ingesta de datos > Fuentes de Vista y Administrar fuentes
  • Elementos de permisos Plataforma > Gestión de datos > Conjuntos de datos de Vista y Administrar conjuntos de datos
  • Elementos de permisos Plataforma > Perfiles > Perfiles de Vista, Administrar Perfiles y Exportar segmento de Audiencia
  • Elemento de permiso Plataforma > Administración de Simulador para pruebas > Simuladores para pruebas de Vista
  • Elemento de permiso Plataforma > Simuladores de pruebas > Luma Tutorial
  • Acceso de rol de usuario al perfil del producto Luma Tutorial Platform

Creación de una fuente de flujo continuo

  1. Inicie sesión en la interfaz de usuario del Experience Platform

  2. Haga clic en Fuentes en la navegación izquierda

  3. Para filtrar la lista, haga clic en Flujo

  4. En la sección API HTTP, haga clic en el botón Configurar
    Configuración de una fuente de flujo de API HTTP

  5. En el paso Autenticación, escriba Luma Web Events Source como Nombre de la cuenta y haga clic en el botón Conectar a origen (no es necesario habilitar la autenticación porque los datos se originarán en visitantes del sitio Web)
    Configuración de una fuente de flujo de API HTTP

  6. Una vez conectado, haga clic en el botón Siguiente para continuar con el siguiente paso en el flujo de trabajo

  7. En el paso Seleccionar datos, elija Conjunto de datos existente, seleccione su Luma Web Events Dataset y, a continuación, haga clic en el botón Siguiente
    Seleccione el conjunto de datos

  8. En el paso Detalle de flujo de datos, haga clic en el botón Siguiente:
    Haga clic en Siguiente

  9. En el paso Revisar, revise los detalles del origen y haga clic en el botón Finalizar:
    Haga clic en Siguiente

Crear una configuración de Edge

A continuación, crearemos una Configuración de Edge. Una configuración de Edge indica a la red de Adobe Edge dónde enviar los datos después de recibirlos desde la llamada del SDK web. Por ejemplo, ¿desea enviar los datos al Experience Platform? Adobe Analytics? Adobe Audience Manager? Adobe Target? Las configuraciones de Edge se administran en la interfaz de usuario de Launch y son fundamentales para la recopilación de datos de la plataforma con el SDK web, independientemente de si está implementando o no el SDK web mediante Launch.

Para crear su Configuración de Edge:

  1. Inicie sesión en la interfaz de usuario del Experience Platform Launch

  2. Haga clic en Configuraciones de Edge en el panel de navegación izquierdo

  3. Haga clic en el botón Nueva configuración de Edge en la esquina superior derecha

    Haga clic en el icono de configuración de Edge en el panel de navegación izquierdo

  4. Para el Nombre práctico, escriba Luma Platform Tutorial (agregue su nombre al final, si varias personas de su compañía están tomando este tutorial)

  5. Haga clic en el botón Guardar.

    Asigne un nombre a la configuración de Edge y guarde

En la pantalla siguiente, se crea el entorno de la configuración. Aquí es donde se especifica dónde se desea enviar los datos. Para enviar datos únicamente al Experience Platform, haga lo siguiente:

  1. Alternar en Adobe Experience Platform, que mostrará campos adicionales
  2. Para Simulador para pruebas, seleccione Luma Tutorial
  3. Para Entrada de flujo, seleccione Luma Web Events Source
  4. Para Conjunto de datos de Evento, seleccione Luma Web Events Dataset
  5. Si utiliza otras aplicaciones de Adobe, no dude en explorar las demás secciones para ver qué información se necesita en la Configuración de Edge de estas otras soluciones. Recuerde que el SDK web se desarrolló no sólo para transmitir datos a Experience Platform, sino también para reemplazar todas las bibliotecas JavaScript anteriores utilizadas por otras aplicaciones Adobe. La Configuración de Edge se utiliza para especificar los detalles de la cuenta de cada aplicación a la que desee enviar los datos.
  6. Haga clic en el botón Guardar para guardar la configuración
    Configurar la configuración de Edge y guardar

Una vez guardada la configuración de Edge, en la pantalla resultante, observará que se han creado tres entornos para desarrollo, ensayo y producción y que se pueden agregar entornos de desarrollo adicionales:
Cada configuración de Edge puede tener varios entornos
Si abre cualquiera de estos entornos, verá los detalles de la Plataforma que acaba de introducir. Sin embargo, estos detalles se pueden configurar de forma diferente por entorno. Puede hacer que el SDK web envíe datos a diferentes entornos de configuración de Edge, que a su vez pueden reenviar los datos a diferentes entornos de la aplicación, si es necesario como parte del proceso de implementación de código. En este tutorial, no realizaremos ninguna personalización adicional a nuestra Configuración de Edge.

Instalación de Web SDK Extension

Añadir una propiedad

Primero, debemos crear una propiedad Launch. Una propiedad es un contenedor para todas las funciones, reglas y JavaScript necesarias para recopilar detalles de una página web y enviarlos a varias ubicaciones.

Para crear una propiedad:

  1. Haga clic en Propiedades en el panel de navegación izquierdo
  2. Haga clic en el botón Añadir nueva propiedad
    Añadir una nueva propiedad
  3. Como Nombre, escriba Luma Platform Tutorial (agregue su nombre al final, si varias personas de su compañía están tomando este tutorial)
  4. Como Dominios, introduzca enablementadobe.com (esto se explicará más adelante)
  5. Haga clic en el botón Guardar.
    Detalles de propiedad

Después de guardar la propiedad, puede ver un mensaje de error como el de abajo. Si es así, esto se debe a que no tiene acceso a la propiedad que acaba de crear. Para solucionarlo, necesitamos ir al Admin Console para que se dé acceso:
Error después de guardar el perfil

Para acceder a la propiedad:

  1. En una ficha de explorador independiente, inicie sesión en el Admin Console

  2. Vaya a Productos desde la navegación superior

  3. Seleccione Adobe Experience Platform Launch en el panel de navegación izquierdo

  4. Vaya al perfil del producto Luma Tutorial Launch

  5. Haga clic en la ficha Permisos

  6. En la fila Propiedades, haga clic en Editar
    Editar los permisos de propiedad

  7. Haga clic en el icono "+" para mover la propiedad Luma Platform Tutorial a la derecha y haga clic en el botón Guardar para actualizar los permisos

    Añadir la nueva propiedad

Ahora vuelva a la ficha del explorador con la interfaz de Launch aún abierta. Vuelva a cargar la página y la propiedad Luma Platform Tutorial debe mostrarse en la lista. Haga clic para abrir la propiedad:

El tutorial de la plataforma Luma debería aparecer

Añadir la extensión SDK web

Ahora que tenemos una propiedad, podemos añadir el SDK web con una extensión. Una extensión es un paquete de código que amplía la interfaz de Launch y la funcionalidad del cliente. Para añadir la extensión:

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

  2. Haga clic en la ficha Catálogo

  3. Hay muchas extensiones disponibles para Launch. Filtre el catálogo con el término Web SDK

  4. En la extensión AEP Web SDK, haga clic en el botón Instalar
    Instalación de la extensión AEP Web SDK

  5. Existen varias configuraciones disponibles para la extensión Web SDK, pero solo hay dos que vamos a configurar para este tutorial. Actualice el Dominio de Edge a data.enablementadobe.com. Esta configuración le permite establecer cookies de origen con la implementación del SDK web, lo cual es muy recomendable. Más adelante en esta lección, asignará un sitio web en el dominio enablementadobe.com a la propiedad Launch. El CNAME del dominio enablementadobe.com ya se ha configurado para que data.enablementadobe.com se reenvíe a los servidores Adobe. Cuando implemente el SDK web en su propio sitio web, deberá crear un CNAME para sus propios fines de recopilación de datos, por ejemplo data.YOUR_DOMAIN.com

  6. En la lista desplegable Configuración de Edge, seleccione la configuración Luma Platform Tutorial.

  7. No dude en consultar las demás opciones de configuración (pero no las cambie). y, a continuación, haga clic en el botón Guardar

Crear una regla para enviar datos

Ahora usaremos una regla para enviar datos a Platform. Una regla es una combinación de eventos, condiciones y acciones que indican a Launch que haga algo. Para crear una regla:

  1. Haga clic en Reglas en el panel de navegación izquierdo
  2. Haga clic en el botón Crear nueva regla
    Crear una regla
  3. Asigne un nombre a la regla All Pages - Library Loaded.
  4. En Eventos, haga clic en el botón Añadir
  5. Utilice el Core Extension y seleccione Biblioteca cargada (Principio de página) como el Tipo de evento. Esto significa que nuestra regla se activará cada vez que se cargue la biblioteca Iniciar en una página.
  6. Haga clic en Mantener cambios para volver a la pantalla de la regla principal
    Añadir el evento Cargado de la biblioteca
  7. Deje Condiciones vacías, ya que queremos que esta regla se active en todas las páginas, según el nombre que le dimos
  8. En Acciones, haga clic en el botón Añadir
  9. Utilice el SDK web de AEP Extension y seleccione Enviar Evento como el Tipo de acción
  10. A la derecha, seleccione web.webpagedetails.pageViews en el menú desplegable Tipo. Este es uno de los campos XDM en nuestro Luma Web Events Schema
  11. Haga clic en Mantener cambios para volver a la pantalla de la regla principal
    Añadir la acción Enviar Evento
  12. Haga clic en Guardar para guardar la regla.
    Guarde la regla

Publicación de la regla en una biblioteca

Para validar la regla que acabamos de crear, debemos publicar una biblioteca que contenga todos los elementos de nuestra propiedad. Hay algunos pasos rápidos que debemos seguir en la sección Publicación de Launch.

Crear un host

Las bibliotecas de inicio se pueden alojar en la red de Envío de contenido (CDN) de Adobe o en sus propios servidores. En este tutorial utilizaremos el CDN de Adobe, ya que solo es necesario configurarlo con mayor rapidez:

  1. Haga clic en Hosts en el panel de navegación izquierdo
  2. Haga clic en el botón Crear nuevo host
    Crear un nuevo host
  3. Para Nombre, introduzca Adobe CDN
  4. Para Tipo, seleccione Administrado por Adobe
  5. Haga clic en el botón Guardar para completar la configuración del host
    Configurar el host

Crear un entorno

Los entornos le permiten tener distintas versiones de una biblioteca en diferentes entornos de publicación para adaptarse al flujo de trabajo de publicación. Por ejemplo, la versión completamente probada de la biblioteca se puede publicar en un entorno de producción, mientras que se crean nuevos cambios en un entorno de desarrollo. También puede utilizar diferentes hosts para cada entorno. Para crear un entorno:

  1. Haga clic en Entornos en el panel de navegación izquierdo
  2. Haga clic en el botón Crear nuevo Entorno
    Crear un nuevo entorno
  3. En Desarrollo haga clic en Seleccionar
    Seleccione el tipo de entorno
  4. Para Nombre, introduzca Development
  5. Para la lista desplegable Seleccionar host, seleccione Adobe CDN
  6. Haga clic en el botón Guardar para completar la configuración del entorno
    Configure el entorno
  7. Verá un modal con URL y otros detalles de implementación de esta biblioteca. Estas son críticas para una implementación de Launch real, pero no tenemos que preocuparnos por ellas para este tutorial. Haga clic en el botón Cerrar para salir del modal.

Creación y publicación de la biblioteca

Ahora agrupemos el contenido de nuestra propiedad (actualmente una extensión y una regla) en una biblioteca. Para crear una biblioteca:

  1. Haga clic en Flujo de publicación en la navegación izquierda
  2. Haga clic en el botón Añadir nueva biblioteca
    Haga clic en el botón Añadir nueva biblioteca
  3. Para Nombre, introduzca Luma Platform Tutorial
  4. Para el Entorno, seleccione Development
  5. Haga clic en el botón Añadir todos los recursos modificados. (Además de la extensión AEP Web SDK y la regla All Pages - Library Loaded, también verá la extensión Core agregada que contiene el JavaScript base requerido por todas las propiedades web de Launch).
  6. Haga clic en el botón Guardar y crear para desarrollo
    Crear y generar la biblioteca

La biblioteca puede tardar unos minutos en crearse y, cuando se complete, mostrará un punto verde a la izquierda del nombre de la biblioteca:
Compilación completa

Como puede ver en la pantalla Flujo de publicación, hay mucho más en el proceso de publicación en Launch que está más allá del alcance de este tutorial. Vamos a usar una sola biblioteca en nuestro entorno de Desarrollo.

Validar los datos en la solicitud

Añadir Adobe Experience Platform Debugger

El depurador Experience Platform es una extensión disponible para los navegadores Chrome y Firefox que le ayuda a ver la tecnología de Adobe implementada en sus páginas web. Descargue la versión para su navegador preferido:

Si nunca antes ha utilizado el depurador (y éste es diferente del Depurador de Adobe Experience Cloud anterior), es posible que desee ver este vídeo de descripción general de cinco minutos:

Abrir el sitio web Luma

Para este tutorial, utilizaremos una versión alojada públicamente del sitio web de demostración de Luma. Vamos a abrirlo y marcarlo:

  1. En una nueva ficha de explorador, abra https://luma.enablementadobe.com.
  2. Marque la página para utilizarla durante el resto del tutorial

Por este motivo, hemos utilizado enablementadobe.com en el campo Dominios de la configuración inicial de la propiedad Launch y hemos utilizado data.enablementadobe.com como nuestro dominio de origen en la extensión AEP Web SDK. ¡He aquí que tenía un plan!

Página principal de Luma

Utilice el depurador de Experience Platform para asignarlo a la propiedad Launch

El depurador Experience Platform tiene una característica interesante que le permite reemplazar una propiedad Launch existente por otra diferente (o inyectar una en un sitio que no tenga Launch implementado en absoluto). Esto resulta útil para la validación y en este tutorial nos permite omitir muchos pasos de implementación con los que solo los desarrolladores web deben preocuparse.

  1. Asegúrese de que el sitio de Luma está abierto y haga clic en el icono de la extensión Experience Platform Debugger

  2. El depurador se abrirá y mostrará algunos detalles de la implementación codificada, que no está relacionada con este tutorial (es posible que tenga que volver a cargar el sitio Luma después de abrir el depurador)

  3. Confirme que el depurador está "Conectado a Luma" como se muestra a continuación y haga clic en el icono "bloquear" para bloquear el depurador en el sitio de Luma. Si no lo hace, el depurador seguirá cambiando para exponer los detalles de implementación de cualquier pestaña del navegador que esté enfocada, lo que puede resultar confuso.

  4. Haga clic en el botón Iniciar sesión en la parte superior derecha para autenticarse. Si ya tiene una ficha de explorador abierta con la interfaz Launch, el paso de autenticación será automático y no tendrá que introducir su nombre de usuario y contraseña de nuevo.

  5. Haga clic en Iniciar en el panel de navegación izquierdo

  6. Seleccione la ficha Configuración

  7. A la derecha de donde muestra los Códigos incrustados de página, abra la lista desplegable Acciones y seleccione Reemplazar

    Seleccione Acciones > Reemplazar

  8. Como está autenticado, el depurador extraerá las propiedades y entornos de Launch disponibles. Seleccione la propiedad Luma Platform Tutorial

  9. Seleccione el entorno Development

  10. Haga clic en el botón Aplicar
    Seleccione la propiedad Launch alternativa

  11. El sitio web de Luma volverá a cargar con la propiedad Launch. ¡Ayuda, me han hackeado! Sólo bromeo.
    Se reemplazó la propiedad Launch

  12. Haga clic en Resumen en el menú de navegación de la izquierda para ver los detalles de la propiedad Launch
    Ficha Resumen

  13. A continuación, haga clic en AEP Web SDK en el panel de navegación izquierdo para ver las Solicitudes de red

  14. Haga clic para abrir la fila eventos

    Solicitud de SDK web de AEP

  15. Observe cómo podemos ver el tipo de evento web.webpagedetails.pageView que especificamos en nuestra acción Enviar Evento, así como otras variables listas para usar que cumplen el formato AEP Web SDK ExperienceEvent Mixin
    Detalles del evento

  16. Estos tipos de detalles de solicitud también están visibles en la ficha de herramientas para desarrolladores web del explorador Red. Ábrala y vuelva a cargar la página. Filtre las llamadas con interact para ubicar la llamada, haga clic en ella y, a continuación, busque en la ficha Encabezados, Área de carga útil de solicitud.
    Ficha Red

  17. Haga clic en la ficha Respuesta y observe cómo se incluye el valor ECID en la respuesta. Copie este valor como lo usará para validar la información de perfil en el próximo ejercicio.
    Ficha Red

Validar los datos en el Experience Platform

Puede validar que los datos estén aterrizando en la plataforma observando los lotes de datos que llegan a Luma Web Events Dataset. (Lo sé, se llama ingestión de datos de transmisión, ¡pero ahora digo que llega en lotes! Se transmite en tiempo real al Perfil, de modo que se puede utilizar para la segmentación y activación en tiempo real, pero se envía en lotes cada 15 minutos al lago de datos).

Para validar los datos:

  1. En la interfaz de usuario de la plataforma, vaya a Datasets en el panel de navegación izquierdo
  2. Abra el Luma Web Events Dataset y confirme que ha llegado un lote. Recuerde que se envían cada quince minutos, por lo que es posible que tenga que esperar un poco para que aparezca el lote.
  3. Haga clic en el botón conjunto de datos de Previsualización
    Abrir el conjunto de datos
  4. En el modal de previsualización, observe cómo puede seleccionar diferentes campos del esquema de la izquierda para realizar la previsualización de los puntos de datos específicos:
    Previsualización de los campos

También puede confirmar que se muestra el nuevo perfil:

  1. En la interfaz de usuario de la plataforma, vaya a Perfiles en el panel de navegación izquierdo
  2. Seleccione la Área de nombres ECID y busque el valor ECID (cópielo desde la respuesta en la ficha de red de herramientas para desarrolladores web, como se indicó en el último ejercicio)
  3. El perfil tendrá su propia identificación, separada del ECID, haga clic en él para abrir el perfil
    Buscar y abrir el perfil
  4. Aunque puede que haya mucho en él, al menos debería poder ver las páginas que vio en la ficha Eventos
    Eventos perfil

Añadir datos personalizados al evento

Crear un elemento de datos para el nombre de página

  1. En la interfaz de usuario de Launch, en la esquina superior derecha de la propiedad Luma Platform Tutorial, abra la lista desplegable Seleccionar una biblioteca de trabajo y seleccione la biblioteca Luma Platform Tutorial. Esto facilitará la publicación de actualizaciones adicionales en nuestra biblioteca.

  2. Ahora vaya a Elementos de datos en la navegación izquierda

  3. Haga clic en el botón Crear nuevo elemento de datos

    Crear un nuevo elemento de datos

  4. Como Nombre escriba Page Name

  5. Como Tipo de elemento de datos, seleccione JavaScript Variable

  6. Como nombre de la variable JavaScript, introduzca digitalData.page.pageInfo.pageName

  7. Para ayudar a estandarizar el formato de los valores, marque las casillas Forzar el valor en minúsculas y Limpiar texto

  8. Asegúrese de que Luma Platform Tutorial está seleccionado como biblioteca de trabajo y haga clic en el botón Guardar en biblioteca
    Crear un elemento de datos para el nombre de página

Asigne el nombre de página al elemento de datos Objeto XDM

Ahora asignaremos el nombre de nuestra página al SDK web.

IMPORTANTE

Para completar esta tarea, debemos asegurarnos de que el usuario tenga acceso primero al simulador de pruebas Prod. Si todavía no tiene acceso al simulador para pruebas Prod desde otro perfil de producto, abra rápidamente el perfil Luma Tutorial Platform y agregue el elemento de permiso Simuladores para pruebas > Prod.
Añadir el entorno limitado de Prod

  1. Si acaba de actualizar los permisos para incluir el simulador para pruebas Prod, haga una recarga MAYÚS en la página Elementos de datos para borrar la caché
  2. En la pantalla Elementos de datos de Launch, cree otro elemento de datos con el Nombre de XDM Object
  3. Como Extensión, seleccione AEP Web SDK
  4. Como Tipo de elemento de datos, seleccione XDM Object
  5. Se recuperan listas de los entornos limitados y esquemas de la plataforma. Como Simulador para pruebas, seleccione su Luma Tutorial Simulador para pruebas
  6. Como Esquema, seleccione su Luma Web Events Schema
  7. El esquema se cargará en la interfaz de usuario de Launch. Seleccione el campo web.webPageDetails.name
  8. Como Valor, haga clic en el icono para abrir el modal de selección de elementos de datos y elija su elemento de datos Page Name
  9. Haga clic en el botón Guardar en biblioteca
    Asigne el nombre de página al elemento de datos Objeto XDM

Este mismo proceso básico se utiliza para asignar todos los datos personalizados del sitio web a los campos de esquema XDM.

Añadir los datos XDM a la acción Enviar Evento

Ahora que tiene datos asignados a campos XDM, puede incluirlos en la acción Enviar Evento:

  1. Vaya a la pantalla Reglas y abra la regla All Pages - Library Loaded

  2. Abra la acción AEP Web SDK - Send Event

  3. Como Datos XDM, haga clic en el icono para abrir el modal de selección de elementos de datos y elija el elemento de datos XDM Object

  4. Haga clic en el botón Conservar cambios.
    Añadir los datos XDM a la acción Enviar Evento

  5. Ahora, como ha seleccionado Luma Platform Tutorial como biblioteca de trabajo en los últimos ejercicios, los cambios recientes se han estado guardando directamente en la biblioteca. En lugar de tener que publicar los cambios a través de la pantalla Flujo de publicación, puede abrir el menú desplegable del botón azul y seleccionar Guardar en biblioteca y crear

    Guardar en biblioteca y crear

Esto inicio con la creación de una nueva biblioteca de Launch con los tres cambios que acaba de realizar.

Validar los datos XDM

Ahora debería poder volver a cargar la página de inicio de Luma, mientras se asigna a la propiedad Launch mediante el depurador como le mostré anteriormente, ¡y ver que el campo del nombre de página se rellena en la solicitud!
Validar los datos XDM

También puede validar los datos del nombre de página que se recibieron en la plataforma, previsualizando el conjunto de datos y el perfil.

Enviar identidades adicionales

La implementación del SDK web ahora está enviando eventos con el ID de Experience Cloud (ECID) como identificador principal. El ECID lo genera automáticamente el SDK web y es único por dispositivo y navegador. Un único cliente puede tener varios ECID en función del dispositivo y del explorador que utilice. Entonces, ¿cómo podemos obtener una vista unificada de este cliente y vincular su actividad en línea a nuestros datos de CRM, Lealtad y Compras sin Conexión? Lo hacemos reuniendo identidades adicionales durante su sesión y vinculando determinísticamente su perfil a través de la identificación.

Si recuerda, mencioné que usaríamos el ECID y el CRM Id como identidades para nuestros datos web en la lección Identidades de mapa. Así que recopilemos el ID de CRM con el SDK web.

Añadir elemento de datos para el identificador de CRM

Primero almacenaremos el ID de CRM en un elemento de datos:

  1. En la interfaz de Launch, cree un nuevo elemento de datos denominado CRM Id
  2. Como Tipo de elemento de datos, seleccione Variable de JavaScript
  3. Como nombre de la variable JavaScript, introduzca digitalData.user.0.profile.0.attributes.username
  4. Haga clic en el botón Guardar en biblioteca (Luma Platform Tutorial debe seguir siendo la biblioteca de trabajo)
    Añadir elemento de datos para el identificador de CRM

Añadir el ID de CRM al elemento de datos de mapa de identidad

Ahora que hemos capturado el valor de ID de CRM, necesitamos asociarlo con un tipo de elemento de datos especial denominado elemento de datos Mapa de identidad:

  1. Crear un nuevo elemento de datos con el nombre Identities

  2. Como Extensión, seleccione AEP Web SDK

  3. Como Tipo de elemento de datos, seleccione Mapa de identidad

  4. Como Área de nombres, escriba lumaCRMId, que es el Símbolo de identidad que hemos creado en una lección anterior

    ADVERTENCIA

    La versión 2.2 de la extensión AEP Web SDK permite seleccionar Espacio de nombres en un menú desplegable previamente rellenado con los valores reales de la cuenta de plataforma. Desafortunadamente, esta característica aún no es "compatible con el entorno limitado" y, por lo tanto, es posible que el valor lumaCRMId no aparezca en la lista desplegable. Esto puede impedir que complete este ejercicio. Publicaremos una solución una vez confirmada.

  5. Como ID, haga clic en el icono para abrir el modal de selección de elementos de datos y elija el elemento de datos CRM Id

  6. Como Estado autenticado, seleccione Autenticado

  7. Deje Principal sin marcar. Dado que el ID de CRM no está presente para la mayoría de los visitantes al sitio web de Luma, definitivamente no desea anular el ECID como identificador principal. Sería un caso de uso muy raro utilizar cualquier cosa que no fuera el ECID como identificador principal. Normalmente no menciono la configuración predeterminada en estas instrucciones, pero lo llamo para ayudarle a evitar dolores de cabeza más adelante en su propia implementación.

  8. Haga clic en el botón Guardar en biblioteca (Luma Platform Tutorial debe seguir siendo la biblioteca de trabajo)
    Añadir el ID de CRM al elemento de datos de mapa de identidad

NOTA

Puede pasar varios identificadores utilizando el tipo de datos Mapa de identidad.

Añadir el elemento de datos IdentityMap en el objeto XDM

Hay otro elemento de datos que debemos actualizar: el elemento de datos Objeto XDM. Puede parecer raro tener que actualizar tres elementos de datos separados para pasar esta única identidad, pero este proceso está diseñado para escalar varias identidades en varios estados. No te preocupes, ¡casi hemos terminado con esta lección!

  1. Abra el elemento de datos Objeto XDM
  2. Abrir el campo XDM de IdentityMap
  3. Como elemento de datos que proporciona el objeto, haga clic en el icono para abrir el modal de selección de elementos de datos y elija el elemento de datos Identities
  4. Ahora, como ha seleccionado Luma Platform Tutorial como biblioteca de trabajo en los últimos ejercicios, los cambios recientes se han estado guardando directamente en la biblioteca. En lugar de tener que publicar los cambios a través de la pantalla Flujo de publicación, puede abrir el menú desplegable del botón azul y seleccionar Guardar en biblioteca y crear
    Añadir el elemento de datos IdentityMap en el objeto XDM

Validar la identidad

Para validar que el SDK web esté enviando el ID de CRM:

  1. Abra el sitio Web de Luma
  2. Asigne esta propiedad a su propia propiedad Launch mediante el depurador, según las instrucciones anteriores
  3. Haga clic en el vínculo Inicio de sesión en la parte superior derecha del sitio Web de Luma
  4. Inicie sesión con las credenciales test@adobe.com/test
  5. Una vez autenticada, inspeccione la llamada del SDK web de AEP en el depurador (SDK web de AEP > Solicitudes de red > eventos de la solicitud más reciente) y deberá ver la lumaCrmId:
    Validar la identidad en el depurador
  6. Busque el perfil del usuario con la Área de nombres ECID y vuelva a consultar el valor. Tenga en cuenta que en el perfil no solo verá el ID de CRM, sino también el ID de lealtad y los detalles del perfil como el nombre y el número de teléfono. Todas las identidades y datos se han unido en un único perfil de clientes en tiempo real.
    Validar la identidad en la plataforma

Recursos adicionales

¡bueno trabajo! Esa era una gran cantidad de información sobre Web SDK y Launch. Hay mucho más involucrado en una implementación completa, pero estos son los conceptos básicos para ayudarle a empezar y ver los resultados en Platform.

NOTA

Ahora que ha terminado con la lección de introducción de flujo continuo, puede eliminar el entorno limitado Prod del perfil del producto Luma Tutorial Platform

Ingenieros de datos, si lo desea, puede seguir adelante con la lección de consultas.

Arquitectos de datos, puede pasar a políticas de combinación!

En esta página

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now