Ingesta de datos de flujo continuo

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

Hay dos tareas principales que debemos completar en la interfaz de recopilación de datos:

  • Se debe implementar el SDK web en el sitio web de Luma para enviar datos sobre la actividad de los visitantes desde el sitio web a la red de Adobe Edge. Realizaremos una implementación sencilla mediante etiquetas (anteriormente, Launch)

  • Debemos configurar un conjunto de datos, que indique a la red de Edge dónde reenviar los datos. Lo configuraremos para enviar los datos a nuestra Luma Web Events conjunto de datos en nuestro entorno limitado de Platform.

Ingenieros de datos tendrá que introducir datos de flujo continuo fuera de este tutorial. Al implementar los SDK web o móviles de Adobe Experience Platform, normalmente un desarrollador web o móvil participa en la creación de la capa de datos y la configuración de la propiedad de etiquetas.

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

NOTA

Aunque este tutorial se centra en la transmisión de la ingesta de sitios web con el SDK web, también puede transmitir datos mediante la función SDK de Adobe Mobile, Apache Kafka Connecty otros mecanismos.

Permisos necesarios

En el Configuración de permisos , configure todos los controles de acceso necesarios para completar esta lección.

Configuración del conjunto de datos

Primero configuraremos el conjunto de datos. Un conjunto de datos indica a la red de Adobe Edge dónde enviar los datos después de recibirlos de la llamada del SDK web. Por ejemplo, ¿desea enviar los datos a Experience Platform, Adobe Analytics o Adobe Target? Los conjuntos de datos se administran en la interfaz de usuario de recopilación de datos (anteriormente Launch) y son esenciales para la recopilación de datos con el SDK web.

Para crear datastream:

  1. Inicie sesión en el Interfaz de usuario de recopilación de datos del Experience Platform

  2. Select Datastreams en la navegación izquierda

  3. Seleccione el Nuevo conjunto de datos en la esquina superior derecha

    Seleccionar conjuntos de datos en el panel de navegación izquierdo

  4. Para la variable Nombre reconocible, introduzca Luma Platform Tutorial (añada su nombre al final, si varias personas de su empresa están tomando este tutorial)

  5. Seleccione el botón Guardar

    Asigne un nombre al datastram y guárdelo

En la siguiente pantalla, se especifica dónde se desea enviar los datos. Para enviar datos al Experience Platform:

  1. Alternar en Adobe Experience Platform exponer campos adicionales

  2. Para Sandbox, seleccione Luma Tutorial

  3. Para Conjunto de datos del evento, seleccione Luma Web Events Dataset

  4. Si utiliza otras aplicaciones de Adobe, no dude en explorar las otras secciones para ver qué información se requiere en la Configuración de Edge de estas otras soluciones. Recuerde que el SDK web se desarrolló no solo para transmitir datos a Experience Platform, sino también para reemplazar todas las bibliotecas JavaScript anteriores utilizadas por otras aplicaciones de Adobe. La configuración de Edge se utiliza para especificar los detalles de la cuenta de cada aplicación a la que desea enviar los datos.

  5. Seleccione Guardar

    Configurar el conjunto de datos y guardar

Una vez guardada la configuración de Edge, la pantalla resultante mostrará tres entornos creados para desarrollo, ensayo y producción. Se pueden agregar entornos de desarrollo adicionales:
Cada configuración de Edge puede tener varios entornos
Los tres entornos contienen los detalles de Platform que acaba de introducir. Sin embargo, estos detalles se pueden configurar de forma diferente para cada entorno. Por ejemplo, puede hacer que cada entorno envíe datos a un entorno limitado de Platform diferente. En este tutorial, no realizaremos ninguna personalización adicional en nuestro conjunto de datos.

Instalación de la extensión del SDK web

Agregar una propiedad

En primer lugar, se debe crear una propiedad de etiqueta (anteriormente, una propiedad de etiqueta). Una propiedad es un contenedor de todas las funciones, reglas y demás funciones de JavaScript necesarias para recopilar detalles de una página web y enviarlos a varias ubicaciones.

Para crear una propiedad:

  1. Vaya a Propiedades en la navegación izquierda

  2. Seleccione el botón Nueva propiedad
    Añadir una nueva propiedad

  3. Como Nombre, introduzca Luma Platform Tutorial (añada su nombre al final, si varias personas de su empresa están tomando este tutorial)

  4. Como Dominios, introduzca enablementadobe.com (explicado más tarde)

  5. Seleccione Guardar

    Detalles de propiedad

Añadir la extensión del SDK web

Ahora que tiene una propiedad, puede añadir el SDK web con una extensión . Una extensión es un paquete de código que amplía la interfaz y funcionalidad de recopilación de datos. Para añadir la extensión:

  1. Abra la propiedad tag
  2. Vaya a Extensiones en la navegación izquierda
  3. Vaya a la Catálogo ficha
  4. Hay muchas extensiones disponibles para etiquetas. Filtrar el catálogo con el término Web SDK
  5. En el SDK web de Adobe Experience Platform , seleccione Instalar botón
    Instalación de la extensión del SDK web de Adobe Experience Platform
  6. Hay varias configuraciones disponibles para la extensión del SDK web, 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 su implementación del SDK web, lo que resulta útil. Más adelante en esta lección, asignará un sitio web a la enablementadobe.com a la propiedad tag. El CNAME de la variable enablementadobe.com El dominio ya se ha configurado para que data.enablementadobe.com se reenviará a los servidores de Adobe. Al implementar 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
  7. En el Datastream menú desplegable, seleccione su Luma Platform Tutorial datastream.
  8. Siéntase libre de ver las otras opciones de configuración (pero no las cambie). y, a continuación, seleccione Guardar

Creación de una regla para enviar datos

Ahora crearemos una regla para enviar datos a Platform. Una regla es una combinación de eventos, condiciones y acciones que indican a las etiquetas que hagan algo. Para crear una regla:

  1. Vaya a Reglas en la navegación izquierda
  2. Seleccione el Crear nueva regla botón
    Crear una regla
  3. Asigne un nombre a la regla All Pages - Library Loaded.
  4. En Eventos, seleccione Agregar botón
    Asigne un nombre a la regla y añada un evento
  5. Utilice la variable Principal Extensión y seleccione Biblioteca cargada (Principio de página) como el Tipo de evento. Esta configuración significa que la regla se activa cada vez que la biblioteca de Launch se carga en una página.
  6. Select Conservar cambios para volver a la pantalla de regla principal
    Añadir el evento Library Loaded
  7. Leave Condiciones vacío, ya que queremos que esta regla se active en todas las páginas, según el nombre que le dimos
  8. En Acciones, seleccione Agregar botón
  9. Utilice la variable SDK web de Adobe Experience Platform Extensión y seleccione Enviar evento como el Tipo de acción
  10. A la derecha, seleccione web.webpagedetails.pageViews de la variable Tipo lista desplegable. Este es uno de los campos XDM en nuestra Luma Web Events Schema
  11. Select Conservar cambios para volver a la pantalla de regla principal
    Añadir la acción Enviar evento
  12. Select Guardar para guardar la regla
    Guarde la regla

Publicar la regla en una biblioteca

A continuación, publicaremos la regla en nuestro entorno de desarrollo para que podamos verificar que funciona.

Para crear una biblioteca:

  1. Vaya a Flujo de publicación en la navegación izquierda
  2. Select Agregar biblioteca
    Seleccionar Agregar biblioteca
  3. Para la variable Nombre, introduzca Luma Platform Tutorial
  4. Para la variable Entorno, seleccione Development
  5. Seleccione el Agregar todos los recursos modificados botón. (Además del SDK web de Adobe Experience Platform y All Pages - Library Loaded regla, también verá la variable Principal extensión añadida que contiene el JavaScript base requerido por todas las propiedades web de Launch).
  6. Seleccione el Guardar y generar para desarrollo botón
    Crear y crear la biblioteca

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

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

Validación de los datos en la solicitud

Añadir Adobe Experience Platform Debugger

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

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

Abra el sitio web de Luma.

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

  1. En una nueva pestaña del explorador, abra la Sitio web de Luma.
  2. Marque la página para usarla durante el resto del tutorial.

Este sitio web alojado es la razón por la que usamos enablementadobe.com en el Dominios campo de la configuración inicial de la propiedad tag y por qué se ha utilizado data.enablementadobe.com como nuestro dominio de origen en la variable SDK web de Adobe Experience Platform extensión. ¡Mira, tenía un plan!

Página de inicio de Luma

Usar el depurador de Experience Platform para asignar a la propiedad de etiqueta

Experience Platform Debugger tiene una funcionalidad excelente que le permite reemplazar una propiedad de etiqueta existente por otra diferente. Esto resulta útil para la validación y nos permite omitir muchos pasos de implementación en este tutorial.

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

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

  3. Confirme que Debugger es "Conectado a Luma" como se muestra a continuación y seleccione "bloquear" para bloquear Debugger en el sitio de Luma.

  4. Seleccione el Iniciar sesión en la parte superior derecha para autenticarse.

  5. Ahora vaya a Launch en la navegación izquierda

  6. Seleccione la pestaña Configuración

  7. A la derecha de donde se muestra la variable Códigos incrustados de página, abra el Acciones y seleccione Reemplazar

    Seleccione Acciones > Reemplazar

  8. Como está autenticado, Debugger va a incorporar las propiedades y los entornos de Launch disponibles. Seleccione su Luma Platform Tutorial property

  9. Seleccione su Development entorno

  10. Seleccione el Aplicar botón
    Seleccionar la propiedad de etiqueta alternativa

  11. El sitio web de Luma ahora se vuelve a cargar con la propiedad tag. ¡Ayuda, me han hackeado! Estoy bromeando.
    se ha reemplazado la propiedad tag

  12. Vaya a Resumen en el panel de navegación izquierdo, para ver los detalles de Launch property
    Ficha Resumen

  13. Ahora vaya a SDK web de AEP en el panel de navegación izquierdo para ver la Solicitudes de red

  14. Abra el events row

    Solicitud de SDK web de Adobe Experience Platform

  15. Observe cómo podemos ver el web.webpagedetails.pageView tipo de evento especificado en nuestra Enviar evento y otras variables listas para usar que cumplan con el AEP Web SDK ExperienceEvent Mixin format
    Detalles del evento

  16. Estos tipos de detalles de solicitud también están visibles en las herramientas para desarrolladores web del explorador Red pestaña . Ábrala y vuelva a cargar la página. Filtre las llamadas con interact para localizar la llamada, selecciónela y, a continuación, busque en la Encabezados , Carga útil de solicitud .
    Ficha Red

  17. Vaya a la Respuesta y observe cómo se incluye el valor ECID en la respuesta. Copie este valor tal como lo usará para validar la información de perfil en el siguiente ejercicio.
    Ficha Red

Validar los datos en el Experience Platform

Puede validar que los datos están aterrizando en Platform observando los lotes de datos que llegan al Luma Web Events Dataset. (Lo sé, se llama ingesta de transmisión de datos, pero ahora digo que llega en lotes! Se transmite en tiempo real a 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 Platform, vaya a Conjuntos de datos en la navegación izquierda
  2. Abra el Luma Web Events Dataset y confirme que ha llegado un lote. Recuerde que se envían cada 15 minutos, por lo que es posible que tenga que esperar a que se muestre el lote.
  3. Seleccione el Vista previa del conjunto de datos botón
    Abrir el conjunto de datos
  4. En el modal de vista previa, observe cómo puede seleccionar diferentes campos del esquema a la izquierda para obtener una vista previa de esos puntos de datos específicos:
    Vista previa de los campos

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

  1. En la interfaz de usuario de Platform, vaya a Perfiles en la navegación izquierda
  2. Seleccione el ECID y busque su valor ECID (cópielo desde la respuesta). El perfil tendrá su propio ID, independiente del ECID.
  3. Seleccione el ID de perfil para abrir el perfil
    Buscar y abrir el perfil
  4. Seleccione el Eventos para ver las páginas que ha visto
    Eventos de perfil

Añadir datos personalizados al evento

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

  1. En la interfaz de etiquetas de recopilación de datos, en la esquina superior derecha de su Luma Platform Tutorial , abra la Seleccionar una biblioteca de trabajo lista desplegable y seleccione su Luma Platform Tutorial biblioteca. Esta configuración facilita la publicación de actualizaciones adicionales en nuestra biblioteca.

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

  3. Seleccione el Crear nuevo elemento de datos botón

    Crear un nuevo elemento de datos

  4. Como Nombre, introduzca Page Name

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

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

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

  8. Asegúrese de que Luma Platform Tutorial se selecciona como biblioteca de trabajo

  9. Select Guardar en biblioteca
    Crear un elemento de datos para el nombre de página

Asignación del nombre de página al elemento de datos Objeto XDM

Ahora asignaremos nuestro nombre de página al SDK web.

IMPORTANTE

Para completar esta tarea, debemos asegurarnos de que el usuario tenga acceso primero al simulador para pruebas Prod. Si todavía no tiene acceso al simulador para pruebas de producto desde un perfil de producto diferente, abra rápidamente su Luma Tutorial Platform perfil y añadir el elemento de permiso Sandboxes > Prod. Después de hacerlo, realice una recarga SHIFT en la página Elementos de datos para borrar la caché
Agregar el simulador para pruebas de Prod

En el Elementos de datos página:

  1. Crear un nuevo elemento de datos

  2. Como Nombre, introduzca XDM Object

  3. Como Extensión, seleccione Adobe Experience Platform Web SDK

  4. Como Tipo de elemento de datos, seleccione XDM object

  5. Como Sandbox, seleccione Luma Tutorial entorno limitado

  6. Como Esquema, seleccione Luma Web Events Schema

  7. Seleccione el web.webPageDetails.name field

  8. Como Valor, seleccione el icono para abrir el modal de selección de elementos de datos y elija su Page Name elemento de datos

  9. Select Guardar en biblioteca

    Asignación del nombre de página al elemento de datos Objeto XDM

Este mismo proceso se utiliza para asignar datos personalizados adicionales en el sitio web a los campos 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 Reglas pantalla
  2. Abra su All Pages - Library Loaded regla
  3. Abra el Adobe Experience Platform Web SDK - Send Event acción
  4. Como Datos XDM, seleccione el icono para abrir el modal de selección de elementos de datos y elija su XDM Object elemento de datos
  5. Seleccione el Conservar cambios botón
    Añadir los datos XDM a la acción Enviar evento
  6. Ahora, ya que Luma Platform Tutorial seleccionados como biblioteca de trabajo para los últimos ejercicios, los cambios recientes se han estado guardando directamente en la biblioteca. En lugar de tener que publicar nuestros cambios a través de la pantalla Flujo de publicación, solo puede abrir el menú desplegable del botón azul y seleccionar Guardar en biblioteca y crear
    Guardar en biblioteca y crear

Esto comienza a crear una nueva biblioteca de etiquetas con los tres cambios que acaba de realizar.

Validación de los datos XDM

Ahora debería poder volver a cargar la página de inicio de Luma, mientras está asignada a la propiedad tag usando Debugger como supo anteriormente, ¡y ver que el campo nombre de página se rellena en la solicitud!
Validación de los datos XDM

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

Envío de identidades adicionales

La implementación del SDK web ahora envía eventos con el ID de Experience Cloud (ECID) como identificador principal. El SDK web genera automáticamente el ECID y es único para cada dispositivo y navegador. Un único cliente puede tener varios ECID en función del dispositivo y el navegador 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? Para ello, recopilamos identidades adicionales durante su sesión y vinculamos de forma determinista su perfil mediante la vinculación de identidades.

Si recuerda, he mencionado que utilizaríamos el ECID y el ID de CRM como identidades para nuestros datos web en la variable Identidades de mapa lección. Así que recopilemos el ID de CRM con el SDK web.

Añadir elemento de datos para el ID de CRM

Primero almacenamos el CRM Id en un elemento de datos:

  1. En la interfaz de etiquetas, agregue un elemento de datos denominado CRM Id
  2. Como Tipo de elemento de datos, seleccione Variable JavaScript
  3. Como Nombre de variable de JavaScript, introduzca digitalData.user.0.profile.0.attributes.username
  4. Seleccione el Guardar en biblioteca botón (Luma Platform Tutorial debe seguir siendo su biblioteca de trabajo)
    Añadir elemento de datos para el ID de CRM

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

Ahora que hemos capturado el valor CRM Id, debemos asociarlo a un elemento de datos especial denominado Mapa de identidad elemento de datos:

  1. Agregue un elemento de datos con el nombre Identities

  2. Como Extensión, seleccione SDK web de Adobe Experience Platform

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

  4. Como Área de nombres, introduzca Luma CRM Id, que es el namespace hemos creado en una lección anterior

    ADVERTENCIA

    La extensión web SDK de Adobe Experience Platform versión 2.2 permite seleccionar Área de nombres de una lista desplegable previamente rellenada mediante los valores reales de la cuenta de Platform. Lamentablemente, esta función aún no es "compatible con entornos limitados" y, por lo tanto, la función Luma CRM Id puede que no aparezca en la lista desplegable. Esto puede impedir que complete este ejercicio. Publicaremos una solución una vez confirmada.

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

  6. Como Estado autenticado, seleccione Autenticado

  7. Leave Principal sin marcar. Dado que el ID de CRM no está presente para la mayoría de los visitantes del sitio web de Luma, usted definitivamente no desea anular el ECID como identificador principal. Sería un caso de uso poco frecuente usar cualquier cosa que no sea 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. Seleccione el Guardar en biblioteca botón (Luma Platform Tutorial debe seguir siendo su biblioteca de trabajo)
    Añadir el ID de CRM al elemento de datos del mapa de identidad

NOTA

Puede pasar varios identificadores usando la variable Mapa de identidad tipo de datos.

Añadir el elemento de datos de mapa de identidad al objeto XDM

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

  1. Abra el elemento de datos Objeto XDM .
  2. Abra el campo XDM de IdentityMap
  3. Como Elemento de datos, seleccione el icono para abrir el modal de selección de elementos de datos y elija su Identities elemento de datos
  4. Ahora, ya que Luma Platform Tutorial seleccionados como biblioteca de trabajo para 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
    Agregue el elemento de datos IdentityMap al 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. Asignarlo a la propiedad de etiqueta mediante Debugger, según las instrucciones anteriores
  3. Seleccione el Inicio de sesión vínculo en la parte superior derecha del sitio web de Luma
  4. Iniciar sesión con las credenciales test@adobe.com/test
  5. Una vez autenticado, inspeccione la llamada del SDK web del Experience Platform en Debugger (SDK web de Adobe Experience Platform > Solicitudes de red > events de la solicitud más reciente) y debería ver la variable lumaCrmId:
    Validar la identidad en Debugger
  6. Busque el perfil de usuario mediante el espacio de nombres y valor de ECID de nuevo. En el perfil, verá el CRM Id y también el Loyalty Id y los detalles del perfil como el nombre y el número de teléfono. Todas las identidades y los datos se han unido en un único perfil de cliente en tiempo real.
    Validación de la identidad en Platform

Recursos adicionales

¡bueno trabajo! Se trataba de mucha información sobre el SDK web y Launch. Hay mucha más participación 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 ingesta de transmisión, puede eliminar la variable Prod entorno limitado de su Luma Tutorial Platform perfil de producto

Ingenieros de datos, si lo desea, puede avanzar hacia el lección ejecutar consultas.

Arquitectos de datos, puede pasar a combinar directivas!

En esta página