Assinar notificações de eventos Adobe I/O

Observability Insights permite assinar 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. Também são fornecidas informações de referência sobre os tipos de evento disponíveis, juntamente com links para documentação adicional sobre como interpretar os dados retornados do evento para cada tipo aplicável Platform serviço.

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 I/O Event notificações, você deve registrar um webhook especificando um URL de webhook exclusivo 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 o URL exclusivo fornecido.

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

Criar um novo projeto no Console do Adobe Developer

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

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 Próxima.

A próxima tela exibe uma lista de tipos de evento para se inscrever. Selecione os eventos que deseja assinar e selecione Próxima.

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, em seguida, selecione a 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 no Console do desenvolvedor.

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 Detalhes de inscrição no evento seção. 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, sob o Como receber eventos é possível configurar opcionalmente como receber eventos. Webhook permite fornecer um endereço de webhook personalizado para receber eventos, enquanto Ação em tempo de execução permite fazer o mesmo usando Adobe I/O Runtime.

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

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.