Suscribirse a las notificaciones de eventos de Adobe I/O

Observability Insights le permite suscribirse a las notificaciones de eventos de Adobe I/O relacionados con las actividades de Adobe Experience Platform. Estos eventos se envían a un webhook configurado para facilitar la automatización eficaz de la monitorización de la actividad.

Este documento proporciona pasos sobre cómo puede suscribirse a las notificaciones de eventos de Adobe I/O para los servicios de Adobe Experience Platform. También se proporciona información de referencia sobre los tipos de eventos disponibles, junto con vínculos a documentación adicional sobre cómo interpretar los datos de eventos devueltos para cada servicio Platform aplicable.

Introducción

Este documento requiere una comprensión práctica de los webhooks y cómo conectar un webhook de una aplicación a otra. Consulte la I/O Events documentación para ver una introducción a los webhooks.

Crear un webhook

Para recibir notificaciones de I/O Event, debe registrar un webhook especificando una URL de webhook única como parte de los detalles de registro del evento.

Puede configurar su webhook usando el cliente de su elección. Para que una dirección de webhook temporal se use como parte de este tutorial, visite Webhook.site y copie la dirección URL única proporcionada.

Durante el proceso de validación inicial, I/O Events envía un parámetro de consulta challenge en una solicitud de GET al webhook. Debe configurar el webhook para que devuelva el valor de este parámetro en la carga útil de respuesta. Si usa Webhook.site, seleccione Edit en la esquina superior derecha y, a continuación, escriba $request.query.challenge$ en Response body antes de seleccionar Save.

Creación de un nuevo proyecto en Adobe Developer Console

Vaya a la consola de desarrollador de Adobe e inicie sesión con su Adobe ID. A continuación, siga los pasos descritos en el tutorial sobre creación de un proyecto vacío en la documentación de Adobe Developer Console.

Suscribirse a eventos

Una vez creado un nuevo proyecto, vaya a la pantalla de información general de ese proyecto. Aquí, seleccione Agregar evento.

Aparece un cuadro de diálogo que le permite agregar un proveedor de eventos al proyecto:

Cuando haya elegido un proveedor de eventos, seleccione Siguiente.

La siguiente pantalla muestra una lista de tipos de eventos a los que suscribirse. Seleccione los eventos a los que desea suscribirse y, a continuación, seleccione Siguiente.

La siguiente pantalla le solicita que cree un token web JSON (JWT). Se le da la opción de generar automáticamente un par de claves o cargar su propia clave pública generada en el terminal.

A los efectos de este tutorial, se sigue la primera opción. Seleccione el cuadro de opción para Generar un par de claves y, a continuación, seleccione el botón Generar par de claves en la esquina inferior derecha.

Cuando se genera el par de claves, el explorador lo descarga automáticamente. Debe almacenar este archivo, ya que no persiste en Developer Console.

La siguiente pantalla le permite revisar los detalles del par de claves recién generado. Haga clic en Siguiente para continuar.

En la siguiente pantalla, proporcione un nombre y una descripción para el registro del evento en la sección Detalles de registro del evento. Una práctica recomendada es crear un nombre único y fácilmente identificable para ayudar a diferenciar este registro de evento de otros en el mismo proyecto.

Más abajo en la misma pantalla, en la sección Cómo recibir eventos, puede configurar de forma opcional cómo recibir eventos. Webhook le permite proporcionar una dirección de webhook personalizada para recibir eventos, mientras que Acción en tiempo de ejecución le permite hacer lo mismo con Adobe I/O Runtime.

Para este tutorial, seleccione Webhook y proporcione la URL del webhook que creó anteriormente. Una vez finalizado, seleccione Guardar eventos configurados para completar el registro de eventos.

Aparece la página de detalles del registro de eventos recién creado, donde puede editar su configuración, revisar los eventos recibidos, realizar un seguimiento de la depuración y agregar nuevos proveedores de eventos.

Pasos siguientes

Siguiendo este tutorial, ha registrado un webhook para recibir I/O Event notificaciones para Experience Platform y/o Privacy Service. Para obtener más información sobre los eventos disponibles y cómo interpretar las cargas útiles de notificación para cada servicio, consulte la siguiente documentación:

Consulte la Observability Insights descripción general para obtener más información sobre cómo supervisar las actividades de Experience Platform y Privacy Service.