Partielle Batch-Erfassung

Partielle Batch-Erfassung ist die Fähigkeit, Daten mit Fehlern bis zu einem bestimmten Schwellenwert zu erfassen. Mit dieser Funktion können Benutzer alle korrekten Daten erfolgreich in Adobe Experience Platform erfassen, während alle fehlerhaften Daten in Batches separat verarbeitet werden (zusammen mit Details dazu, warum sie ungültig sind).

Dieses Dokument enthält eine Anleitung zum Verwalten der partiellen Batch-Erfassung.

Erste Schritte

Diese Anleitung setzt grundlegende Kenntnisse zu den verschiedenen Adobe Experience Platform-Diensten voraus, die mit der partiellen Batch-Erfassung verbunden sind. Bevor Sie mit diesem Tutorial beginnen, lesen Sie bitte die Dokumentation für die folgenden Dienste:

  • Batch-Erfassung Platform: Die Methode, mit der Daten aus Datendateien wie CSV und Parquet erfasst und speichert.
  • Experience Data Model (XDM): Das standardisierte Framework, mit dem Platform Kundenerlebnisdaten organisiert.

Die folgenden Abschnitte enthalten zusätzliche Informationen, die Sie kennen müssen, um Platform-APIs erfolgreich aufzurufen.

Lesen von Beispiel-API-Aufrufen

In diesem Handbuch wird anhand von Beispielen für API-Aufrufe die korrekte Formatierung von Anfragen aufgezeigt. Dazu gehören Pfade, erforderliche Kopfzeilen und ordnungsgemäß formatierte Anfrage-Payloads. Außerdem wird ein Beispiel für eine von der API im JSON-Format zurückgegebene Antwort bereitgestellt. Informationen zu den Konventionen, die in der Dokumentation für Beispiel-API-Aufrufe verwendet werden, finden Sie im Abschnitt zum Lesen von Beispiel-API-Aufrufen im Fehlerbehebungshandbuch für Experience Platform

Sammeln von Werten für erforderliche Kopfzeilen

Um Platform-APIs aufzurufen, müssen Sie zunächst das Authentifizierungs-Tutorial abschließen. Durch Abschluss des Authentifizierungs-Tutorials werden die Werte für die einzelnen erforderlichen Header in allen Experience Platform-API-Aufrufen bereitgestellt, wie unten dargestellt:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}

Alle Ressourcen in Experience Platform werden zu bestimmten virtuellen Sandboxen isoliert. Für alle Anforderungen an Platform-APIs ist ein Header erforderlich, der den Namen der Sandbox angibt, in der der Vorgang ausgeführt wird in:

  • x-sandbox-name: {SANDBOX_NAME}
HINWEIS

Weitere Informationen zu Sandboxen in Platform finden Sie in der Sandbox-Übersichtsdokumentation.

Aktivieren eines Stapels für die teilweise Stapelverarbeitung in der API

HINWEIS

In diesem Abschnitt wird die Aktivierung eines Stapels für die teilweise Stapelverarbeitung mithilfe der API beschrieben. Anweisungen zur Verwendung der Benutzeroberfläche finden Sie im Schritt Stapel zur teilweisen Stapelverarbeitung in der Benutzeroberfläche aktivieren.

Sie können einen neuen Stapel mit aktivierter teilweiser Erfassung erstellen.

Gehen Sie zum Erstellen eines neuen Stapels wie im Handbuch Stapelverarbeitungsentwickler beschrieben vor. Nachdem Sie den Schritt Stapel erstellen erreicht haben, fügen Sie das folgende Feld im Anforderungstext hinzu:

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercentage": 5
}
Eigenschaft Beschreibung
enableErrorDiagnostics Ein Flag, mit dem Platform detaillierte Fehlermeldungen zu Ihrem Stapel generieren kann.
partialIngestionPercentage Der Prozentsatz der akzeptablen Fehler, bevor der gesamte Batch fehlschlägt. In diesem Beispiel können also maximal 5 % des Stapels Fehler sein, bevor er fehlschlägt.

Aktivieren eines Stapels für die teilweise Stapelverarbeitung in der Benutzeroberfläche

HINWEIS

In diesem Abschnitt wird beschrieben, wie Sie einen Stapel für die teilweise Stapelverarbeitung mithilfe der Benutzeroberfläche aktivieren. Wenn Sie bereits einen Stapel für die teilweise Stapelverarbeitung mithilfe der API aktiviert haben, können Sie mit dem nächsten Abschnitt fortfahren.

Um einen Stapel für die teilweise Erfassung über die Platform-Benutzeroberfläche zu aktivieren, können Sie einen neuen Stapel über Quellverbindungen erstellen, einen neuen Stapel in einem vorhandenen Datensatz erstellen oder einen neuen Stapel über den Befehl "CSV zu XDM-Fluss zuordnen"erstellen.

Neue Quellverbindung erstellen

Um eine neue Quellverbindung zu erstellen, führen Sie die aufgelisteten Schritte unter Übersicht über die Quellen aus. Sobald Sie den Schritt Datentiefe erreicht haben, beachten Sie die Felder Partielle Erfassung und Fehlerdiagnose.

Mit dem Umschalter Partielle Erfassung können Sie die Verwendung der partiellen Batch-Erfassung aktivieren oder deaktivieren.

Der Umschalter Fehlerdiagnose wird nur angezeigt, wenn der Umschalter Partielle Erfassung deaktiviert ist. Mit dieser Funktion können Platform detaillierte Fehlermeldungen zu Ihren erfassten Stapeln generieren. Wenn der Umschalter Partielle Erfassung aktiviert ist, wird die erweiterte Fehlerdiagnose automatisch erzwungen.

Mit dem Fehlerschwellenwert können Sie den Prozentsatz der zulässigen Fehler festlegen, bevor der gesamte Batch fehlschlägt. Standardmäßig ist dieser Wert auf 5 % eingestellt.

Vorhandenen Datensatz verwenden

Um einen vorhandenen Datensatz zu verwenden, wählen Sie einen Beginn aus, indem Sie einen Datensatz auswählen. Die Seitenleiste rechts enthält Informationen zum Datensatz.

Mit dem Umschalter Partielle Erfassung können Sie die Verwendung der partiellen Batch-Erfassung aktivieren oder deaktivieren.

Der Umschalter Fehlerdiagnose wird nur angezeigt, wenn der Umschalter Partielle Erfassung deaktiviert ist. Mit dieser Funktion können Platform detaillierte Fehlermeldungen zu Ihren erfassten Stapeln generieren. Wenn der Umschalter Partielle Erfassung aktiviert ist, wird die erweiterte Fehlerdiagnose automatisch erzwungen.

Mit dem Fehlerschwellenwert können Sie den Prozentsatz der zulässigen Fehler festlegen, bevor der gesamte Batch fehlschlägt. Standardmäßig ist dieser Wert auf 5 % eingestellt.

Jetzt können Sie Daten mit der Schaltfläche Hinzufügen Daten hochladen. Die Daten werden mit einer partiellen Erfassung erfasst.

Verwenden Sie den Fluss "CSV dem XDM-Schema zuordnen"

Gehen Sie wie folgt vor, um den Fluss "CSV zu XDM-Schema zuordnen"zu verwenden: 🔗 Sobald Sie den Schritt Hinzufügen Daten erreicht haben, beachten Sie die Felder Partielle Erfassung und Fehlerdiagnose.

Mit dem Umschalter Partielle Erfassung können Sie die Verwendung der partiellen Batch-Erfassung aktivieren oder deaktivieren.

Der Umschalter Fehlerdiagnose wird nur angezeigt, wenn der Umschalter Partielle Erfassung deaktiviert ist. Mit dieser Funktion können Platform detaillierte Fehlermeldungen zu Ihren erfassten Stapeln generieren. Wenn der Umschalter Partielle Erfassung aktiviert ist, wird die erweiterte Fehlerdiagnose automatisch erzwungen.

Die Fehlergrenze ermöglicht es Ihnen, den Prozentsatz der zulässigen Fehler festzulegen, bevor der gesamte Stapel fehlschlägt. Standardmäßig ist dieser Wert auf 5 % eingestellt.

Nächste Schritte

In dieser Anleitung wurde beschrieben, wie Sie einen Datensatz erstellen oder ändern, um die partielle Batch-Erfassung zu aktivieren. Weiterführende Informationen zur Batch-Erfassung finden Sie im Entwicklerhandbuch zur Batch-Erfassung.

Informationen zur Überwachung von Fehlern bei der partiellen Erfassung finden Sie im Handbuch Batch-Erfassungsfehlerdiagnose.

Auf dieser Seite