Notificações de assimilação de dados
O processo de assimilação de dados na Adobe Experience Platform é composto por várias etapas. Depois de identificar os arquivos de dados que precisam ser assimilados na Platform, o processo de assimilação é iniciado e cada etapa ocorre consecutivamente até que os dados sejam assimilados com êxito ou falhem. O processo de assimilação pode ser iniciado usando o API de assimilação em lote do Adobe Experience Platform ou usando o Experience Platform interface do usuário.
Dados carregados em Platform deve passar por várias etapas para alcançar seu destino, a variável Data Lake ou o Real-Time Customer Profile armazenamento de dados. Cada etapa envolve processar os dados, validá-los e armazená-los antes de passá-los para a próxima etapa. Dependendo da quantidade de dados que está sendo assimilada, esse processo pode se tornar demorado e há sempre uma chance de falha do processo devido a erros de validação, semântica ou processamento. No caso de uma falha, os problemas de dados precisam ser corrigidos e, em seguida, todo o processo de assimilação deve ser reiniciado usando os arquivos de dados corrigidos.
Para auxiliar no monitoramento do processo de assimilação, Experience Platform O permite assinar um conjunto de eventos publicados por cada etapa do processo, notificando você sobre o status dos dados assimilados e possíveis falhas.
Registrar um webhook para notificações de assimilação de dados
Para receber notificações de assimilação de dados, é necessário usar Console do Adobe Developer para registrar um webhook na integração Experience Platform.
Siga o tutorial em assinatura de Adobe I/O Event notificações para obter etapas detalhadas sobre como fazer isso.
Receber notificações de assimilação de dados
Depois de registrar seu webhook com êxito e os novos dados tiverem sido assimilados, você poderá começar a receber notificações de evento. Esses eventos podem ser exibidos usando o próprio webhook ou selecionando o Rastreamento de depuração na visão geral do registro de eventos do seu projeto no Console do Adobe Developer.
O JSON a seguir é um exemplo de uma carga de notificação que seria enviada para o seu webhook no caso de falha de um evento de assimilação em lote:
{
"event_id": "93a5b11a-b0e6-4b29-ad82-81b1499cb4f2",
"event": {
"xdm:ingestionId": "01EGK8H8HF9JGFKNDCABHGA24G",
"xdm:customerIngestionId": "01EGK8H8HF9JGFKNDCABHGA24G",
"xdm:imsOrg": "{ORG_ID}",
"xdm:completed": 1598374341560,
"xdm:datasetId": "5e55b556c2ae4418a8446037",
"xdm:eventCode": "ing_load_failure",
"xdm:sandboxName": "prod",
"sentTime": "1598374341595",
"processStartTime": 1598374342614,
"transformedTime": 1598374342621,
"header": {
"_adobeio": {
"imsOrgId": "{ORG_ID}",
"providerMetadata": "aep_observability_catalog_events",
"eventCode": "platform_event"
}
}
}
}
event_id
event
event.xdm:datasetId
event.xdm:eventCode
Para visualizar o schema completo para notificações de eventos, consulte o repositório público do GitHub.
Próximas etapas
Depois de se registrar Platform notificações ao seu projeto, é possível visualizar os eventos recebidos do Visão geral do projeto. Consulte o guia em rastreamento de eventos Adobe I/O para obter instruções detalhadas sobre como rastrear os eventos.
Apêndice
A seção a seguir contém informações adicionais sobre a interpretação das cargas de notificação de assimilação de dados.
Eventos de notificação de status disponíveis event-codes
A tabela a seguir lista as notificações de status de assimilação de dados disponíveis nas quais você pode se inscrever.
ing_load_success
ing_load_failure
ps_load_success
ps_load_failure
ig_load_success
ig_load_failure