Benachrichtigungen zur Datenerfassung
Der Prozess der Datenaufnahme in Adobe Experience Platform besteht aus mehreren Schritten. Sobald Sie Datendateien identifiziert haben, die in Platform aufgenommen werden müssen, beginnt der Aufnahmevorgang und jeder Schritt erfolgt nacheinander, bis die Daten erfolgreich erfasst wurden oder fehlschlagen. Der Aufnahmevorgang kann mit der Adobe Experience Platform Batch Ingestion-API oder der Benutzeroberfläche von Experience Platform eingeleitet werden.
In Platform geladene Daten müssen mehrere Schritte durchlaufen, um ihr 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 die Überwachung des Aufnahmeprozesses zu unterstützen, ermöglicht es Experience Platform, eine Reihe von Ereignissen zu abonnieren, die von jedem Schritt des Prozesses veröffentlicht werden, und Sie über den Status der aufgenommenen Daten und mögliche Fehler zu informieren.
Webhook für Benachrichtigungen zur Datenerfassung registrieren
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 zum Abonnieren von Adobe I/O Event Benachrichtigungen , um detaillierte Anweisungen dazu zu erhalten.
Benachrichtigungen zur Datenerfassung empfangen
Nachdem Sie Ihren Webhook erfolgreich registriert und neue Daten erfasst haben, können Sie mit dem Empfang von Ereignisbenachrichtigungen beginnen. Diese Ereignisse können über den Webhook selbst oder durch Auswahl der Registerkarte Debug-Tracing in der Übersicht zur Ereignisregistrierung Ihres Projekts in Adobe Developer Console angezeigt werden.
Die folgende JSON-Datei ist ein Beispiel für eine Benachrichtigungs-Payload, 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": "{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"
}
}
}
}
event_id
event
event.xdm:datasetId
event.xdm:eventCode
Das vollständige Schema für Ereignisbenachrichtigungen finden Sie im öffentlichen GitHub-Repository.
Nächste Schritte
Nachdem Sie Platform -Benachrichtigungen für Ihr Projekt registriert haben, können Sie die empfangenen Ereignisse aus der Projektübersicht anzeigen. Detaillierte Anweisungen zum Tracken Ihrer Adobe I/O-Ereignisse finden Sie im Handbuch Tracing–Ereignisse .
Anhang
Der folgende Abschnitt enthält zusätzliche Informationen zur Interpretation der Payloads von Datenerfassungsbenachrichtigungen.
Verfügbare Statusbenachrichtigungs-Ereignisse event-codes
In der folgenden Tabelle sind die verfügbaren Statusbenachrichtigungen zur Datenerfassung aufgeführt, die Sie abonnieren können.
ing_load_success
ing_load_failure
ps_load_success
ps_load_failure
ig_load_success
ig_load_failure