Show Menu
TÓPICOS×

Notificações de ingestão de dados

O processo de assimilação de dados em Adobe Experience Platform é composto de várias etapas. Após identificar os arquivos de dados que precisam ser ingeridos no Platform, o processo de ingestão é iniciado e cada etapa ocorre consecutivamente até que os dados sejam ingeridos com êxito ou falhem. O processo de ingestão pode ser iniciado usando a API de ingestão de dados do Adobe Experience Platform ou a interface do usuário do Experience Platform.
Os dados carregados no Platform devem passar por várias etapas para chegar ao seu destino, ao Data Lake ou ao armazenamento de dados do Perfil do cliente em tempo real. Cada etapa envolve o processamento dos dados, a validação dos dados e o armazenamento dos dados antes de passá-los para a próxima etapa. Dependendo da quantidade de dados que está sendo ingerida, isso pode se tornar um processo demorado e sempre há uma chance de o processo falhar devido a erros de validação, semântica ou processamento. No evento de uma falha, os problemas de dados precisam ser corrigidos e todo o processo de ingestão deve ser reiniciado usando os arquivos de dados corrigidos.
Para auxiliar no monitoramento do processo de ingestão, o Experience Platform possibilita a assinatura de um conjunto de eventos publicados em cada etapa do processo, notificando o status dos dados ingeridos e de possíveis falhas.

eventos de notificação de status disponíveis

Abaixo está uma lista de notificações de status de ingestão de dados disponíveis que podem ser assinadas.
Há apenas um tópico de evento fornecido para todas as notificações de ingestão de dados. Para distinguir entre diferentes status, é possível usar o código do evento.
Serviço Platform
Status
Descrição do Evento
Código do Evento
Aterrissagem de dados
success
Ingestão - lote bem-sucedido
ing_load_success
Aterrissagem de dados
falha
Ingestão - Falha no lote
ing_load_failure
Perfil do cliente em tempo real
success
Serviço de Perfil - Lote de carregamento de dados bem-sucedido
ps_load_success
Perfil do cliente em tempo real
falha
Serviço de Perfil - Falha no lote de carregamento de dados
ps_load_failure
Gráfico de identidade
success
Gráfico de identidade - lote de carregamento de dados bem-sucedido
ig_load_success
Gráfico de identidade
falha
Gráfico de identidade - Falha no lote de carregamento de dados
ig_load_failure

schema de carga de notificação

O schema de evento de notificação de ingestão de dados é um schema do Modelo de Dados de Experiência (XDM) que contém campos e valores que fornecem detalhes sobre o status dos dados que estão sendo assimilados. Visite o repo XDM GitHub público para visualização do schema de carga de notificação mais recente.

Assinar notificações de status de ingestão de dados

Por meio de Eventos de E/S da Adobe, você pode assinar vários tipos de notificação usando webhooks. As seções abaixo descrevem as etapas para assinar notificações da Platform para eventos de ingestão de dados usando o Adobe Developer Console.

Criar um novo projeto no Adobe Developer Console

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 Adobe Developer Console.

Adicionar eventos Experience Platform ao projeto

Depois de criar um novo projeto, navegue até a tela de visão geral do projeto. Aqui, clique em Adicionar evento .
A caixa de diálogo _Adicionar eventos_é exibida. Clique em​ Experience Platform ​para filtrar a lista de opções disponíveis e, em seguida, clique em Notificações​ ​Platform antes de clicar em​ Avançar .
A tela seguinte exibe uma lista de tipos de evento para assinar. Selecione Notificação de ingestão de dados e clique em Avançar .
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. Clique na caixa de opção para Gerar um par de teclas e clique no botão Gerar 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. Clique em Avançar para continuar.
Na tela seguinte, forneça um nome e uma descrição para o 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, você pode configurar opcionalmente como receber eventos. O Webhook permite que você forneça um endereço de webhook personalizado para receber eventos, enquanto a ação ​Runtime permite que você faça o mesmo usando o Adobe I/O Runtime .
Este tutorial ignora esta etapa de configuração opcional. Quando terminar, clique em 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 revisar eventos recebidos, executar o rastreamento de depuração e editar sua configuração.

Próximas etapas

Depois de registrar as notificações da Platform em seu projeto, você poderá visualização eventos recebidos do painel do projeto. Consulte o guia de Eventos de E/S da Adobe para rastreamento para obter instruções detalhadas sobre como rastrear seus eventos.