Notifiche di acquisizione dei dati

Il processo di acquisizione dei dati in Adobe Experience Platform è composto da più passaggi. Una volta identificati i file di dati da acquisire in Platform, inizia il processo di acquisizione e ogni passaggio si verifica consecutivamente fino a quando i dati non vengono acquisiti correttamente o non riescono. Il processo di acquisizione può essere avviato utilizzando l’ API di acquisizione dati di Adobe Experience Platform o l’interfaccia utente Experience Platform.

I dati caricati in Platform devono attraversare più passaggi per raggiungere la relativa destinazione, l' Data Lake o l' Real-time Customer Profile archivio dati. Ogni passaggio comporta l’elaborazione dei dati, la convalida dei dati e quindi la memorizzazione dei dati prima di passare al passaggio successivo. A seconda della quantità di dati che vengono acquisiti, questo può diventare un processo che richiede molto tempo e c'è sempre la possibilità che il processo non riesca a causa di errori di convalida, semantica o elaborazione. In caso di errore, i problemi di dati devono essere risolti e l’intero processo di acquisizione deve essere riavviato 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 eventuali errori.

Registra un webhook per le notifiche di inserimento dati

Per ricevere le notifiche di inserimento dei dati, è necessario utilizzare Adobe Developer Console per registrare un webhook nell’integrazione di Experience Platform.

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

IMPORTANTE

Durante il processo di abbonamento, assicurati di selezionare Notifiche della piattaforma come provider di eventi e seleziona la sottoscrizione dell'evento Notifica di acquisizione dati quando richiesto.

Ricevere notifiche di acquisizione dati

Dopo aver registrato correttamente il webhook e l’acquisizione dei nuovi dati, puoi iniziare a ricevere le notifiche relative agli eventi. Questi eventi possono essere visualizzati utilizzando il webhook stesso o selezionando la scheda Debug Tracing nella panoramica di registrazione degli eventi del progetto in Adobe Developer Console.

Il seguente JSON è un esempio di payload di notifica che verrebbe inviato al tuo webhook nel 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": "{IMS_ORG}",
    "xdm:completed": 1598374341560,
    "xdm:datasetId": "5e55b556c2ae4418a8446037",
    "xdm:eventCode": "ing_load_failure",
    "xdm:sandboxName": "prod",
    "sentTime": "1598374341595",
    "processStartTime": 1598374342614,
    "transformedTime": 1598374342621,
    "header": {
      "_adobeio": {
        "imsOrgId": "{IMS_ORG}",
        "providerMetadata": "aep_observability_catalog_events",
        "eventCode": "platform_event"
      }
    }
  }
}
Proprietà Descrizione
event_id Un ID univoco generato dal sistema per la notifica.
event Un oggetto che contiene i dettagli dell'evento che ha attivato la notifica.
event.xdm:datasetId ID del set di dati a cui si applica l’evento di acquisizione.
event.xdm:eventCode Un codice di stato che indica il tipo di evento attivato per il set di dati. Per valori specifici e relative definizioni, vedere l' appendice .

Per visualizzare lo schema completo delle notifiche degli eventi, fai riferimento all’ archivio GitHub pubblico.

Passaggi successivi

Dopo aver registrato le notifiche Platform al progetto, puoi visualizzare gli eventi ricevuti dalla Panoramica del progetto. Per istruzioni dettagliate su come tracciare gli eventi, consulta la guida sul tracciamento di eventi di Adobe I/O a1/> .

Appendice

La sezione seguente contiene informazioni aggiuntive sull’interpretazione dei payload di notifiche di inserimento dati.

Eventi di notifica dello stato disponibili

Nella tabella seguente sono elencate le notifiche sullo stato di acquisizione dei dati disponibili per le quali puoi effettuare l’abbonamento.

Codice evento Servizio Platform Stato Descrizione di un evento
ing_load_success Data Ingestion success Un batch è stato acquisito correttamente in un set di dati all’interno di Data Lake.
ing_load_failure Data Ingestion guasto Impossibile acquisire un batch in un set di dati all'interno di Data Lake.
ps_load_success Real-time Customer Profile success Acquisizione di un batch nell'archivio dati Profile completata.
ps_load_failure Real-time Customer Profile guasto Impossibile acquisire un batch nell'archivio dati Profile.
ig_load_success Identity Service success Caricamento dei dati nel grafico delle identità completato.
ig_load_failure Identity Service guasto Impossibile caricare i dati nel grafico delle identità.
NOTA

È disponibile un solo argomento evento per tutte le notifiche di inserimento dei dati. Per distinguere tra stati diversi, è possibile utilizzare il codice evento.

In questa pagina