Notifiche di acquisizione dei dati

Il processo di acquisizione dei dati in Adobe Experience Platform è costituito da più passaggi. Una volta identificati i file di dati che devono essere acquisiti in Platform, il processo di acquisizione inizia e ogni passaggio si verifica in sequenza fino a quando i dati non vengono acquisiti correttamente o non hanno esito positivo. Il processo di acquisizione può essere avviato utilizzando Adobe Experience Platform Batch Ingestion API o l'interfaccia utente Experience Platform.

I dati caricati in Platform devono seguire più passaggi per raggiungere la destinazione, l'archivio dati Data Lake o Real-Time Customer Profile. Ogni passaggio comporta l’elaborazione dei dati, la loro convalida e quindi la loro memorizzazione prima di trasmetterli al passaggio successivo. A seconda della quantità di dati acquisiti, questo può diventare un processo che richiede tempo ed è sempre possibile che il processo non riesca a causa di errori di convalida, semantica o elaborazione. In caso di errore, è necessario risolvere i problemi relativi ai dati e quindi riavviare l’intero processo di acquisizione utilizzando i file di dati corretti.

Per facilitare il monitoraggio del processo di acquisizione, Experience Platform consente di sottoscrivere un set di eventi pubblicati in ogni fase del processo, notificando lo stato dei dati acquisiti e qualsiasi possibile errore.

Registra un webhook per le notifiche di acquisizione dei dati

Per ricevere le notifiche di acquisizione dei dati, devi utilizzare Adobe Developer Console per registrare un webhook nell'integrazione Experience Platform.

Segui l'esercitazione su abbonamento a Adobe I/O Event notifiche per i passaggi dettagliati su come eseguire questa operazione.

Ricevere notifiche di acquisizione dati

Dopo aver registrato correttamente il webhook e aver acquisito i nuovi dati, puoi iniziare a ricevere le notifiche dell’evento. Questi eventi possono essere visualizzati utilizzando il webhook stesso oppure selezionando la scheda Traccia debug nella panoramica della registrazione degli eventi del progetto in Adobe Developer Console.

Il seguente JSON è un esempio di payload di notifica che verrebbe inviato al webhook in caso di un evento di acquisizione batch non riuscito:

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

Per visualizzare lo schema completo per le notifiche degli eventi, consulta l'archivio GitHub pubblico.

Passaggi successivi

Dopo aver registrato Platform notifiche per il progetto, puoi visualizzare gli eventi ricevuti dalla Panoramica del progetto. Per istruzioni dettagliate su come tracciare i tuoi eventi, consulta la guida su eventi di Adobe I/O di tracciamento.

Appendice

La sezione seguente contiene informazioni aggiuntive sull’interpretazione dei payload di notifica di acquisizione dati.

Eventi di notifica dello stato disponibili event-codes

Nella tabella seguente sono elencate le notifiche di stato di acquisizione dei dati disponibili a cui puoi iscriverti.