Der Prozess der Datenaufnahme in Adobe Experience Platform besteht aus mehreren Schritten. Once you identify data files that need to be ingested into Platform, the ingestion process begins and each step occurs consecutively until the data is either successfully ingested or fails. Der Erfassungsvorgang kann mit der Adobe Data Ingestion-API oder über die Experience Platform-Benutzeroberfläche eingeleitet werden.Experience Platform
Data loaded into Platform must go through multiple steps in order to reach its destination, the Data Lake or the Real-time Customer Profile data store. Jeder Schritt umfasst die Verarbeitung der Daten, die Validierung der Daten und dann die Speicherung der Daten, bevor sie an den nächsten Schritt weitergeleitet werden. Je nachdem, wie viele Daten aufgenommen werden, kann dies ein zeitaufwendiger Prozess sein und es besteht immer die Möglichkeit, dass der Prozess aufgrund von Validierungs-, Semantik- oder Verarbeitungsfehlern fehlschlägt. Im Fall eines Fehlers müssen die Datenprobleme behoben werden und dann der gesamte Aufnahmevorgang mit den korrigierten Datendateien neu gestartet werden.
To assist in monitoring the ingestion process, Experience Platform makes it possible to subscribe to a set of events that are published by each step of the process, notifying you to the status of the ingested data and any possible failures.
Um Benachrichtigungen zur Datenerfassung zu erhalten, müssen Sie die Adobe Developer Console verwenden, um einen Webshaken für Ihre Experience Platform-Integration zu registrieren.
Folgen Sie dem Tutorial zum Abonnieren von Adobe I/O Event Tonbenachrichtigungen , um detaillierte Schritte dazu zu erhalten.
Stellen Sie während des Abonnements sicher, dass Sie Plattformbenachrichtigungen als Ereignis-Provider auswählen und bei Aufforderung das Ereignis für Dateneingabebenachrichtigungen auswählen.
Nachdem Sie Ihren Webhook erfolgreich registriert und neue Daten erfasst haben, können Sie Beginn mit Ereignis-Benachrichtigungen aufrufen. Diese Ereignisse können mit dem Webshaken selbst oder über die Registerkarte " Debug-Ablaufverfolgung "in der Projektregistrierung in der Adobe Developer Console angezeigt werden.
Die folgende JSON-Datei ist ein Beispiel für eine Benachrichtigungs-Nutzlast, die bei einem fehlgeschlagenen Batch-ErfassungsEreignis an Ihren Webhook gesendet wird:
{
"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"
}
}
}
}
Eigenschaft | Beschreibung |
---|---|
event_id |
Eine eindeutige, systemgenerierte ID für die Benachrichtigung. |
event |
Ein Objekt, das die Details des Ereignisses enthält, das die Benachrichtigung ausgelöst hat. |
event.xdm:datasetId |
Die ID des Datensatzes, auf den das Ereignis "Inkraftsetzung"angewendet wird. |
event.xdm:eventCode |
Ein Statuscode, der den Typ des Ereignisses angibt, das für den Datensatz ausgelöst wurde. Spezifische Werte und deren Definitionen finden Sie im Anhang . |
Informationen zur Ansicht des vollständigen Schemas für Ereignis-Benachrichtigungen finden Sie im öffentlichen GitHub-Repository.
Nachdem Sie Platform Benachrichtigungen zu Ihrem Projekt registriert haben, können Sie Ereignisse aus der ProjektübersichtAnsicht haben. Refer to the guide on tracing Adobe I/O Events for detailed instructions on how to trace your events.
Der folgende Abschnitt enthält weitere Informationen zur Interpretation der Nutzdaten von Dateneingabebenachrichtigungen.
In der folgenden Tabelle werden die verfügbaren Statusbenachrichtigungen zur Datenaufnahme Liste, die Sie abonnieren können.
Ereignis-Code | Platform Service | Status | Ereignisbeschreibung |
---|---|---|---|
ing_load_success |
Data Ingestion | Erfolgreich | Ein Stapel wurde erfolgreich in einen Datensatz innerhalb des Data LakeStapels eingefügt. |
ing_load_failure |
Data Ingestion | Fehlgeschlagen | Ein Stapel konnte nicht in einen Datensatz innerhalb des Data LakeStapels aufgenommen werden. |
ps_load_success |
Real-time Customer Profile | Erfolgreich | Ein Stapel wurde erfolgreich in den Profile Datenspeicher aufgenommen. |
ps_load_failure |
Real-time Customer Profile | Fehlgeschlagen | Ein Stapel konnte nicht in den Profile Datenspeicher aufgenommen werden. |
ig_load_success |
Identity Service | Erfolgreich | Daten wurden erfolgreich in das Identitätsdiagramm geladen. |
ig_load_failure |
Identity Service | Fehlgeschlagen | Daten konnten nicht in das Identitätsdiagramm geladen werden. |
Es wird nur ein Ereignisthema für alle Benachrichtigungen zur Datenerfassung bereitgestellt. Zur Unterscheidung zwischen verschiedenen Status kann der Ereignis-Code verwendet werden.