Show Menu
TEMAS×

Notificaciones de ingestión de datos

El proceso de ingesta de datos en Adobe Experience Platform consta de varios pasos. Una vez que se identifican los archivos de datos que se deben ingerir en Platform, se inicia el proceso de ingestión y cada paso se produce de forma consecutiva hasta que los datos se ingieren correctamente o se producen errores. El proceso de ingestión se puede iniciar mediante la API de ingestión de datos de Adobe Experience Platform o mediante la interfaz de Experience Platform usuario.
Los datos cargados en Platform deben seguir varios pasos para llegar a su destino, al Data Lake o al almacén de datos Real-time Customer Profile . Cada paso implica el procesamiento de los datos, la validación de los datos y, a continuación, el almacenamiento de los datos antes de pasarlos al siguiente paso. Dependiendo de la cantidad de datos que se ingesten, este proceso puede llevar mucho tiempo y siempre hay una posibilidad de que el proceso falle debido a errores de validación, semántica o procesamiento. En el evento de un error, los problemas de datos deben corregirse y, a continuación, se debe reiniciar todo el proceso de ingestión utilizando los archivos de datos corregidos.
Para ayudar a supervisar el proceso de ingestión, Experience Platform permite suscribirse a un conjunto de eventos que se publican en cada paso del proceso, notificándole el estado de los datos ingestados y los posibles fallos.

Registro de un enlace web para notificaciones de ingesta de datos

Para recibir las notificaciones de ingestión de datos, debe utilizar Adobe Developer Console para registrar un enlace web en la integración de Experience Platform.
Siga el tutorial sobre la suscripción de Adobe I/O Event notificaciones para ver los pasos detallados sobre cómo hacerlo.
Durante el proceso de suscripción, asegúrese de seleccionar las notificaciones de plataforma como proveedor de evento y, cuando se le solicite, seleccione la suscripción de evento de notificaciones de ingesta de datos.

Recibir notificaciones de inserción de datos

Una vez que haya registrado correctamente su enlace web y que se hayan ingerido nuevos datos, puede recibir inicios para recibir notificaciones de evento. Estos eventos se pueden ver mediante el propio webgancho o seleccionando la ficha Seguimiento de depuración en la descripción general del registro de evento del proyecto en la consola de desarrollador de Adobe.
El siguiente JSON es un ejemplo de una carga útil de notificación que se enviaría a su enlace web en caso de un evento de ingestión por lotes fallido:
{
  "event_id": "93a5b11a-b0e6-4b29-ad82-81b1499cb4f2",
  "event": {
    "xdm:ingestionId": "01EGK8H8HF9JGFKNDCABHGA24G",
    "xdm:customerIngestionId": "01EGK8H8HF9JGFKNDCABHGA24G",
    "xdm:imsOrg": "{IMS_ORG}",
    "xdm:completed": 1598374341560,
    "xdm:datasetId": "5e55b556c2ae4418a8446037",
    "xdm:eventCode": "ing_load_failure",
    "xdm:sandboxName": "prod",
    "sentTime": "1598374341595",
    "processStartTime": 1598374342614,
    "transformedTime": 1598374342621,
    "header": {
      "_adobeio": {
        "imsOrgId": "{IMS_ORG}",
        "providerMetadata": "aep_observability_catalog_events",
        "eventCode": "platform_event"
      }
    }
  }
}

Propiedad
Descripción
event_id
ID única generada por el sistema para la notificación.
event
Objeto que contiene los detalles del evento que activó la notificación.
event.xdm:datasetId
ID del conjunto de datos al que se aplica el evento de ingestión.
event.xdm:eventCode
Código de estado que indica el tipo de evento que se activó para el conjunto de datos. Consulte el apéndice para conocer los valores específicos y sus definiciones.
Para vista del esquema completo de las notificaciones de evento, consulte el repositorio ingestion.schema.json público de GitHub.

Pasos siguientes

Una vez que haya registrado Platform las notificaciones al proyecto, puede realizar la vista de eventos recibidos desde la información general delproyecto. Consulte la guía sobre rastreo de Eventos de E/S de Adobe para obtener instrucciones detalladas sobre cómo rastrear sus eventos.

Apéndice

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

Eventos de notificación de estado disponibles

La siguiente tabla lista las notificaciones de estado de ingesta de datos disponibles a las que puede suscribirse.
Código de evento
Servicio de plataforma
Estado
Descripción del evento
ing_load_success
Data Ingestion
success
Un lote se ingerió correctamente en un conjunto de datos dentro del Data Lake.
ing_load_failure
Data Ingestion
error
No se pudo ingerir un lote en un conjunto de datos dentro del Data Lake.
ps_load_success
Real-time Customer Profile
success
Un lote se ha ingerido correctamente en el almacén Profile de datos.
ps_load_failure
Real-time Customer Profile
error
No se pudo ingerir un lote en el almacén Profile de datos.
ig_load_success
Identity Service
success
Los datos se cargaron correctamente en el gráfico de identidad.
ig_load_failure
Identity Service
error
No se pudieron cargar los datos en el gráfico de identidad.
Solo se proporciona un tema de evento para todas las notificaciones de ingesta de datos. Para distinguir entre distintos estados, se puede utilizar el código de evento.