Abonnieren von Adobe I/O-Ereignisbenachrichtigungen

Mit Observability Insights können Sie Ereignisbenachrichtigungen zu Aktivitäten von Adobe Experience Platform abonnieren. Diese Ereignisse werden an einen konfigurierten Webhook gesendet, um eine effiziente Automatisierung der Aktivitätsüberwachung zu ermöglichen.

In diesem Dokument wird beschrieben, wie Sie Adobe I/O-Ereignisbenachrichtigungen für Adobe Experience Platform-Dienste abonnieren können. Es werden auch Referenzinformationen zu verfügbaren Ereignistypen sowie Links zur weiteren Dokumentation zur Interpretation der zurückgegebenen Ereignisdaten für jeden entsprechenden Platform-Dienst bereitgestellt.

Erste Schritte

Dieses Dokument setzt voraus, dass Sie mit Webhooks vertraut sind und wissen, wie Sie einen Webhook von einer Anwendung zu einer anderen verbinden. Eine Einführung in Webhooks finden Sie in der I/O Events Dokumentation.

Erstellen eines Webhooks

Um I/O Event-Benachrichtigungen zu erhalten, müssen Sie einen Webhook registrieren, indem Sie eine eindeutige Webhook-URL als Teil Ihrer Details zur Ereignisregistrierung angeben.

Sie können Ihren Webhook mit dem Client Ihrer Wahl konfigurieren. Eine temporäre Webhook-Adresse, die Sie im Rahmen dieses Tutorials verwenden können, finden Sie unter Webhook.site, von wo Sie die bereitgestellte eindeutige URL kopieren können.

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

Erstellen eines neuen Projekts in Adobe Developer Console

Wechseln Sie zur Adobe-Entwicklerkonsole und melden Sie sich mit Ihrer Adobe ID an. Führen Sie anschließend die Schritte aus, die im Tutorial Erstellen eines leeren Projekts in der Dokumentation zu Adobe Developer Console beschrieben werden.

Abonnieren von Ereignissen

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

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

Nachdem Sie einen Ereignisanbieter ausgewählt haben, klicken Sie auf Weiter.

Im nächsten Bildschirm wird eine Liste der Ereignistypen angezeigt, die abonniert werden können. Wählen Sie die Ereignisse aus, die Sie abonnieren möchten, und klicken Sie dann auf Weiter.

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

Für die Zwecke dieses Tutorials wird die erste Option verwendet. Wählen Sie das Optionsfeld für Schlüsselpaar generieren aus und klicken Sie dann unten rechts auf die Schaltfläche Schlüsselpaar generieren.

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. Klicken Sie auf Weiter, um fortzufahren.

Geben Sie im nächsten Bildschirm im Abschnitt Details zur Ereignisregistrierung einen Namen und eine Beschreibung für die Ereignisregistrierung ein. Es empfiehlt sich, einen eindeutigen, leicht identifizierbaren Namen zu wählen, um diese Ereignisregistrierung von anderen im selben Projekt zu unterscheiden.

Im selben Bildschirm können Sie unter dem Abschnitt Ereignisempfang weiter unten optional konfigurieren, wie Ereignisse empfangen werden sollen. Ein Webhook ermöglicht es Ihnen, eine benutzerdefinierte Webhook-Adresse für den Empfang von Ereignissen anzugeben, während Runtime-Aktionen das gleiche mit Adobe I/O Runtime ermöglichen.

Wählen Sie für dieses Tutorial Webhook aus und geben Sie die URL des zuvor erstellten Webhooks an. Nachdem Sie fertig sind, wählen Sie Konfigurierte Ereignisse speichern aus, um die Ereignisregistrierung abzuschließen.

Die Detailseite für die neu erstellte Ereignisregistrierung wird angezeigt. Dort können Sie die Konfiguration bearbeiten, die empfangenen Ereignisse überprüfen, eine Debugging-Verfolgung durchführen und neue Ereignisanbieter hinzufügen.

Nächste Schritte

In diesem Tutorial haben Sie einen Webhook registriert, um I/O Event-Benachrichtigungen für Experience Platform und/oder Privacy Service zu erhalten. Weitere Informationen zu verfügbaren Ereignissen und zur Interpretation der Benachrichtigungs-Payloads für jeden Service finden Sie in der folgenden Dokumentation:

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