Configuración de eventos

Objective

After completing this lesson, you will be able to configure la aplicación fuente para aceptar eventos enviados a SAP Customer Data Platform para su ingesta.

Introducción

Los eventos de aplicación se utilizan para configurar cómo SAP Customer Data Platform ingiere datos de cliente de sistemas externos. Estos eventos incluyen datos proporcionados voluntariamente por un cliente, también conocidos como datos de primera parte, y datos proporcionados por otros, que pueden ser datos de terceros, visitantes o datos fuera de línea.

Los ejemplos incluyen datos de la lista de deseos de un cliente, datos de pedidos o datos de navegación de productos, etc.

En la siguiente imagen, vemos una página Configuración de evento (paso 1) que muestra información básica, como Nombre, Tipo de datos, Descripción, así como otra información, por ejemplo:

  • Fines de procesamiento necesarios: para los casos de fusión de datos de cliente, la información entrante (datos de evento) deberá concederse para todos los objetivos de procesamiento configurados en esta opción; de lo contrario, se descartará.
  • Fines de Procesamiento Otorgados: durante la ingesta, se otorgará al cliente los Fines de Procesamiento configurados en este campo.
  • Vía de acceso del archivo de lectura: debido a que la aplicación fuente es un almacenamiento en la nube, puede indicar qué carpeta debe buscar SAP CDP para que se ingieran los datos del cliente.
  • Nombre de archivo Regex: solo los nombres de archivo que coincidan con la expresión regular configurada en este campo se tendrán en cuenta para la ingesta.
  • Formato de archivo para leer: aquí se fija si el formato de los archivos de entrada de texto que se van a ingerir es JSON o CSV.
  • Mover después de ingerir: ¿desea que los archivos de entrada se muevan a otra carpeta después de que se ingiera su contenido?
Configuración de evento que muestra Nombre, Tipo de datos, Objetivos de procesamiento necesarios y concedidos, Descripción y opciones adicionales como Leer vía de acceso de archivo, Expresión regular de nombre de archivo, Formato de archivo para leer y Mover después de ingerir.

Esquema de evento

Cada atributo del esquema de eventos tiene reglas de preparación de datos, aplicadas antes de que se ingieran los datos del evento. Preparación de Datos significa que los datos del cliente se validan, normalizan y transforman durante la fase de ingesta.

En la imagen siguiente, vemos una página de Modelo de evento (paso 2). Aquí podemos ver los tipos y nombres de los campos. Se pueden crear campos nuevos con el botón Crear nodo nuevo. El modelo de evento se puede definir mediante la IU o el esquema JSON. También existe la opción de soltar un archivo que contiene datos de muestra de un único perfil de cliente y el sistema define el esquema en función de su contenido. El atributo masterDataId se utilizará en el paso 3 como una regla de coincidencia de evento. Los atributos cuando y eventId se utilizarán en la configuración de metadatos.

Página Modelo de configuración de evento que contiene la definición de esquema que coincide con la estructura de los datos que debe ingerir el evento.

Los esquemas de evento admiten varios tipos de datos para los atributos o campos de evento, como Cadena, Número, Booleano e incluso Objeto y Matriz. Con el tipo de campo Objeto, puede anidar campos para ingerir tipos de datos complejos. Los datos de evento o los valores de atributo de evento se pueden validar mediante patrones integrados, por ejemplo, dirección de correo electrónico, fecha y hora y URL, imitando las funciones del editor de atributos Esquemas de cliente.

Propiedades comunes de uno de los atributos del modelo de evento que contiene los campos Tipo, Conmutador de tipo, Como matriz, Nombre, Nombre de visualización y Descripción.

Para una lógica de validación más compleja, puede especificar manualmente un patrón de expresión regular para comprobar los valores de campo o proporcionar una lista de valores de enumeración permitidos.

Validación de un atributo de modelo de evento. El conmutador de validación está activado, Tipo de validación es Por formato, Formato es Regex, el Patrón busca una palabra en minúscula que empiece por una letra mayúscula y la cadena Brandson se utiliza como Texto de prueba (para probar el patrón).

Los valores de atributo de evento también se pueden normalizar para eliminar puntuación y espacios dentro del campo de datos. Puede buscar y sustituir partes específicas del campo de datos por expresiones regulares. Esto significa que puede realizar verificaciones de calidad en los datos del evento utilizando sus propias reglas de depuración de datos antes de introducirlos en SAP Customer Data Platform.

Normalización de un atributo de modelo de evento. El conmutador de normalización está activado, la eliminación de Puntuación y Espacios está marcada.

Metadatos de evento

La configuración de metadatos de evento es responsable de dos opciones importantes:

ID de deduplicación
Se utiliza para identificar el registro de payload de entrada. Normalmente se trata de un UUID generado o, a veces, incluso de una suma de verificación. Se utiliza en el caso de que el payload fuente tenga varias ocurrencias del mismo registro de datos de cliente; si es así, el sistema puede descartar de forma segura las subsiguientes.
Campo de cronomarcador
Se utiliza para informar a SAP CDP de la última vez que se creó o actualizó esta información. SAP CDP utilizará este valor para trazar esta parte de los datos del cliente en un cronograma al procesar información estratégica y gráficos urgentes, o para realizar ingestiones delta de fecha límite.
Pantalla de metadatos con campos eventId y When vinculados a ID de deduplicación y campo de cronomarcador, respectivamente. El formato de campo de cronomarcador se puede personalizar utilizando el formato de cronomarcador.

Asignación de reglas coincidentes

Este es el paso en el que asignará los atributos del identificador de aplicación que desea utilizar en función de la información del identificador de datos de cliente que tenga disponible en el esquema de modelo de evento.

En la imagen, vemos una página de Modelo de evento (paso 3). En la parte izquierda, puede seleccionar cualquier atributo disponible en el Modelo de evento (esquema de payload de entrada) que se pueda vincular a las Reglas de coincidencia existentes que aparecen en la parte derecha. Como puede ver, masterDataId se ha arrastrado desde el lado izquierdo y se ha soltado en la correspondiente regla de coincidencia masterDataId en el lado derecho, creando un enlace Identificador de aplicación entre el atributo masterDataId del modelo de evento y su contraparte de perfil.

Si necesita configurar un identificador de aplicación compuesto, se pueden combinar varios atributos de modelo de evento si los arrastra y suelta en el mismo atributo de destino.

Asignación de reglas de coincidencia que contiene el esquema Modelo de evento en la parte izquierda y las Reglas de coincidencia en la parte derecha. El atributo masterDataId está vinculado como regla de coincidencia de evento.

Asignación de esquema

En este paso vinculará los atributos restantes del modelo de evento a sus contrapuntos de datos de cliente, ya sean datos de cliente de perfil, grupo o actividad. Puede elegir:

  • mapee solo los que necesite
  • asignar el mismo atributo de modelo de evento a varios destinos
  • asignar varios atributos del modelo de evento a un único destino
  • configurar transformaciones para cada valor de atributo durante el pipeline de ingesta

En la siguiente imagen, vemos una página Asignación de esquema (paso 4). Podemos ver el nombre y los apellidos, así como el atributo de sexo asignado desde el Modelo de evento en el lado izquierdo a los atributos de Perfil en el lado derecho, similar a la forma en que ocurrió durante el paso anterior (Asignación de reglas de coincidencia).

Asignación de esquema que contiene el esquema Modelo de evento en la parte izquierda y los atributos Perfil en la parte derecha. Los atributos firstName, lastName y género están vinculados a sus contrapartes de atributos de perfil de datos de cliente.

Sondeo programado

En el último paso, opcionalmente puede activar la programación para extraer nuevos datos de evento de la fuente en un intervalo determinado a partir de una fecha y hora específicas. Tenga en cuenta que algunos conectores de aplicación fuente pueden tener esta opción, mientras que otros pueden proporcionar un punto final HTTP REST que las aplicaciones fuente pueden utilizar para introducir datos de cliente en SAP Customer Data Platform.

Página Sondeo programado que muestra las opciones que se suelen encontrar en los sistemas de programación, como la fecha y hora de inicio y el intervalo de repetición.

Función Ingerir ahora

Algunas aplicaciones fuente le permitirán iniciar manualmente la ingesta de datos de clientes siempre que sea necesario. Verifique si está disponible en el menú contextual de la tarjeta Evento (tres puntos en la parte superior derecha de la tarjeta Evento) utilizando la opción Ingerir ahora. Debe seleccionar una fecha y hora de corte mediante el campo Desde. Para cada registro de datos de cliente obtenidos de la fuente, el sistema solo considerará ingerirlo cuando su atributo Cronomarcador de metadatos de evento sea mayor o igual a lo que ha fijado en el campo Desde. Opcionalmente, también puede colocar un límite superior para el número de registros de datos de cliente aplicados al pipeline de ingesta al fijar el campo Límite.

Ingerir ahora que muestra los campos Desde y Límite.

Estado de evento

El estado de las ingestiones procesadas para cada Evento se conservará durante 7 días en el sistema y se puede analizar rápidamente mediante la opción Ver estado del menú contextual de la tarjeta Evento. Para cada ingesta, esta opción mostrará el número de registros ingeridos y el estado de finalización. Para un análisis más profundo de los problemas con las ingestiones de datos del cliente, considere utilizar la función Supervisión. Puede obtener más información al respecto consultando Supervisión de ingesta de datos de cliente en SAP Customer Data Platform.

El Estado del evento muestra dos lotes de ingestiones pasadas: una que se realizó correctamente, tardó 5 segundos e ingirió 100 registros y otra falló.

Zona de juegos para eventos

Event Playground le permite ingerir un único registro de datos de clientes dentro de SAP Customer Data Platform Console, incluidos los datos de perfil, grupo y actividad. Para ello, crea un formulario de IU que coincide con los campos de atributo del modelo de evento. Los datos de muestra se generan aleatoriamente para cada campo en función de su tipo y formato. Después de enviar el formulario, el sistema muestra los resultados de la ingesta en una pantalla que muestra cada uno de los pasos del pipeline de ingesta, incluidos los posibles fallos.

Pantalla de zona de juegos de eventos que muestra algunos datos de perfil de cliente de muestra.Resultados de una ingestión de Event Playground que muestra algunos de los pasos del pipeline.

Configuración de eventos entrantes: demostración

Resumen

En esta lección, ha aprendido a configurar SAP Customer Data Platform para ingerir de forma eficiente datos de cliente de fuentes externas configurando eventos de aplicación. Ha explorado varios componentes de la configuración del evento, desde la especificación de la fuente y el formato de archivo hasta la asignación de esquemas y la configuración de metadatos de evento. Las tareas esenciales incluyen la configuración de las opciones de evento, donde se definen los objetivos de procesamiento necesarios, los patrones de nombres de archivo y los protocolos de ingesta, como mover archivos después de la ingesta. El esquema de eventos desempeña un papel crucial al permitir la validación y transformación de datos, garantizando la integridad de los datos antes de la ingesta.

Además, ha examinado la importancia de los metadatos de evento en la deduplicación y el seguimiento de cronomarcador, lo que ayuda a gestionar los datos de forma eficiente mediante identificadores. Ha practicado la asignación de reglas de coincidencia y atributos de esquema para alinear los datos del evento con los perfiles de cliente, los grupos y las actividades, lo que garantiza una integración de datos perfecta. Con opciones como el sondeo programado y la ingesta manual, puede controlar de forma efectiva cómo y cuándo se incorporan los datos a la plataforma. En la lección también se presentaron funciones como Event Playground y Event Status, que permiten la prueba de datos en tiempo real y la supervisión de la ingesta. Al dominar estas configuraciones, usted está equipado para maximizar las capacidades de SAP CDP en el manejo de conjuntos de datos de clientes diversos y complejos para crear información estratégica accionable.