S’abonner aux notifications de Événement d’Adobe I/O

Observability Insights vous permet de vous abonner à des notifications Adobe I/O Événement concernant les activités Adobe Experience Platform. Ces événements sont envoyés à un crochet Web configuré pour faciliter l'automatisation efficace de la surveillance des activités.

Ce document décrit la procédure à suivre pour s'abonner aux notifications événement Adobe I/O pour les services Adobe Experience Platform. Des informations de référence sur les types d'événement disponibles sont également fournies, ainsi que des liens vers d'autres documents sur la façon d'interpréter les données de événement renvoyées pour chaque service Platform applicable.

Prise en main

Ce document nécessite une bonne compréhension des hameçons Web et de la façon de connecter un hameçon Web d'une application à une autre. Consultez la I/O Events documentation pour une présentation des hameçons Web.

Création d’un hook Web

Pour recevoir des notifications I/O Event, vous devez enregistrer un webhook en spécifiant une URL webhook unique dans les détails d'enregistrement de votre événement.

Vous pouvez configurer votre webhook à l’aide du client de votre choix. Pour utiliser une adresse webhook temporaire dans le cadre de ce didacticiel, visitez Webhook.site et copiez l’URL unique fournie.

Au cours du processus de validation initial, I/O Events envoie un paramètre de requête challenge dans une demande de GET au hook Web. Vous devez configurer votre webhook pour renvoyer la valeur de ce paramètre dans la charge utile de réponse. Si vous utilisez Webhook.site, sélectionnez Edit dans le coin supérieur droit, puis saisissez $request.query.challenge$ sous Response body avant de sélectionner Save.

Créer un projet dans la console de développement Adobe

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

S'abonner aux événements

Une fois que vous avez créé un nouveau projet, accédez à l’écran d’aperçu de ce projet. À partir de là, sélectionnez Ajouter le événement.

Une boîte de dialogue s’affiche, vous permettant d’ajouter un fournisseur de événement à votre projet :

  • Si vous vous abonnez à des notifications Experience Platform, sélectionnez Notifications de plateforme.
  • Si vous vous abonnez à des notifications Adobe Experience Platform Privacy Service, sélectionnez Événements Privacy Service.

Une fois que vous avez choisi un fournisseur de événement, sélectionnez Suivant.

L’écran suivant affiche une liste de types d'événement auxquels s’abonner. Sélectionnez les événements auxquels vous souhaitez vous abonner, puis Suivant.

REMARQUE

Si vous ne savez pas quels événements vous souhaitez vous abonner au service que vous utilisez, consultez la documentation de notification spécifique au service :

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. Sélectionnez la zone d’options pour Générer une paire de clés, puis sélectionnez 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. Sélectionnez Suivant pour continuer.

Dans l’écran suivant, indiquez le nom et la description de l’enregistrement du événement dans la section Détails 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, sous la section Comment recevoir des événements, vous pouvez éventuellement configurer comment recevoir des événements. ​Webhooking 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 à l’aide de Adobe I/O Runtime.

Pour ce didacticiel, sélectionnez Webhook et indiquez l’URL du webhook que vous avez créé précédemment. Une fois que vous avez terminé, sélectionnez 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 modifier sa configuration, examiner les événements reçus, effectuer le suivi du débogage et ajouter de nouveaux fournisseurs de événement.

Étapes suivantes

En suivant ce tutoriel, vous avez enregistré un webhook pour recevoir des notifications I/O Event pour Experience Platform et/ou Privacy Service. Pour plus d’informations sur les événements disponibles et sur la façon d’interpréter les charges utiles de notification pour chaque service, consultez la documentation suivante :

Voir Observability Insights présentation pour plus d'informations sur la façon de surveiller vos activités sur Experience Platform et Privacy Service.

Sur cette page