Benachrichtigungen zur Datenerfassung

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.

Registrieren eines Webhofs für Benachrichtigungen zur Datenaufnahme

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.

WICHTIG

Stellen Sie während des Abonnements sicher, dass Sie Plattformbenachrichtigungen als Ereignis-Provider auswählen und bei Aufforderung das Ereignis Dateneingabebenachrichtigung auswählen.

Benachrichtigungen zur Datenerfassung erhalten

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.

Nächste Schritte

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.

Anhang

Der folgende Abschnitt enthält weitere Informationen zur Interpretation der Nutzdaten von Dateneingabebenachrichtigungen.

Verfügbare Statusbenachrichtigungs-Ereignisse

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.
HINWEIS

Es wird nur ein Ereignisthema für alle Benachrichtigungen zur Datenerfassung bereitgestellt. Zur Unterscheidung zwischen verschiedenen Status kann der Ereignis-Code verwendet werden.

Auf dieser Seite