Der Prozess der Datenaufnahme in Adobe Experience Platform besteht aus mehreren Schritten. Nachdem Sie Datendateien identifiziert haben, die in Platform aufgenommen werden müssen, beginnt der Erfassungsvorgang und jeder Schritt erfolgt nacheinander, bis die Daten erfolgreich erfasst wurden oder fehlschlagen. Der Erfassungsvorgang kann mit der Adobe Data Ingestion-API oder über die Experience Platform-Benutzeroberfläche eingeleitet werden.Experience Platform
Daten, die in Platform geladen werden, müssen mehrere Schritte ausführen, um das Ziel, den Data Lake- oder den Real-time Customer Profile-Datenspeicher, zu erreichen. 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.
Um den Erfassungsvorgang zu überwachen, können Sie mit Experience Platform eine Reihe von Ereignissen abonnieren, die von jedem Prozessschritt veröffentlicht werden, und Sie über den Status der erfassten Daten und eventuelle Fehler informieren.
Um Benachrichtigungen zur Datenerfassung zu erhalten, müssen Sie Adobe Developer Console verwenden, um einen WebHook für Ihre Experience Platform-Integration zu registrieren.
Folgen Sie dem Tutorial Abonnieren von Adobe I/O Event Benachrichtigungen, 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 Dateneingabebenachrichtigung 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 Webhook selbst oder durch Auswahl der Registerkarte Debugging-Verfolgung 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 Anhang. |
Informationen zur Ansicht des vollständigen Schemas für Ereignis-Benachrichtigungen finden Sie im öffentlichen GitHub-Repository.
Nachdem Sie Platform-Benachrichtigungen für Ihr Projekt registriert haben, können Sie Ereignisse aus dem Projektüberblick Ansicht haben. Detaillierte Anweisungen zur Verfolgung Ihrer Ereignis finden Sie im Handbuch Adobe I/O-Ereignis nachverfolgen.
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 von Data Lake eingefügt. |
ing_load_failure |
Data Ingestion | Fehlgeschlagen | Ein Stapel konnte nicht in einen Datensatz innerhalb von Data Lake 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.