Notifiche di acquisizione dei dati

Ultimo aggiornamento: 2023-05-24
  • Argomenti:
  • Data Ingestion
    Visualizza ulteriori informazioni su questo argomento
  • Creato per:
  • Developer

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

Dati caricati in Platform deve seguire più passaggi per raggiungere la sua destinazione, il Data Lake o Real-Time Customer Profile archivio dati. 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 assistere nel monitoraggio del processo di acquisizione, Experience Platform consente di abbonarsi a un set di eventi pubblicati da ogni passaggio del processo, inviando notifiche sullo stato dei dati acquisiti e su eventuali errori.

Registra un webhook per le notifiche di acquisizione dei dati

Per ricevere le notifiche di acquisizione dei dati, devi utilizzare Console Adobe Developer 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.

IMPORTANTE

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

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 o selezionando Traccia debug nella panoramica della registrazione degli eventi del progetto nella console Adobe Developer.

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"
      }
    }
  }
}
Proprietà Descrizione
event_id ID univoco generato dal sistema per la notifica.
event Oggetto contenente 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 Codice di stato che indica il tipo di evento attivato per il set di dati. Consulta la appendice per valori specifici e relative definizioni.

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

Passaggi successivi

Dopo la registrazione Platform notifiche al progetto, puoi visualizzare gli eventi ricevuti da 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 notifica di acquisizione dati.

Eventi di notifica dello stato disponibili

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

Codice evento Servizio Platform Stato Descrizione di un evento
ing_load_success Data Ingestion success Un batch è stato correttamente acquisito in un set di dati all’interno del Data Lake.
ing_load_failure Data Ingestion errore Impossibile acquisire un batch in un set di dati all’interno di Data Lake.
ps_load_success Real-Time Customer Profile success Un batch è stato acquisito correttamente in Profile archivio dati.
ps_load_failure Real-Time Customer Profile errore Impossibile acquisire un batch in Profile archivio dati.
ig_load_success Identity Service success I dati sono stati caricati correttamente nel grafico delle identità.
ig_load_failure Identity Service errore Caricamento dei dati nel grafo delle identità non riuscito.
NOTA

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

In questa pagina