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 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 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 den Aufnahmevorgang zu überwachen, ermöglicht Experience Platform das Abonnieren einer Reihe von Ereignissen, die von jedem Schritt des Prozesses veröffentlicht werden, und informiert Sie über den Status der aufgenommenen Daten sowie über mögliche Fehler.

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 zu Abonnieren von Adobe I/O Event Benachrichtigungen , um detaillierte Anweisungen dazu zu erhalten.

WICHTIG

Stellen Sie während des Abonnementprozesses sicher, dass Sie Plattformbenachrichtigungen als Ereignisanbieter auswählen und bei Aufforderung das Abonnement Benachrichtigung zur Datenerfassung auswählen.

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 der 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": "{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, 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. Spezifische Werte und ihre Definitionen finden Sie im Anhang .

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 Adoben I/O finden Sie im Handbuch zu Tracing-Ereignissen .

Anhang

Der folgende Abschnitt enthält zusätzliche Informationen zur Interpretation der Payloads von Datenerfassungsbenachrichtigungen.

Verfügbare Statusbenachrichtigungs-Ereignisse

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 von Data Lake aufgenommen.
ing_load_failure Data Ingestion Fehlgeschlagen Ein Batch konnte nicht in einen Datensatz innerhalb von Data Lake aufgenommen werden.
ps_load_success Real-time Customer Profile Erfolgreich Ein Batch wurde erfolgreich in den Profile-Datenspeicher aufgenommen.
ps_load_failure Real-time Customer Profile Fehlgeschlagen Ein Batch konnte nicht in den Datenspeicher Profile 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