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:

Die folgenden Abschnitte enthalten zusätzliche Informationen, die Sie benötigen, um die Platform-APIs erfolgreich aufrufen zu können.

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 Handbuch zur Fehlerbehebung 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:

Alle Ressourcen in Experience Platform sind auf bestimmte virtuelle Sandboxes beschränkt. Bei allen Anfragen an Platform-APIs ist eine Kopfzeile erforderlich, die den Namen der Sandbox angibt, in der der Vorgang ausgeführt werden soll:

Aktivieren eines Batches für die partielle Batch-Aufnahme in der API enable-api

Sie können einen neuen Batch mit aktivierter partieller Aufnahme erstellen.

Um einen neuen Batch zu erstellen, befolgen Sie die Schritte im Entwicklerhandbuch zur Batch-Aufnahme. Nachdem Sie den Schritt Batch erstellen erreicht haben, fügen Sie das folgende Feld zum Anfrageinhalt hinzu:

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercent": 5
}

Aktivieren eines Batches für die partielle Batch-Aufnahme in der Benutzeroberfläche enable-ui

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

Erstellen einer neuen Quellverbindung new-source

Um eine neue Quellverbindung zu erstellen, führen Sie die in der Quellen - Übersicht aufgelisteten Schritte aus. Nachdem Sie den Schritt Datenflussdetails erreicht haben, notieren Sie sich die Felder Partielle Aufnahme 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 Umschalter Partielle Aufnahme deaktiviert ist. Mit dieser Funktion können Platform detaillierte Fehlermeldungen über Ihre aufgenommenen Batches generieren. Wenn der Umschalter Partielle Aufnahme 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.

Verwenden eines vorhandenen Datensatzes existing-dataset

Um einen vorhandenen Datensatz zu verwenden, wählen Sie zunächst einen Datensatz aus. 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 Umschalter Partielle Aufnahme deaktiviert ist. Mit dieser Funktion können Platform detaillierte Fehlermeldungen über Ihre aufgenommenen Batches generieren. Wenn der Umschalter Partielle Aufnahme 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 Daten hinzufügen hochladen und sie werden mit der partiellen Aufnahme aufgenommen.

Verwenden des Flusses "CSV zu XDM-Schema ​" map-flow

Um den Fluss "CSV zu XDM-Schema zuordnen zu verwenden, führen Sie die im Tutorial Zuordnen einer CSV-Datei“Schritte aus. Nachdem Sie den Schritt Daten hinzufügen erreicht haben, notieren Sie sich die Felder Partielle Aufnahme 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 Umschalter Partielle Aufnahme deaktiviert ist. Mit dieser Funktion können Platform detaillierte Fehlermeldungen über Ihre aufgenommenen Batches generieren. Wenn der Umschalter Partielle Aufnahme aktiviert ist, wird die erweiterte Fehlerdiagnose automatisch erzwungen.

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

Nächste Schritte next-steps

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 zum Überwachen partieller Aufnahmefehler finden Sie im Handbuch zur Fehlerdiagnose bei der Batch.