Notificaciones de ingesta de datos

El proceso de ingesta de datos en Adobe Experience Platform consta de varios pasos. Una vez identificados los archivos de datos que deben ingerirse en PlatformSin embargo, el proceso de ingesta comienza y cada paso se produce de forma consecutiva hasta que los datos se incorporan correctamente o fallan. El proceso de ingesta se puede iniciar utilizando la variable API de ingesta por lotes de Adobe Experience Platform o utilizando el Experience Platform interfaz de usuario.

Datos cargados en Platform debe pasar por varios pasos para llegar a su destino, la variable Data Lake o el Real-Time Customer Profile almacén de datos. Cada paso implica procesar los datos, validarlos y, a continuación, almacenarlos antes de pasarlos al siguiente paso. Según la cantidad de datos que se esté introduciendo, este puede convertirse en un proceso laborioso y siempre existe la posibilidad de que el proceso falle debido a errores de validación, semántica o procesamiento. En caso de error, es necesario corregir los problemas de datos y, a continuación, reiniciar todo el proceso de ingesta con los archivos de datos corregidos.

Para ayudar a monitorizar el proceso de ingesta, Experience Platform permite suscribirse a un conjunto de eventos publicados por cada paso del proceso, lo que le notifica el estado de los datos introducidos y cualquier posible error.

Registrar un webhook para notificaciones de ingesta de datos

Para recibir notificaciones de ingesta de datos, debe utilizar Consola de Adobe Developer para registrar un webhook en su integración de Experience Platform.

Siga el tutorial de suscripción a Adobe I/O Event notificaciones para ver los pasos detallados sobre cómo hacerlo.

Recibir notificaciones de ingesta de datos

Una vez que haya registrado correctamente su webhook y se hayan introducido nuevos datos, puede empezar a recibir notificaciones de eventos. Estos eventos se pueden ver mediante el propio webhook o seleccionando el Seguimiento de depuración en la información general del registro de eventos del proyecto en la consola de Adobe Developer.

El siguiente JSON es un ejemplo de una carga útil de notificación que se enviaría a su webhook en caso de que se produzca un evento de ingesta por lotes fallido:

{
  "event_id": "93a5b11a-b0e6-4b29-ad82-81b1499cb4f2",
  "event": {
    "xdm:ingestionId": "01EGK8H8HF9JGFKNDCABHGA24G",
    "xdm:customerIngestionId": "01EGK8H8HF9JGFKNDCABHGA24G",
    "xdm:imsOrg": "{ORG_ID}",
    "xdm:completed": 1598374341560,
    "xdm:datasetId": "5e55b556c2ae4418a8446037",
    "xdm:eventCode": "ing_load_failure",
    "xdm:sandboxName": "prod",
    "sentTime": "1598374341595",
    "processStartTime": 1598374342614,
    "transformedTime": 1598374342621,
    "header": {
      "_adobeio": {
        "imsOrgId": "{ORG_ID}",
        "providerMetadata": "aep_observability_catalog_events",
        "eventCode": "platform_event"
      }
    }
  }
}

Para ver el esquema completo de las notificaciones de eventos, consulte la repositorio público de GitHub.

Pasos siguientes

Una vez registrado Platform notificaciones al proyecto, puede ver los eventos recibidos desde el Resumen del proyecto. Consulte la guía de seguimiento de eventos de Adobe I/O para obtener instrucciones detalladas sobre cómo realizar un seguimiento de los eventos.

Apéndice

La siguiente sección contiene información adicional sobre la interpretación de las cargas útiles de notificación de ingesta de datos.

Eventos de notificación de estado disponibles event-codes

En la tabla siguiente se enumeran las notificaciones de estado de ingesta de datos disponibles a las que puede suscribirse.