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: Die Methode, mit der Platform Daten aus Datendateien wie CSV und Parquet erfasst und speichert.
  • Experience Data Model (XDM): Das standardisierte Framework, mit dem Kundenerlebnisdaten von Platform organisiert werden.

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:

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

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:

  • x-sandbox-name: {SANDBOX_NAME}
NOTE
Weitere Informationen zu Sandboxes in Platform finden Sie in der Sandbox-Übersichtsdokumentation.

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

NOTE
In diesem Abschnitt wird die Aktivierung eines Batches für die partielle Batch-Erfassung mithilfe der API beschrieben. Anweisungen zur Verwendung der Benutzeroberfläche finden Sie im Schritt Aktivieren eines Batches für die partielle Batch-Erfassung in der Benutzeroberfläche .

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

Um einen neuen Batch zu erstellen, führen Sie die Schritte im Entwicklerhandbuch zur Batch-Erfassung aus.Sobald Sie den Schritt Batch erstellen erreichen, fügen Sie das folgende Feld im Anfrageinhalt hinzu:

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

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

NOTE
In diesem Abschnitt wird die Aktivierung eines Batches für die partielle Batch-Erfassung mithilfe der Benutzeroberfläche beschrieben. Wenn Sie einen Batch bereits für die partielle Batch-Erfassung mithilfe der API aktiviert haben, können Sie mit dem nächsten Abschnitt fortfahren.

Um einen Batch für die partielle Erfassung ü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.

Neue Quellverbindung erstellen new-source

Um eine neue Quellverbindung zu erstellen, führen Sie die aufgelisteten Schritte in der Quellenübersicht aus. Nachdem Sie den Schritt Datenfluss-Detail erreicht haben, notieren Sie sich 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 kann Platform detaillierte Fehlermeldungen zu den erfassten Batches generieren. Wenn der Umschalter Partielle Erfassung aktiviert ist, wird die erweiterte Fehlerdiagnose automatisch durchgesetzt.

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 der Umschalter Partielle Erfassung deaktiviert ist. Mit dieser Funktion kann Platform detaillierte Fehlermeldungen zu den erfassten Batches generieren. Wenn der Umschalter Partielle Erfassung aktiviert ist, wird die erweiterte Fehlerdiagnose automatisch durchgesetzt.

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. Diese Daten werden dann mithilfe der partiellen Erfassung erfasst.

Fluss "CSV dem XDM-Schema zuordnen"verwenden map-flow

Um den Fluss "CSV dem XDM-Schema zuordnen"zu verwenden, führen Sie die im Tutorial CSV-Datei zuordnen aufgelisteten Schritte aus. Nachdem Sie den Schritt Daten hinzufügen erreicht haben, notieren Sie sich 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 kann Platform detaillierte Fehlermeldungen zu den erfassten Batches generieren. Wenn der Umschalter Partielle Erfassung aktiviert ist, wird die erweiterte Fehlerdiagnose automatisch durchgesetzt.

Mit dem 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 zur Überwachung von Fehlern bei partieller Erfassung finden Sie im Handbuch zur Fehlerdiagnose bei der Batch-Erfassung 🔗.

recommendation-more-help
2ee14710-6ba4-4feb-9f79-0aad73102a9a