Show Menu
TÓPICOS×

Assinar notificações de Evento de E/S do Adobe

Observability Insights permite que você assine notificações de Evento de E/S de Adobe com relação ao Adobe Experience Platform atividade. 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 evento de E/S para os serviços Adobe Experience Platform. São também 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 de evento retornados para cada Platform serviço aplicável.

Introdução

Este documento requer um entendimento prático dos 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 exclusivo do webhook como parte dos detalhes de registro do evento.
Você pode configurar seu webhook usando o cliente de sua escolha. Para que um endereço temporário do webhook seja usado 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 parâmetro de challenge query em uma solicitação de GET para o webhook. Você deve configurar seu webhook para retornar o valor desse parâmetro na carga de resposta. Se você estiver usando 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 Console do desenvolvedor do Adobe

Vá para o Adobe Developer Console e faça logon com seu Adobe ID. Em seguida, siga as etapas descritas no tutorial sobre como criar um projeto vazio na documentação do Console do desenvolvedor do Adobe.

Inscrever-se em eventos

Depois de criar um novo projeto, navegue até a tela de visão geral do projeto. Aqui, selecione Adicionar evento .
Uma caixa de diálogo é exibida permitindo que você adicione um provedor de eventos ao seu projeto:
  • Se você estiver assinando Experience Platform notificações, selecione Notificações da plataforma
  • Se você estiver assinando Privacy Service notificações da Adobe Experience Platform, selecione Evento Privacy Service
Depois de escolher um provedor de eventos, selecione Avançar .
A tela seguinte exibe uma lista de tipos de evento para assinar. Selecione os eventos que deseja assinar e, em seguida, selecione Avançar .
Se você não tiver certeza sobre quais eventos assinar para o serviço que está trabalhando, consulte a documentação de notificação específica do serviço:
A tela seguinte 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 teclas e, em seguida, selecione o botão Gerar um par de teclas 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 é persistente no Developer Console.
A próxima tela permite que você analise os detalhes do par de chaves recém-gerado. Select Next to continue.
Na tela seguinte, forneça um nome e uma descrição para o registro do evento na seção de detalhes do registro do Evento. A prática recomendada é criar um nome exclusivo e facilmente identificável para ajudar a diferenciar esse registro de eventos de outros no mesmo projeto.
Mais adiante na mesma tela, na seção Como receber eventos , você pode, opcionalmente, configurar como receber eventos. O Webhook permite que você forneça um endereço de webhook personalizado para receber eventos, enquanto a ação do Runtime permite que você faça o mesmo usando o 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 eventos 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 os eventos disponíveis e como interpretar as 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 você pode monitorar suas atividades Experience Platform e Privacy Service.