Show Menu
SUJETS×

Notifications d’assimilation de données

Le processus d’importation de données dans Adobe Experience Platform comprend plusieurs étapes. Une fois que vous avez identifié les fichiers de données à ingérer dans la plate-forme, le processus d’assimilation commence et chaque étape se produit consécutivement jusqu’à ce que les données soient correctement ingérées ou échouent. Le processus d’assimilation peut être lancé à l’aide de l’API d’administration des données de la plateforme Adobe Experience Platform ou à l’aide de l’interface utilisateur de la plate-forme Experience Platform.
Les données chargées dans Platform doivent passer par plusieurs étapes pour atteindre leur destination, Data Lake ou le magasin de données du Profil client en temps réel. Chaque étape implique de traiter les données, de les valider, puis de les stocker avant de les transmettre à l’étape suivante. Selon la quantité de données ingérées, ce processus peut prendre du temps et il est toujours possible que le processus échoue en raison d’erreurs de validation, de sémantique ou de traitement. En événement d’échec, les problèmes de données doivent être résolus, puis l’ensemble du processus d’assimilation doit être redémarré à l’aide des fichiers de données corrigés.
Pour faciliter le contrôle du processus d’assimilation, Experience Platform permet de s’abonner à un ensemble de événements publiés par chaque étape du processus, en vous informant de l’état des données assimilées et de tout échec éventuel.

événements de notification d'état disponibles

Vous trouverez ci-dessous une liste de notifications d'état d'assimilation de données à laquelle vous pouvez vous abonner.
Une seule rubrique de événement est fournie pour toutes les notifications d'assimilation de données. Pour distinguer les différents états, il est possible d'utiliser le code du événement.
Service Plateforme
État
Description des événements
Code Événement
Entrée de données
success
Ingestion - Le lot a réussi
ing_load_success
Entrée de données
échec
Ingestion - Échec du lot
ing_load_failure
Profil client en temps réel
success
Service de Profil - Lot de chargement de données terminé
ps_load_success
Profil client en temps réel
échec
Service de Profil - Échec du lot de chargement des données
ps_load_failure
Graphique d'identité
success
Graphique d’identité - Succès du lot de chargement des données
ig_load_success
Graphique d'identité
échec
Graphique d’identité - Échec du lot de chargement des données
ig_load_failure

schéma de charge utile de notification

Le schéma de événement de notification d’ingestion de données est un schéma de modèle de données d’expérience (XDM) contenant des champs et des valeurs qui fournissent des détails sur l’état des données ingérées. Veuillez visiter le repo public XDM GitHub afin de vue du dernier schéma de charge utile de notification.

S’abonner aux notifications d’état d’assimilation de données

Grâce aux Événements d’E/S Adobe, vous pouvez vous abonner à plusieurs types de notification à l’aide de hameçons Web. Les sections ci-dessous décrivent les étapes à suivre pour s’abonner aux notifications de plateforme pour les événements d’assimilation de données à l’aide d’Adobe Developer Console.

Création d’un projet dans Adobe Developer Console

Accédez à Adobe Developer Console et connectez-vous avec votre Adobe ID. Suivez ensuite les étapes décrites dans le didacticiel relatif à la création d’un projet vide dans la documentation d’Adobe Developer Console.

événements de la plateforme Ajouter expérience sur le projet

Une fois que vous avez créé un nouveau projet, accédez à l’écran d’aperçu de ce projet. De là, cliquez sur Ajouter événement .
La boîte de dialogue événements __Ajouter apparaît. Cliquez sur Plate-forme​ ​d’expérience pour filtrer la liste des options disponibles, puis sur Notifications​ de ​plateforme avant de cliquer sur​ Suivant .
L’écran suivant affiche une liste de types d'événement auxquels s’abonner. Sélectionnez Notification d’importation de données, puis cliquez sur Suivant .
L’écran suivant vous invite à créer un JSON Web Token (JWT). Vous avez la possibilité de générer automatiquement une paire de clés ou de télécharger votre propre clé publique générée dans le terminal.
Pour les besoins de ce didacticiel, la première option est suivie. Cochez la case d'option Générer une paire de clés, puis cliquez sur le bouton Générer la paire de clés dans le coin inférieur droit.
Lorsque la paire de clés est générée, elle est automatiquement téléchargée par le navigateur. Vous devez stocker ce fichier vous-même, car il n’est pas conservé dans la Console développeur.
L’écran suivant vous permet de vérifier les détails de la paire de clés nouvellement générée. Cliquez sur Suivant pour continuer.
Dans l’écran suivant, indiquez le nom et la description de l’enregistrement du événement. Il est recommandé de créer un nom unique et facilement identifiable afin de différencier cette inscription de événement des autres sur le même projet.
Plus loin dans le même écran, vous pouvez éventuellement configurer la manière de recevoir des événements. Webhook vous permet de fournir une adresse webhook personnalisée pour recevoir des événements, tandis que l’action ​Runtime vous permet de faire de même avec Adobe I/O Runtime .
Ce didacticiel ignore cette étape de configuration facultative. Une fois que vous avez terminé, cliquez sur Enregistrer les événements configurés pour terminer l’enregistrement du événement.
La page des détails de l'enregistrement de événement nouvellement créé s'affiche, dans laquelle vous pouvez consulter les événements reçus, effectuer le suivi du débogage et modifier sa configuration.

Étapes suivantes

Une fois que vous avez enregistré des notifications de plateforme à votre projet, vous pouvez vue recevoir des événements du tableau de bord du projet. Consultez le guide Suivi des Événements d’E/S Adobe pour obtenir des instructions détaillées sur la manière de suivre vos événements.