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"
      }
    }
  }
}

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.