Benachrichtigungen zur Datenerfassung

Der Prozess der Datenaufnahme in Adobe Experience Platform besteht aus mehreren Schritten. Sobald Sie Datendateien identifiziert haben, die in aufgenommen werden müssen Platform, 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 mithilfe der Experience Platform -Benutzeroberfläche.

In geladene Daten Platform muss mehrere Schritte durchlaufen, um sein Ziel zu erreichen. Data Lake oder Real-Time Customer Profile Datenspeicher. 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.

Unterstützung bei der Überwachung des Aufnahmevorgangs, Experience Platform ermöglicht es, 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-Konsole , um einen Webhook für Ihre Experience Platform-Integration zu registrieren.

Folgen Sie dem Tutorial zu abonnieren von Adobe I/O Event Benachrichtigungen für detaillierte Schritte, wie Sie dies erreichen können.

IMPORTANT
Stellen Sie während des Abonnementprozesses sicher, dass Sie Plattformbenachrichtigungen als Ereignisanbieter fungieren, und wählen Sie die Benachrichtigung zur Datenerfassung Ereignisabonnement bei Aufforderung.

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 Debug-Verfolgung in der Übersicht über die Ereignisregistrierung in der Adobe Developer Console Ihres Projekts.

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"
      }
    }
  }
}
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, für den das Aufnahmeereignis gilt.
event.xdm:eventCode
Ein Statuscode, der den Typ des Ereignisses angibt, das für den Datensatz ausgelöst wurde. Siehe Anhang für bestimmte Werte und deren Definitionen.

Das vollständige Schema für Ereignisbenachrichtigungen finden Sie im Abschnitt öffentliches GitHub-Repository.

Nächste Schritte

Sobald Sie sich registriert haben Platform Benachrichtigungen an Ihr Projekt können Sie die empfangenen Ereignisse aus dem Projektübersicht. Weitere Informationen finden Sie im Handbuch Tracking-Adobe I/O-Ereignisse für detaillierte Anweisungen zur Verfolgung Ihrer 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.

Ereignis-Code
Platform Service
Status
Ereignisbeschreibung
ing_load_success
Data Ingestion
Erfolgreich
Ein Batch wurde erfolgreich in einen Datensatz innerhalb der Data Lake.
ing_load_failure
Data Ingestion
Fehlgeschlagen
Ein Batch konnte nicht in einen Datensatz innerhalb der Data Lake.
ps_load_success
Real-Time Customer Profile
Erfolgreich
Ein Batch wurde erfolgreich in die Profile Datenspeicher.
ps_load_failure
Real-Time Customer Profile
Fehlgeschlagen
Ein Batch konnte nicht in die Profile Datenspeicher.
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.
NOTE
Es wird nur ein Ereignisthema für alle Benachrichtigungen zur Datenerfassung bereitgestellt. Zur Unterscheidung zwischen verschiedenen Status kann der Ereignis-Code verwendet werden.
recommendation-more-help
2ee14710-6ba4-4feb-9f79-0aad73102a9a