Notifications d’ingestion de données

Le processus d’ingestion de données dans Adobe Experience Platform se compose de plusieurs étapes. Une fois que vous avez identifié les fichiers de données qui doivent être ingérés dans Platform, le processus d’ingestion commence et chaque étape se produit consécutivement jusqu’à ce que les données soient correctement ingérées ou échouent. Le processus d’ingestion peut être lancé à l’aide de la variable API d’ingestion par lots Adobe Experience Platform ou en utilisant la variable Experience Platform de l’interface utilisateur.

Données chargées dans Platform Pour atteindre sa destination, la variable Data Lake ou le Real-Time Customer Profile entrepôt de données. Chaque étape implique le traitement des données, leur validation, puis leur stockage avant de passer à l’étape suivante. En fonction de la quantité de données ingérée, ce processus peut devenir chronophage et il existe toujours une possibilité qu’il échoue en raison d’erreurs de validation, de sémantique ou de traitement. En cas d’échec, les problèmes de données doivent être résolus, puis l’ensemble du processus d’ingestion doit être redémarré en utilisant des fichiers de données corrigés.

Pour faciliter la surveillance du processus d’ingestion, Experience Platform permet de s’abonner à un ensemble d’événements publiés à chaque étape du processus, vous informant du statut des données ingérées et des échecs possibles.

Enregistrement d’un webhook pour les notifications d’ingestion de données

Pour recevoir des notifications d’ingestion de données, vous devez utiliser Console Adobe Developer pour enregistrer un webhook dans votre intégration Experience Platform.

Suivez le tutoriel sur abonnement à Adobe I/O Event notifications pour obtenir des instructions détaillées sur la manière d’y parvenir.

Réception de notifications d’ingestion de données

Une fois que vous avez enregistré votre webhook et que de nouvelles données ont été ingérées, vous pouvez commencer à recevoir des notifications d’événement. Ces événements peuvent être visualisés à l’aide du webhook lui-même ou en sélectionnant l’événement Suivi du débogage dans la vue d’ensemble de l’enregistrement des événements de votre projet dans la console Adobe Developer.

Le fichier JSON suivant est un exemple de payload de notification qui serait envoyé à votre webhook en cas d’échec d’un événement d’ingestion par lots :

{
  "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"
      }
    }
  }
}

Pour consulter le schéma complet des notifications d’événement, reportez-vous à la section référentiel GitHub public.

Étapes suivantes

Une fois que vous êtes enregistré Platform notifications à votre projet, vous pouvez afficher les événements reçus du Présentation du projet. Reportez-vous au guide sur la suivi des événements d’Adobe I/O pour obtenir des instructions détaillées sur la manière de suivre vos événements.

Annexe

La section suivante contient des informations supplémentaires sur l’interprétation des payloads des notifications d’ingestion de données.

Événements de notification d’état disponibles event-codes

Le tableau suivant répertorie les notifications d’état d’ingestion de données disponibles auxquelles vous pouvez vous abonner.