Assinar notificações de eventos Adobe I/O

O Observability Insights permite que você assine notificações de eventos Adobe I/O relacionadas às atividades do Adobe Experience Platform. Esses eventos são enviados para um webhook configurado para facilitar a automação eficiente do monitoramento de atividades.

Este documento fornece etapas sobre como assinar notificações de eventos Adobe I/O para serviços da Adobe Experience Platform. Informações de referência sobre tipos de eventos disponíveis também são fornecidas, juntamente com links para documentação adicional sobre como você pode interpretar dados de eventos retornados para cada serviço Platform aplicável.

Introdução

Este documento requer uma compreensão funcional de webhooks e como conectar um webhook de um aplicativo a outro. Consulte a I/O Events documentação para obter uma introdução aos webhooks.

Criar um webhook

Para receber notificações do I/O Event, você deve registrar um webhook especificando uma URL de webhook exclusiva como parte dos detalhes de registro do evento.

Você pode configurar o webhook usando o cliente de sua escolha. Para obter um endereço de webhook temporário para usar como parte deste tutorial, visite Webhook.site e copie a URL exclusiva fornecida.

Durante o processo de validação inicial, I/O Events envia um parâmetro de consulta challenge em uma solicitação GET para o webhook. Você deve configurar seu webhook para retornar o valor desse parâmetro na carga de resposta. Se você estiver usando o Webhook.site, selecione Edit no canto superior direito e digite $request.query.challenge$ em Response body antes de selecionar Save.

Criar um novo projeto no Adobe Developer Console

Acesse o Adobe Developer Console e faça logon com seu Adobe ID. Em seguida, siga as etapas descritas no tutorial sobre criação de um projeto vazio na documentação do Adobe Developer Console.

Assinar eventos

Depois de criar um novo projeto, acesse a tela de visão geral do projeto. Aqui, selecione Adicionar evento.

Uma caixa de diálogo é exibida, permitindo adicionar um provedor de eventos ao projeto:

Depois de escolher um provedor de eventos, selecione Avançar.

A próxima tela exibe uma lista de tipos de evento para se inscrever. Selecione os eventos que você deseja assinar e selecione Avançar.

A próxima tela solicita que você crie um JSON Web Token (JWT). Você tem a opção de gerar automaticamente um par de chaves ou fazer upload de sua própria chave pública gerada no terminal.

Para os fins deste tutorial, a primeira opção é seguida. Selecione a caixa de opção para Gerar um par de chaves e selecione o botão Gerar par de chaves no canto inferior direito.

Quando o par de chaves é gerado, ele é baixado automaticamente pelo navegador. Você mesmo deve armazenar esse arquivo, pois ele não é mantido na Developer Console.

A próxima tela permite revisar os detalhes do par de chaves recém-gerado. Clique em Avançar para continuar.

Na próxima tela, forneça um nome e uma descrição para o registro do evento na seção Detalhes do registro do evento. A prática recomendada é criar um nome exclusivo e de fácil identificação para ajudar a diferenciar esse registro de evento dos outros no mesmo projeto.

Mais abaixo, na mesma tela, na seção Como receber eventos, você pode configurar como receber eventos. O Webhook permite fornecer um endereço de webhook personalizado para receber eventos, enquanto a Ação em tempo de execução permite que você faça o mesmo usando o Adobe I/O Runtime.

Para este tutorial, selecione Webhook e forneça a URL do webhook criado anteriormente. Quando terminar, selecione Salvar eventos configurados para concluir o registro de eventos.

A página de detalhes do registro de evento recém-criado é exibida, onde você pode editar sua configuração, revisar eventos recebidos, executar o rastreamento de depuração e adicionar novos provedores de eventos.

Próximas etapas

Ao seguir este tutorial, você registrou um webhook para receber I/O Event notificações para Experience Platform e/ou Privacy Service. Para obter detalhes sobre eventos disponíveis e como interpretar cargas de notificação para cada serviço, consulte a seguinte documentação:

Consulte a Observability Insights visão geral para obter mais informações sobre como monitorar suas atividades no Experience Platform e Privacy Service.