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 Kundenerlebnisdaten von Platform organisiert werden.

Die folgenden Abschnitte enthalten zusätzliche Informationen, die Sie benötigen, um erfolgreich Aufrufe an Platform APIs.

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}
HINWEIS

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

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

HINWEIS

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 in der Aktivieren eines Batches für die partielle Batch-Erfassung in der Benutzeroberfläche Schritt.

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

Gehen Sie wie im Abschnitt Entwicklerhandbuch zur Batch-Erfassung. Sobald Sie die Batch erstellen -Schritt, fügen Sie das folgende Feld im Anfragetext hinzu:

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercent": 5
}
Eigenschaft Beschreibung
enableErrorDiagnostics Eine Markierung, die Folgendes ermöglicht: Platform , um detaillierte Fehlermeldungen zu Ihrem Batch zu generieren.
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

HINWEIS

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.

So aktivieren Sie einen Batch für die partielle Erfassung über Platform Benutzeroberfläche: Sie können einen neuen Batch über Quellverbindungen erstellen, einen neuen Batch in einem vorhandenen Datensatz erstellen oder einen neuen Batch über dieZuordnen von CSV zu XDM-Fluss".

Neue Quellverbindung erstellen

Gehen Sie wie im Abschnitt Quellen - Übersicht. Sobald Sie die Datenflussdetails -Schritt, beachten Sie die Partielle Erfassung und Fehlerdiagnose -Felder.

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

Die Fehlerdiagnose Umschalten wird nur angezeigt, wenn Partielle Erfassung -Umschalter deaktiviert ist. Diese Funktion ermöglicht Platform , um detaillierte Fehlermeldungen zu den erfassten Batches zu generieren. Wenn die Variable Partielle Erfassung Umschalter 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

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.

Die Fehlerdiagnose Umschalten wird nur angezeigt, wenn Partielle Erfassung -Umschalter deaktiviert ist. Diese Funktion ermöglicht Platform , um detaillierte Fehlermeldungen zu den erfassten Batches zu generieren. Wenn die Variable Partielle Erfassung Umschalter 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 dem Daten hinzufügen und wird mithilfe der partiellen Erfassung erfasst.

Verwenden Sie dieZuordnen von CSV zu XDM-Schema" Fluss

So verwenden Sie "Zuordnen von CSV zu XDM-Schema", folgen Sie den aufgelisteten Schritten im Abschnitt Tutorial zur CSV-Datei zuordnen. Sobald Sie die Daten hinzufügen -Schritt, beachten Sie die Partielle Erfassung und Fehlerdiagnose -Felder.

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

Die Fehlerdiagnose Umschalten wird nur angezeigt, wenn Partielle Erfassung -Umschalter deaktiviert ist. Diese Funktion ermöglicht Platform , um detaillierte Fehlermeldungen zu den erfassten Batches zu generieren. Wenn die Variable Partielle Erfassung Umschalter aktiviert ist, wird die erweiterte Fehlerdiagnose automatisch durchgesetzt.

Fehlerschwellenwert Sie können den Prozentsatz der akzeptablen Fehler festlegen, bevor der gesamte Batch 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 Abschnitt Handbuch zur Fehlerdiagnose bei der Batch-Erfassung.

Auf dieser Seite