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 anwendbaren 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 zu Webhooks finden Sie in der I/O Events Dokumentation.

Erstellen eines Webhofs

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

Sie können Ihren Webshaken mit dem Client Ihrer Wahl konfigurieren. Um eine temporäre Webhosting-Adresse als Teil dieses Lernprogramms zu verwenden, besuchen Sie WebHaken.site und kopieren Sie die angegebene eindeutige URL.

Während des anfänglichen Validierungsprozesses sendet I/O Events einen challenge-Abfrage-Parameter in einer GET-Anforderung an den Webhaken. 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 in der oberen rechten Ecke aus und geben Sie $request.query.challenge$ unter Response body ein, bevor Sie Save auswählen.

Neues Projekt in der Adobe Developer Console erstellen

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

Ereignisse abonnieren

Nachdem Sie ein neues Projekt erstellt haben, navigieren Sie zum Übersichtsbildschirm dieses Projekts. Wählen Sie 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
  • Wenn Sie Adobe Experience Platform Privacy Service-Benachrichtigungen abonnieren, wählen Sie Privacy Service-Ereignis

Wenn Sie einen Ereignis-Provider ausgewählt haben, wählen Sie 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 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 Generate a key pair 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. Wählen Sie Weiter, um fortzufahren.

Geben Sie im nächsten Bildschirm im Abschnitt Registrierungsdetails für Ereignisse 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 Sie optional konfigurieren, wie Ereignis empfangen werden. Mit Webhooks können Sie eine benutzerdefinierte Webhook-Adresse für den Empfang von Ereignissen angeben, während Laufzeit- Aktionen es Ihnen ermöglichen, dasselbe mit Adobe I/O Runtime zu tun.

Wählen Sie für dieses Tutorial WebHaken aus und geben Sie die URL des zuvor erstellten WebHook 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

Indem Sie diesem Tutorial folgen, haben Sie einen Web-Haken 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-Nutzlasten für jeden Dienst finden Sie in der folgenden Dokumentation:

Weitere Informationen zur Überwachung Ihrer Aktivitäten unter Experience Platform und Privacy Service finden Sie unter Observability Insights overview.

Auf dieser Seite

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now