Abbonati alle notifiche di eventi di Adobe I/O

Observability Insights ti consente di abbonarti alle notifiche degli eventi di Adobe I/O relative alle attività di Adobe Experience Platform. Questi eventi vengono inviati a un webhook configurato per facilitare l’automazione efficiente del monitoraggio delle attività.

In questo documento vengono descritti i passaggi necessari per iscriversi alle notifiche degli eventi Adobe I/O per i servizi Adobe Experience Platform. Vengono inoltre fornite informazioni di riferimento sui tipi di evento disponibili, insieme ai collegamenti a ulteriore documentazione su come interpretare i dati di evento restituiti per ogni servizio Platform applicabile.

Introduzione

Questo documento richiede una buona conoscenza dei webhook e di come collegarli da un'applicazione a un'altra. Per un'introduzione ai webhook, consulta la I/O Events documentazione.

Creare un webhook

Per ricevere le notifiche di I/O Event, è necessario registrare un webhook specificando un URL univoco come parte dei dettagli di registrazione dell'evento.

Puoi configurare il webhook utilizzando il client desiderato. Per un indirizzo del webhook temporaneo da utilizzare come parte di questa esercitazione, visita Webhook.site e copia l'URL univoco fornito.

Durante il processo di convalida iniziale, I/O Events invia un parametro di query challenge in una richiesta GET al webhook. Devi configurare il webhook in modo che restituisca il valore di questo parametro nel payload di risposta. Se utilizzi Webhook.site, seleziona Edit nell'angolo in alto a destra, quindi immetti $request.query.challenge$ in Response body prima di selezionare Save.

Crea un nuovo progetto in Adobe Developer Console

Vai a Adobe Developer Console e accedi con il tuo Adobe ID. Quindi, segui i passaggi descritti nel tutorial su creazione di un progetto vuoto nella documentazione di Adobe Developer Console.

Iscriviti agli eventi

Dopo aver creato un nuovo progetto, passa alla schermata di panoramica del progetto. Selezionare Aggiungi evento.

Viene visualizzata una finestra di dialogo che consente di aggiungere un provider di eventi al progetto:

Dopo aver scelto un provider di eventi, seleziona Avanti.

Nella schermata successiva viene visualizzato un elenco dei tipi di evento a cui iscriversi. Seleziona gli eventi a cui vuoi abbonarti, quindi seleziona Successivo.

Nella schermata successiva viene richiesto di creare un token web JSON (JWT). Puoi generare automaticamente una coppia di chiavi o caricare la tua chiave pubblica generata nel terminale.

Ai fini di questa esercitazione, viene seguita la prima opzione. Seleziona la casella delle opzioni per Generare una coppia di chiavi, quindi seleziona il pulsante Generate keypair nell'angolo in basso a destra.

Quando la coppia di chiavi viene generata, viene scaricata automaticamente dal browser. Devi archiviare questo file da solo in quanto non viene mantenuto in Developer Console.

La schermata successiva consente di rivedere i dettagli della coppia di chiavi appena generata. Seleziona Avanti per continuare.

Nella schermata successiva, fornisci un nome e una descrizione per la registrazione dell'evento nella sezione Dettagli registrazione evento. Si consiglia di creare un nome univoco e facilmente identificabile per distinguere la registrazione di questo evento da quella di altri sullo stesso progetto.

Più in basso nella stessa schermata nella sezione Come ricevere gli eventi, puoi facoltativamente configurare la modalità di ricezione degli eventi. Webhook consente di fornire un indirizzo webhook personalizzato per la ricezione di eventi, mentre Azione runtime consente di eseguire la stessa operazione utilizzando Adobe I/O Runtime.

Per questo tutorial, seleziona Webhook e fornisci l'URL del webhook creato in precedenza. Al termine, selezionare Salva eventi configurati per completare la registrazione dell'evento.

Viene visualizzata la pagina dei dettagli per la registrazione dell'evento appena creata, in cui è possibile modificarne la configurazione, esaminare gli eventi ricevuti, eseguire la traccia di debug e aggiungere nuovi provider di eventi.

Passaggi successivi

Seguendo questa esercitazione, hai registrato un webhook per ricevere I/O Event notifiche per Experience Platform e/o Privacy Service. Per informazioni dettagliate sugli eventi disponibili e su come interpretare i payload di notifica per ciascun servizio, consulta la seguente documentazione:

Per ulteriori informazioni su come monitorare le attività in Experience Platform e Privacy Service, consulta la Observability Insights panoramica.