Show Menu
ARGOMENTI×

Notifiche di assimilazione dei dati

Il processo di assimilazione dei dati in Adobe Experience Platform consiste di più passaggi. Una volta identificati i file di dati in cui è necessario eseguire l'assimilazione, Platformil processo di assimilazione inizia e ogni passaggio si verifica consecutivamente fino a quando i dati non vengono correttamente acquisiti o non hanno esito negativo. Il processo di inserimento può essere avviato utilizzando l'API ingest-api.yaml Adobe Experience Platform Data Ingestion o l'interfaccia Experience Platform utente.
I dati caricati in Platform devono passare attraverso più passaggi per raggiungere la destinazione, l'archivio Data Lake o l'archivio Real-time Customer Profile dati. Ogni passaggio prevede l'elaborazione dei dati, la convalida dei dati e 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 ed è sempre possibile che il processo non riesca a causa di errori di convalida, semantica o elaborazione. In caso di errore, i problemi relativi ai dati devono essere risolti e l'intero processo di assimilazione deve essere riavviato utilizzando i file di dati corretti.
Per assistere nel monitoraggio del processo di assimilazione, Experience Platform consente di sottoscrivere un set di eventi pubblicati in ogni fase del processo, notificando all’utente lo stato dei dati acquisiti e ogni possibile errore.

Registrazione di un webhook per le notifiche di assimilazione dei dati

Per ricevere le notifiche di assimilazione dei dati, è necessario utilizzare console Sviluppatore di Adobe per registrare un webhook nell'integrazione del Experience Platform .
Seguite l’esercitazione sulle notifiche Adobe I/O Event di iscrizione per i passaggi dettagliati su come ottenere questo risultato.
Durante il processo di iscrizione, accertatevi di selezionare Platform notifications il fornitore dell'evento e di selezionare la sottoscrizione dell' Data ingestion notification evento quando richiesto.

Ricevere notifiche di assimilazione dei dati

Dopo aver registrato correttamente il webhook e l'acquisizione di nuovi dati, potete iniziare a ricevere le notifiche sull'evento. Questi eventi possono essere visualizzati utilizzando il webhook stesso, oppure selezionando la Debug Tracing scheda nella panoramica di registrazione dell'evento del progetto in Adobe Developer Console.
Il seguente JSON è un esempio di payload di notifica che verrebbe inviato al webhook nel caso di un evento di caricamento 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
L'ID del set di dati a cui si applica l'evento di assimilazione.
event.xdm:eventCode
Un codice di stato che indica il tipo di evento attivato per il set di dati. Cfr. l' appendice per i valori specifici e le relative definizioni.
Per visualizzare lo schema completo delle notifiche degli eventi, fare riferimento all'archivio GitHub pubblico.

Passaggi successivi

Una volta registrate Platform le notifiche al progetto, potete visualizzare gli eventi ricevuti dal Project overview. Per istruzioni dettagliate su come tracciare gli eventi, consultate Adobe eventi I/O.

Appendice

La sezione seguente contiene informazioni aggiuntive sull'interpretazione dei payload di notifica dell'assimilazione dei dati.

Eventi di notifica dello stato disponibili

Nella tabella seguente sono elencate le notifiche di stato dell’assimilazione dei dati disponibili alle quali potete iscrivervi.
Codice evento
Servizio piattaforma
Stato
Descrizione di un evento
ing_load_success
Data Ingestion
success
È stato eseguito l'assimilazione di un batch in un set di dati all'interno dell' Data Lake.
ing_load_failure
Data Ingestion
fallimento
Impossibile assimilare un batch in un set di dati all'interno dell' Data Lake.
ps_load_success
Real-time Customer Profile
success
Acquisizione batch riuscita nell'archivio Profile dati.
ps_load_failure
Real-time Customer Profile
fallimento
Impossibile assimilare un batch nell'archivio Profile dati.
ig_load_success
Identity Service
success
Caricamento dei dati nel grafico dell'identità completato.
ig_load_failure
Identity Service
fallimento
Impossibile caricare i dati nel grafico dell'identità.
È disponibile un solo argomento evento per tutte le notifiche di assimilazione dei dati. Per distinguere tra stati diversi, è possibile utilizzare il codice evento.