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 che devono essere acquisiti in Platform, il processo di acquisizione inizia e ogni passaggio avviene consecutivamente fino a quando i dati non vengono acquisiti correttamente o non riescono. Il processo di acquisizione può essere avviato utilizzando API di acquisizione in batch di Adobe Experience Platform o utilizzando Experience Platform interfaccia utente.

Dati caricati in Platform devono passare attraverso più passaggi per raggiungere la relativa destinazione, Data Lake o 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.

assistere nel monitoraggio del processo di acquisizione, Experience Platform consente di effettuare la sottoscrizione a un set di eventi pubblicati in ogni fase del processo, con notifica dello stato dei dati acquisiti e di eventuali errori.

Registra un webhook per le notifiche di inserimento dati

Per ricevere le notifiche di inserimento dei dati, devi utilizzare Console Adobe Developer per registrare un webhook nella tua integrazione di Experience Platform.

Segui l’esercitazione su abbonamento a Adobe I/O Event Notifiche per passaggi dettagliati su come eseguire questa operazione.

IMPORTANTE

Durante il processo di abbonamento, assicurati di selezionare Notifiche di Platform come provider di eventi e seleziona il Notifica di inserimento dati abbonamento a un evento 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 Debug Tracing nella panoramica sulla 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": "{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"
      }
    }
  }
}
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. Consulta la sezione appendice per valori specifici e relative definizioni.

Per visualizzare lo schema completo delle notifiche degli eventi, consulta archivio GitHub pubblico.

Passaggi successivi

Una volta registrato Platform notifiche al progetto, puoi visualizzare gli eventi ricevuti dalla Panoramica del progetto. Consulta la guida su tracciamento degli eventi di Adobe I/O per istruzioni dettagliate su come tracciare gli eventi.

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 riuscita nel Profile archivio dati.
ps_load_failure Real-Time Customer Profile guasto Impossibile acquisire un batch nel Profile archivio dati.
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