Adobe I/O-Ereignis-Benachrichtigungen abonnieren

Observability Insights können Sie Adobe I/O-Ereignis-Benachrichtigungen zu Adobe Experience Platform-Aktivitäten abonnieren. Diese Ereignis werden an einen konfigurierten Webshaken gesendet, um eine effiziente Automatisierung der Aktivität-Überwachung zu ermöglichen.

In diesem Dokument wird beschrieben, wie Sie Adobe I/O-Ereignis-Benachrichtigungen für Adobe Experience Platform-Dienste abonnieren. Es werden auch Referenzinformationen zu verfügbaren Ereignistypen sowie Links zu weiteren Dokumentationen zur Interpretation der zurückgegebenen Ereignis-Daten für jeden einzelnen Platform Dienst bereitgestellt.

Erste Schritte

Dieses Dokument erfordert ein funktionierendes Verständnis von Webhooks und wie ein Webhaken von einer Anwendung zur anderen verbunden werden kann. Eine Einführung in Webhooks finden Sie in der I/O Events Dokumentation .

Erstellen eines Webhofs

Um I/O Event Benachrichtigungen zu erhalten, müssen Sie einen Webshaken registrieren, indem Sie im Rahmen Ihrer Ereignis-Registrierungsdetails eine eindeutige Webshaken-URL angeben.

Sie können Ihren Webshaken mit dem Client Ihrer Wahl konfigurieren. Für eine temporäre Webhosting-Adresse, die im Rahmen dieses Lernprogramms verwendet werden soll, besuchen Sie WebHook.site und kopieren Sie die angegebene eindeutige URL.

Während des anfänglichen Validierungsprozesses I/O Events sendet ein Parameter der challenge Abfrage in einer GET an den Webshaken. Sie müssen Ihren Webshaken so konfigurieren, dass der Wert dieses Parameters in der Antwortnutzlast zurückgegeben wird. Wenn Sie WebHook.site verwenden, wählen Sie Edit oben rechts aus und geben Sie dann $request.query.challenge$ unter ein, Response body bevor Sie Save auswählen.

Neues Projekt in der Adobe Developer Console erstellen

Go to Adobe Developer Console and sign in with your Adobe ID. Führen Sie anschließend die im Lernprogramm zum Erstellen eines leeren Projekts in der Dokumentation zur Adobe Developer Console beschriebenen Schritte aus.

Ereignisse abonnieren

Nachdem Sie ein neues Projekt erstellt haben, navigieren Sie zum Übersichtsbildschirm dieses Projekts. Wählen Sie von hier Hinzufügen Ereignis.

Es wird ein Dialogfeld angezeigt, in dem Sie einen Ereignis Provider zu Ihrem Projekt hinzufügen können:

  • Wenn Sie Experience Platform Benachrichtigungen abonnieren, wählen Sie Plattformbenachrichtigungen aus.
  • Wenn Sie Adobe Experience Platform- Privacy Service Benachrichtigungen abonnieren, wählen Sie Privacy Service-Ereignis

Wählen Sie nach Auswahl eines Ereignis-Providers die Option Weiter.

Im nächsten Bildschirm wird eine Liste von Ereignistypen angezeigt, die abonniert werden sollen. Wählen Sie die Ereignis aus, die Sie abonnieren möchten, und wählen Sie dann Weiter.

HINWEIS

Wenn Sie nicht sicher sind, welche Ereignis für den Dienst, mit dem Sie arbeiten, abonniert werden sollen, lesen Sie die dienstspezifische Benachrichtigungsdokumentation:

Im nächsten Bildschirm werden Sie aufgefordert, ein JSON-WebToken (JWT) zu erstellen. Sie haben die Möglichkeit, automatisch ein Schlüsselpaar zu erstellen oder einen eigenen öffentlichen Schlüssel hochzuladen, der im Terminal generiert wurde.

Für diese Übung wird die erste Option verwendet. Wählen Sie das Optionsfeld für ein Schlüsselpaar erstellen und klicken Sie dann unten rechts auf die Schaltfläche " Generate keypair ".

Wenn das Schlüsselpaar generiert wird, wird es automatisch vom Browser heruntergeladen. Sie müssen diese Datei selbst speichern, da sie nicht in der Developer Console beibehalten wird.

Im nächsten Bildschirm können Sie die Details des neu generierten Schlüsselpaars überprüfen. Select Next to continue.

Geben Sie im nächsten Bildschirm im Abschnitt mit den Registrierungsdetails des Ereignisses einen Namen und eine Beschreibung für die Registrierung des Ereignisses ein . Best Practice ist, einen eindeutigen, leicht identifizierbaren Namen zu erstellen, um diese Ereignis-Registrierung von anderen im selben Projekt zu unterscheiden.

Weiter unten auf dem gleichen Bildschirm unter dem Abschnitt So erhalten Sie Ereignis können optional konfigurieren, wie Ereignis empfangen werden. Mit WebHook können Sie eine benutzerdefinierte Webhook-Adresse für den Empfang von Ereignissen angeben, während die Laufzeitaktion es Ihnen ermöglicht, dasselbe mit Adobe I/O Runtimezu tun.

Wählen Sie für dieses Lernprogramm " WebHook "und geben Sie die URL des zuvor erstellten Webhofs ein. Wenn Sie fertig sind, wählen Sie Konfigurierte Ereignis speichern, um die Ereignis-Registrierung abzuschließen.

Die Detailseite für die neu erstellte Ereignis-Registrierung wird angezeigt, auf der Sie die Konfiguration bearbeiten, die empfangenen Ereignis überprüfen, die Debugging-Verfolgung durchführen und neue Ereignis-Provider hinzufügen können.

Nächste Schritte

Mit diesem Tutorial haben Sie sich für den Erhalt von I/O Event Benachrichtigungen für Experience Platform und/oder Privacy Serviceeinen Webhook registriert. Weitere Informationen zu verfügbaren Ereignissen und zur Interpretation der Benachrichtigungs-Nutzlasten für jeden Dienst finden Sie in der folgenden Dokumentation:

Weitere Informationen dazu, wie Sie Ihre Aktivitäten überwachen können, finden Sie in der Observability Insights Übersicht Experience Platform Privacy Service.

Auf dieser Seite