DocumentaciónExperience PlatformIngesta de datos de flujo

Ingesta de datos de flujo

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Principiante
  • Intermedio
  • Desarrollador

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

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

  • Debemos implementar el SDK web en el sitio web de Luma para enviar datos sobre la actividad del visitante desde el sitio web a la red de Adobe Edge. Haremos una implementación sencilla mediante etiquetas (anteriormente Launch)

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

Los ingenieros de datos deberán ingerir datos de flujo continuo fuera de este tutorial. Al implementar los SDK web o móvil de Adobe Experience Platform, normalmente un desarrollador web o móvil participa en la creación de la capa de datos y en la configuración de las propiedades de etiquetas.

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

https://video.tv.adobe.com/v/31628?learn=on&captions=spa

https://video.tv.adobe.com/v/37261?learn=on&captions=spa

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

Permisos necesarios

En la lección Configurar permisos, configuró todos los controles de acceso necesarios para completar esta lección.

Configuración de la secuencia de datos

Primero configuraremos la secuencia de datos. Un conjunto de datos 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 a Experience Platform, Adobe Analytics o Adobe Target? Las secuencias 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 su secuencia de datos:

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

  2. Seleccione Datastreams en el panel de navegación izquierdo

  3. Seleccione el botón Nueva secuencia de datos en la esquina superior derecha

    Seleccionar flujos de datos en la navegación izquierda

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

  5. Seleccione el botón Guardar

    Asigne un nombre al conjunto de datos y guarde

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

  1. Activar Adobe Experience Platform para mostrar campos adicionales
  2. Para espacio aislado, seleccione Luma Tutorial
  3. Para Conjunto de datos de 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 es necesaria en la Configuración de Edge de estas otras soluciones. Recuerde, el SDK web se desarrolló no solo para transmitir datos a Experience Platform, sino también para reemplazar todas las bibliotecas de JavaScript anteriores utilizadas por otras aplicaciones de Adobe. La configuración de Edge se utiliza para especificar los detalles de cuenta de cada aplicación a la que desea enviar los datos.
  5. Seleccionar Guardar
    Configurar la secuencia 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 añadir 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 de nuestro conjunto de datos.

Instalación de la extensión del SDK web

Añadir una propiedad

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

Para crear una propiedad:

  1. Vaya a Propiedades en el panel de navegación izquierdo
  2. Seleccione el botón Nueva propiedad
    Agregar nueva propiedad
  3. Como Nombre, escriba Luma Platform Tutorial (agregue su nombre al final, si varias personas de su compañía realizan este tutorial)
  4. Como Dominios, escriba enablementadobe.com (explicado más tarde)
  5. Seleccionar Guardar
    Detalles de la propiedad

Añadir la extensión del SDK web

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

  1. Abra la propiedad de etiquetas
  2. Vaya a Extensiones en el panel de navegación izquierdo
  3. Vaya a la ficha Catálogo
  4. Hay muchas extensiones disponibles para las etiquetas. Filtrar el catálogo con el término Web SDK
  5. En la extensión Adobe Experience Platform Web SDK, seleccione el botón Instalar
    Instalar la extensión del SDK web de Adobe Experience Platform
  6. Hay varias configuraciones disponibles para la extensión del SDK web, pero solo dos que vamos a configurar para este tutorial. Actualizar 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 que se recomienda. Más adelante en esta lección, asignará un sitio web del dominio enablementadobe.com a la propiedad de etiquetas. El CNAME del dominio enablementadobe.com ya se ha configurado para que data.enablementadobe.com se reenvíe 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 menú desplegable Flujo de datos, seleccione su flujo de datos Luma Platform Tutorial.
  8. No dude en consultar las demás opciones de configuración (pero no las cambie). y luego selecciona 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 realicen alguna acción. Para crear una regla:

  1. Vaya a Reglas en el panel de navegación izquierdo
  2. Seleccione el botón Crear nueva regla
    Crear una regla
  3. Asigne un nombre a la regla All Pages - Library Loaded.
  4. En Eventos, seleccione el botón Agregar
    Asigne un nombre a la regla y agregue un evento
  5. Use Core Extension y seleccione Library Loaded (Page Top) como 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. Seleccione Conservar cambios para volver a la pantalla de regla principal
    Agregar el evento Library Loaded
  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, seleccione el botón Agregar
  9. Use Adobe Experience Platform Web SDK Extension y seleccione Enviar evento como Tipo de acción
  10. A la derecha, seleccione web.webpagedetails.pageViews de la lista desplegable Tipo. Este es uno de los campos XDM de nuestro Luma Web Events Schema
  11. Seleccione Conservar cambios para volver a la pantalla de regla principal
    Agregar la acción Enviar evento
  12. Seleccione Guardar para guardar la regla
    Guarde la regla

Publish la regla en una biblioteca

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

Para crear una biblioteca:

  1. Vaya a Flujo de publicación en el panel de navegación izquierdo
  2. Seleccionar Agregar biblioteca
    Seleccionar Agregar biblioteca
  3. Para Name, escriba Luma Platform Tutorial
  4. Para el entorno, seleccione Development
  5. Seleccione el botón Agregar todos los recursos modificados. (Además de la extensión Adobe Experience Platform Web SDK y la regla All Pages - Library Loaded, también verá agregada la extensión Core que contiene la JavaScript base requerida por todas las propiedades web de Launch).
  6. Seleccione el botón Guardar y generar para desarrollo
    Crear y compilar 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 completa

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

Validar los datos de la solicitud

Añadir el Adobe Experience Platform Debugger

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

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

https://video.tv.adobe.com/v/35998?learn=on&captions=spa

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

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

Este sitio web hospedado es la razón por la que usamos enablementadobe.com en el campo Dominios de nuestra configuración inicial de propiedad de etiquetas y por la que usamos data.enablementadobe.com como nuestro dominio de origen en la extensión Adobe Experience Platform Web SDK. ¡Mira, tenía un plan!

Página principal de Luma

Utilice Experience Platform Debugger para asignarlo a la propiedad de etiquetas

Experience Platform Debugger tiene una característica interesante 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 tener el sitio de Luma abierto y seleccionar 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án relacionados con este tutorial (puede que tenga que volver a cargar el sitio de Luma después de abrir Debugger).

  3. Confirme que Debugger está "conectado a Luma" como se muestra a continuación y, a continuación, seleccione el icono "bloquear" para bloquear Debugger en el sitio de Luma.

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

  5. Ahora ve a Launch en el panel de navegación izquierdo

  6. Seleccione la pestaña Configuración

  7. A la derecha de donde muestra los códigos incrustados de página, abra el menú desplegable Acciones y seleccione Reemplazar
    Seleccionar acciones > Reemplazar

  8. Dado que se ha autenticado, Debugger extraerá las propiedades y entornos de Launch disponibles. Seleccione su propiedad de Luma Platform Tutorial

  9. Seleccione su entorno Development

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

  11. El sitio web de Luma volverá a cargar con su propiedad de etiquetas. ¡Ayuda, me han hackeado! Sólo bromeaba.
    propiedad de etiqueta reemplazada

  12. Vaya a Resumen en el panel de navegación izquierdo para ver los detalles de su propiedad de Launch
    Pestaña Resumen

  13. Ahora, ve a AEP Web SDK en el panel de navegación izquierdo para ver las solicitudes de red

  14. Abrir la fila events

    Solicitud de SDK web de Adobe Experience Platform

  15. Observe cómo podemos ver el tipo de evento web.webpagedetails.pageView especificado en nuestra acción Enviar evento y otras variables integradas que se ajustan al formato AEP Web SDK ExperienceEvent Mixin
    Detalles del evento

  16. Estos tipos de detalles de solicitud también están visibles en la ficha Red de las herramientas para desarrolladores web del explorador. Á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 ficha Encabezados, área Solicitar carga útil.
    Ficha Red

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

Validación de los datos en Experience Platform

Puede validar que los datos están aterrizando en Platform mirando los lotes de datos que llegan en Luma Web Events Dataset. (Lo sé, se llama ingesta de datos de streaming, pero ahora estoy diciendo que llega en lotes! Se transmite en tiempo real al perfil de, por lo que puede utilizarse 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 el panel de navegación izquierdo
  2. Abra 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 aparezca el lote.
  3. Seleccione el botón Vista previa del conjunto de datos
    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 previsualizar 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 el panel de navegación izquierdo
  2. Seleccione el área de nombres ECID y busque su valor ECID (cópielo de la respuesta. El perfil tendrá su propio ID, independiente del ECID.
  3. Seleccione ID de perfil para abrir el perfil
    Buscar y abrir el perfil
  4. Seleccione la ficha Eventos para ver las páginas que ha visto
    Eventos de perfil \

Añadir datos personalizados al evento

Creación de 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 la propiedad Luma Platform Tutorial, abra el menú desplegable Seleccionar una biblioteca de trabajo y seleccione su biblioteca Luma Platform Tutorial. Esta configuración facilita la publicación de actualizaciones adicionales en la biblioteca.

  2. Ahora ve a Elementos de datos en el panel de navegación izquierdo

  3. Seleccione 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 variable de JavaScript, escriba digitalData.page.pageInfo.pageName

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

  8. Asegúrese de que Luma Platform Tutorial esté seleccionado como la biblioteca de trabajo

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

Asigne el nombre de página al elemento de datos del objeto XDM

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

IMPORTANT
Para completar esta tarea, debemos asegurarnos de que el usuario tenga acceso primero a la zona protegida de producción. Si todavía no tiene acceso a la zona protegida de Prod desde un perfil de producto diferente, abra rápidamente su perfil de Luma Tutorial Platform y agregue el elemento de permiso Zonas protegidas > Prod. Después, haga una SHIFT-Reload en la página Elementos de datos para borrar la caché
Agregar la zona protegida de producción

En la página Elementos de datos:

  1. Creación de un nuevo elemento de datos
  2. Como Nombre, escriba XDM Object
  3. Como la extensión, seleccione Adobe Experience Platform Web SDK
  4. Como Tipo de elemento de datos, seleccione XDM object
  5. Como zona protegida, seleccione su Luma Tutorial zona protegida
  6. Como esquema, seleccione su Luma Web Events Schema
  7. Seleccione el campo web.webPageDetails.name
  8. Como Value, seleccione el icono para abrir el modal de selección de elementos de datos y elija el elemento de datos Page Name
  9. Seleccionar Guardar en biblioteca
    Asigne el nombre de página al elemento de datos del objeto XDM

Este mismo proceso se utiliza para asignar datos personalizados adicionales del sitio web a campos XDM.

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

Ahora que los datos están asignados a campos XDM, puede incluirlos en la acción Enviar evento:

  1. Ir a la pantalla Reglas
  2. Abrir la regla All Pages - Library Loaded
  3. Abrir la acción Adobe Experience Platform Web SDK - Send Event
  4. Como datos XDM, seleccione el icono para abrir el modal de selección de elementos de datos y elija el elemento de datos XDM Object
  5. Seleccione el botón Conservar cambios
    Agregue los datos XDM a la acción Enviar evento
  6. Ahora, desde que ha seleccionado Luma Platform Tutorial como su 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, solo tienes que abrir el menú desplegable del botón azul y seleccionar Guardar en biblioteca y crear
    Guardar en biblioteca y compilar

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 principal de Luma, mientras está asignada a la propiedad de etiqueta mediante el depurador, como ha aprendido anteriormente, y ver que el campo de nombre de página se rellena en la solicitud.
Validar los datos XDM

También puede validar los datos de nombre de página recibidos en Platform mediante la vista previa del 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, que es único por dispositivo y explorador. Un solo cliente puede tener varios ECID en función del dispositivo y el 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 recopilando identidades adicionales durante su sesión y vinculando de manera determinista su perfil a través de la vinculación de identidad.

Si lo recuerda, mencioné que usaríamos los ID de ECID y CRM como identidades para nuestros datos web en la lección Identidades de mapa. Vamos a recopilar el ID de CRM con el SDK web.

Añadir elemento de datos para el ID de CRM

Primero almacenamos el ID de CRM 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 de JavaScript
  3. Como nombre de variable de JavaScript, escriba digitalData.user.0.profile.0.attributes.username
  4. Seleccione el botón Guardar en biblioteca (Luma Platform Tutorial debe seguir siendo su biblioteca de trabajo)
    Agregar 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 de ID de CRM, debemos asociarlo con un tipo de elemento de datos especial denominado mapa de identidad elemento de datos:

  1. Agregar un elemento de datos denominado Identities

  2. Como la 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, escriba Luma CRM Id, que es el área de nombres que hemos creado en una lección anterior

    note warning
    WARNING
    La extensión SDK para web de Adobe Experience Platform versión 2.2 permite seleccionar Área de nombres de una lista desplegable rellenada previamente con los valores reales de la cuenta de Platform. Desafortunadamente, esta función aún no es compatible con la zona protegida y, por lo tanto, es posible que el valor Luma CRM Id 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 el elemento de datos CRM Id

  6. Como estado autenticado, seleccione Autenticado

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

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

NOTE
Puede pasar varios identificadores usando el tipo de datos mapa de identidad.

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

Hay un elemento de datos más que debemos actualizar: el elemento de datos del objeto XDM. Puede parecer extraño tener que actualizar tres elementos de datos separados para pasar esta identidad, pero este proceso está diseñado para escalar para varias identidades. No te preocupes, ¡ya casi terminamos 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 el elemento de datos Identities
  4. Ahora, desde que ha seleccionado Luma Platform Tutorial como su 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
    Agregar el elemento de datos IdentityMap al objeto XDM

Validación de la identidad

Para validar que el SDK web ahora envía el ID de CRM:

  1. Abrir el sitio web de Luma
  2. Asígnelo a la propiedad de etiquetas mediante Debugger, según las instrucciones anteriores
  3. Seleccione el vínculo Iniciar sesión en la parte superior derecha del sitio web de Luma
  4. Iniciar sesión con las credenciales test@adobe.com/test
  5. Una vez autenticada, inspeccione la llamada del SDK web de Experience Platform en Debugger (SDK web de Adobe Experience Platform > Solicitudes de red > eventos de la solicitud más reciente) y debería ver lumaCrmId:
    Validar la identidad en Debugger
  6. Busque el perfil de usuario utilizando el área de nombres y el valor de ECID de nuevo. En el perfil, verá el ID de CRM y también el ID de fidelidad 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.
    Validar la identidad en Platform

Recursos adicionales

¡Buen trabajo! Se trataba de mucha información sobre el SDK web 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.

NOTE
Ahora que ha terminado la lección Ingesta de transmisión, puede eliminar la zona protegida Prod de su perfil de producto Luma Tutorial Platform

Ingenieros de datos, si lo desea, puede pasar a la lección Ejecutar consultas.

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

recommendation-more-help
513160b6-bf42-4c58-abdd-4f817b1cccad