DocumentaciónExperience PlatformIngesta de datos de flujo

Ingesta de datos de flujo

Last update: Mon Sep 25 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Beginner
  • Intermediate
  • Developer

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 Luma Web Events en nuestra zona protegida de Platform.

Ingenieros de datos deberá 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 Adobe Mobile SDK, Apache Kafka Connecty otros mecanismos.

Permisos necesarios

En el Configuración de permisos Esta lección, ha configurado 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 Interfaz de usuario de recopilación de datos de Experience Platform

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

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

    Seleccione flujos de datos en el panel de navegación izquierdo

  4. Para el Nombre descriptivo, introduzca Luma Platform Tutorial (añada su nombre al final, si varias personas de su compañía realizan este tutorial)

  5. Seleccione el botón Guardar

    Asigne un nombre a la secuencia de datos y guarde

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

  1. Alternar en Adobe Experience Platform para exponer campos adicionales
  2. Para Sandbox, seleccione Luma Tutorial
  3. Para Conjunto de datos de evento, seleccione Luma Web Events Dataset
  4. Si utiliza otras aplicaciones de Adobe, puede explorar las demás 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 la cuenta de cada aplicación a la que desea enviar los datos.
  5. Seleccione Guardar
    Configure la secuencia de datos y guarde

Una vez guardada la configuración de Edge, la pantalla resultante mostrará tres entornos que se han creado para el desarrollo, el ensayo y la 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 todos los elementos JavaScript, las reglas y otras funciones necesarias para recopilar detalles de una página web y enviarlos a varias ubicaciones.

Para crear una propiedad:

  1. Ir a Propiedades en el panel de navegación izquierdo
  2. Seleccione el botón Nueva propiedad
    Añadir una nueva propiedad
  3. Como el Nombre, introduzca Luma Platform Tutorial (añada su nombre al final, si varias personas de su compañía realizan este tutorial)
  4. Como el Domains, introduzca enablementadobe.com (explicado más tarde)
  5. Seleccione 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. Ir a Extensiones en el panel de navegación izquierdo
  3. Vaya a la Catálogo pestaña
  4. Hay muchas extensiones disponibles para las etiquetas. Filtre el catálogo con el término Web SDK
  5. En el SDK web de Adobe Experience Platform extensión, seleccione la Instalar botón
    Instalación de la extensión SDK para 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. Actualice el Dominio de Edge hasta 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 en la enablementadobe.com a su propiedad de etiquetas. El CNAME para enablementadobe.com el dominio ya se ha configurado para que data.enablementadobe.com 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. Desde el Datastream , seleccione su Luma Platform Tutorial secuencia de datos.
  8. No dude en consultar las demás opciones de configuración (pero no las cambie). y luego 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 realicen alguna acción. Para crear una regla:

  1. Ir a Reglas en el panel de navegación izquierdo
  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 la Añadir botón
    Asignar un nombre a la regla y añadir un evento
  5. Utilice el Núcleo Extensión y seleccione Library Loaded (Page Top) 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. Seleccionar Conservar cambios para volver a la pantalla de regla principal
    Añada el evento Library Loaded
  7. Salir 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 la Añadir botón
  9. Utilice el 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 desde el Tipo desplegable. Este es uno de los campos XDM de nuestra Luma Web Events Schema
  11. Seleccionar Conservar cambios para volver a la pantalla de regla principal
    Añadir la acción Enviar evento
  12. Seleccionar Guardar para guardar la regla
    Guarde la regla

Publicación de 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. Ir a Flujo de publicación en el panel de navegación izquierdo
  2. Seleccionar Añadir biblioteca
    Seleccione Añadir biblioteca.
  3. Para el Nombre, introduzca Luma Platform Tutorial
  4. Para el Entorno, seleccione Development
  5. Seleccione el Añadir todos los recursos modificados botón. (Además de la SDK web de Adobe Experience Platform y la extensión de All Pages - Library Loaded regla, también verá el Núcleo se ha añadido una extensión 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 completa

Como puede ver en el Flujo de publicación En la pantalla de, 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 alojado es la razón por la que utilizamos enablementadobe.com en el Domains del campo de configuración inicial de la propiedad de etiquetas y por qué se ha utilizado data.enablementadobe.com como dominio de origen en el SDK web de Adobe Experience Platform extensión. ¡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 es "Conectado a Luma" como se muestra a continuación y, a continuación, seleccione el "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 el panel de navegación izquierdo

  6. Seleccione la pestaña Configuración

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

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

  9. Seleccione su Development entorno

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

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

  12. Ir a Resumen en el panel de navegación izquierdo, para ver los detalles de su Launch propiedad
    Pestaña 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 eventos reñir

    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 acción y otras variables listas para usar que se ajustan a la variable AEP Web SDK ExperienceEvent Mixin formato
    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. Filtrar por llamadas con interact para localizar la llamada, selecciónela y, a continuación, busque en Encabezados pestaña, Solicitar carga útil área.
    Pestaña Red

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

Validación de los datos en Experience Platform

Puede validar que los datos están llegando a Platform consultando los lotes de datos que llegan a 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 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 aparezca el lote.
  3. Seleccione el Previsualizar conjunto de datos botón
    Abra 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:
    Previsualización 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 ECID y busque su valor ECID (cópielo de 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

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

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

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

    Crear un nuevo elemento de datos

  4. Como el Nombre, introduzca Page Name

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

  6. Como el Nombre de variable 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 está seleccionado como la biblioteca de trabajo

  9. Seleccionar Guardar en biblioteca
    Creación de 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 aún no tiene acceso a la zona protegida de producción desde un perfil de producto diferente, abra rápidamente el Luma Tutorial Platform perfil y agregar el elemento de permiso Zonas protegidas > Prod. Después, haga una SHIFT-Reload en la página Elementos de datos para borrar la caché
Añadir la zona protegida de producción

En el Elementos de datos página:

  1. Crear un nuevo elemento de datos
  2. Como el Nombre, introduzca XDM Object
  3. Como el Extensión, seleccione Adobe Experience Platform Web SDK
  4. Como el Tipo de elemento de datos, seleccione XDM object
  5. Como el Sandbox, seleccione su Luma Tutorial espacio aislado
  6. Como el Esquema, seleccione su Luma Web Events Schema
  7. Seleccione el web.webPageDetails.name campo
  8. Como el Valor, seleccione el icono para abrir el modal de selección de elementos de datos y elija su Page Name elemento de datos
  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. 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 el 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 has tenido Luma Platform Tutorial seleccionado como su biblioteca de trabajo para los últimos ejercicios, los cambios recientes se han guardado 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 en el 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 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.
Validación de 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 utilizaríamos los ID de ECID y CRM como identidades para nuestros datos web en el Asignar identidades lección. 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, añada un elemento de datos denominado CRM Id
  2. Como el Tipo de elemento de datos, seleccione Variable JavaScript
  3. Como el Nombre de variable 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 de ID de CRM, debemos asociarlo con un tipo de elemento de datos especial denominado Mapa de identidad elemento de datos:

  1. Añada un elemento de datos denominado Identities

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

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

  4. Como el Área de nombres, introduzca Luma CRM Id, que es el namespace 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 tiene en cuenta la zona protegida y, por lo tanto, la variable Luma CRM Id es posible que el valor no aparezca en la lista desplegable. Esto puede impedir que complete este ejercicio. Publicaremos una solución una vez confirmada.

  5. Como el 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 el Estado autenticado, seleccione Autenticado

  7. Salir Principal desenfrenado. Dado que el ID de CRM no está presente para la mayoría de los visitantes del sitio web de Luma, 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 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

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

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 el 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 has tenido Luma Platform Tutorial seleccionado como su biblioteca de trabajo para los últimos ejercicios, los cambios recientes se han guardado 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 en el botón azul y seleccionar Guardar en biblioteca y crear
    Añadir 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. Abra el Sitio web de Luma
  2. Asígnelo a la propiedad de etiquetas mediante Debugger, según las instrucciones anteriores
  3. Seleccione el Iniciar 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 Experience Platform en Debugger (SDK web de Adobe Experience Platform > Solicitudes de red > eventos de la solicitud más reciente) y debería ver el lumaCrmId:
    Validación de 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.
    Validación de 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 flujo continuo, puede eliminar la Prod zona protegida de su Luma Tutorial Platform perfil de producto

Ingenieros de datos, si lo desea, puede pasar al lección ejecutar consultas.

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

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