Benachrichtigungen zur Datenerfassung

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.

Registrieren eines Webhofs für Benachrichtigungen zur Datenaufnahme

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.

WICHTIG

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.

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

Nächste Schritte

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.

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