Aufnehmen von Daten ingest-data

Auf dieser Seite: Erfahren Sie, wie Sie Daten aus unterstützten Quellen in Adobe Experience Platform aufnehmen und einen Datenfluss für Ihre orchestrierten Kampagnen konfigurieren.

IMPORTANT
Um die Datenquelle für einen Datensatz zu ändern, müssen Sie zunächst den vorhandenen Datenfluss löschen, bevor Sie einen neuen erstellen, der auf denselben Datensatz und die neue Quelle verweist.
Adobe Experience Platform erzwingt eine strikte Eins-zu-eins-Beziehung zwischen Datenflüssen und Datensätzen. So können Sie die Synchronisierung zwischen Quelle und Datensatz für eine genaue inkrementelle Aufnahme aufrechterhalten.

Adobe Experience Platform ermöglicht die Aufnahme von Daten aus externen Quellen und bietet spezielle Experience Platform-Services, mittels derer Sie eingehende Daten strukturieren, beschriften und erweitern können. Daten können aus verschiedensten Quellen aufgenommen werden, darunter etwa Adobe-Anwendungen, Cloud-basierte Datenspeicher, Datenbanken und viele andere.

Ein Datensatz ist ein Konstrukt zur Datenspeicherung und -verwaltung, in dem Daten (in der Regel) in einer Tabelle erfasst werden, die ein Schema (Spalten) und Felder (Zeilen) beinhaltet. Daten, die erfolgreich in Experience Platform aufgenommen wurden, werden im Data Lake als Datensätze gespeichert.

Unterstützte Quellen für orchestrierte Kampagnen supported

Die folgenden Quellen werden für die Verwendung mit orchestrierten Kampagnen unterstützt:

Typ
Quelle
Cloud-Speicherplatz
Amazon S3
Google Cloud Storage
SFTP
Cloud-Data Warehouses
Snowflake
Google BigQuery
Data Landing Zone
Azure Databricks
Dateibasierte Uploads
Hochladen einer lokalen Datei

Richtlinien für die Datenhygiene bei relationalen Schemata cdc

Bei Datensätzen, bei denen Änderungsdatenerfassung aktiviert ist, werden alle Datenänderungen, einschließlich Löschungen, automatisch vom Quellsystem in Adobe Experience Platform gespiegelt. Sie können Datenerfassung ändern nicht für einen Datensatz aktivieren, der bereits aufgenommene Daten enthält.

Da für Adobe Journey Optimizer-Kampagnen alle integrierten Datensätze mit der Änderungsdatenerfassung aktiviert werden müssen, ist die Kundin oder der Kunde dafür verantwortlich, Löschungen an der Quelle zu verwalten. Jeder aus dem Quellsystem gelöschte Eintrag wird automatisch aus dem entsprechenden Datensatz in Adobe Experience Platform entfernt.

Um Einträge über die dateibasierte Aufnahme zu löschen, sollte in der Datendatei der Kundin bzw. des Kunden der Eintrag mit einem d-Wert im Feld Change Request Type markiert werden. Dies bedeutet, dass der Eintrag in Adobe Experience Platform gelöscht werden sollte, sodass das Quellsystem gespiegelt wird.

Wenn die Kundin bzw. der Kunde nur Einträge aus Adobe Experience Platform löschen möchte, ohne die ursprünglichen Quelldaten zu beeinflussen, stehen die folgenden Optionen zur Verfügung:

  • Proxy oder bereinigte Tabelle für die Replikation der Änderungsdatenerfassung

    Die Kundin bzw. der Kunde kann einen Proxy oder eine bereinigte Quelltabelle erstellen, um zu steuern, welche Einträge in Adobe Experience Platform repliziert werden sollen. Löschungen können dann selektiv von dieser Zwischentabelle aus verwaltet werden.

  • Löschen über Data Distiller

    Sofern lizenziert, kann Data Distiller verwendet werden, um Löschvorgänge direkt in Adobe Experience Platform zu unterstützen, und zwar unabhängig vom Quellsystem.

    Weitere Informationen zu Data Distiller

Konfigurieren eines Datenflusses

Dieses Beispiel zeigt, wie sich ein Datenfluss konfigurieren lässt, der strukturierte Daten in Adobe Experience Platform aufnimmt. Der konfigurierte Datenfluss unterstützt eine automatisierte, geplante Aufnahme und ermöglicht Echtzeit-Aktualisierungen.

  1. Greifen Sie über das Menü Verbindungen auf das Menü Quellen zu.

  2. Wählen Sie Ihre Quelle abhängig von den unterstützten Quellen für orchestrierte Kampagnen.

  3. Verbinden Sie Ihr Cloud-Speicherplatz- oder Google Cloud-Speicher-Konto, falls Sie sich für Cloud-basierte Quellen entschieden haben.

  4. Wählen Sie die Daten aus, die Sie in Adobe Experience Platform aufnehmen möchten.

  5. Aktivieren Sie auf der Seite Datensatzdetails die Option Änderungsdatenerfassung aktivieren, um nur Datensätze anzuzeigen, die relationalen Schemata zugeordnet sind und sowohl einen Primärschlüssel als auch einen Versionsdeskriptor aufweisen.

    Weitere Informationen zu Richtlinien für relationale Schemata und Datenhygiene

    note important
    IMPORTANT
    Nur dateibasierten Quellen: Jede Zeile in der Datendatei muss eine Spalte _change_request_type mit den Werten u (upsert) oder d (delete) enthalten. Ohne diese Spalte erkennt das System nicht, dass die Daten die Änderungsverfolgung unterstützen, und der Umschalter für „orchestrierte Kampagne“ wird nicht angezeigt, sodass der Datensatz nicht für die Zielgruppenbestimmung ausgewählt werden kann.

  6. Wählen Sie Ihren zuvor erstellten Datensatz aus und klicken Sie auf Weiter.

  7. Wenn Sie nur dateibasierte Quellen verwenden, laden Sie über das Fenster Daten auswählen Ihre lokalen Dateien hoch und zeigen Sie eine Vorschau ihrer Struktur und Inhalte an.

    Beachten Sie, dass die unterstützte Größe maximal 100 MB beträgt.

  8. Überprüfen Sie im Fenster Zuordnung, ob jedes Quelldateiattribut korrekt den entsprechenden Feldern im Zielschema zugeordnet ist. Erfahren Sie mehr über Zielgruppendimensionen

    Klicken Sie auf Weiter, sobald Sie fertig sind.

  9. Konfigurieren Sie den Datenfluss Zeitplan basierend auf der von Ihnen gewünschten Häufigkeit.

  10. Klicken Sie auf Beenden, um den Datenfluss zu erstellen. Er wird automatisch nach dem festgelegten Zeitplan ausgeführt.

  11. Wählen Sie im Menü Verbindungen die Option Quellen aus und greifen Sie auf die Registerkarte Datenflüsse zu, um die Flussausführung zu verfolgen, aufgenommene Einträge zu überprüfen und Fehler zu beheben.

AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

  • TL;DR: This page explains how to ingest data into Adobe Experience Platform from sources supported for Orchestrated campaigns, configure a dataflow, and manage record deletions through Change data capture.

Intents:

  • Identify the supported sources for ingesting data for Orchestrated campaigns (Cloud Storage, Cloud Data Warehouses, File-Based Uploads).
  • Understand the one-to-one relationship enforced between dataflows and datasets, and how to change a data source.
  • Configure a dataflow that ingests structured data into Adobe Experience Platform for Orchestrated campaigns.
  • Enable Change data capture on a dataset mapped to a relational schema.
  • Manage record deletions in Adobe Experience Platform using Change data capture, a file-based deletion marker, a proxy or sanitized table, or Data Distiller.
  • Map source file attributes to target schema fields during dataflow configuration.

Glossary:

  • Dataset: a storage and management construct for a collection of data, typically a table, that contains a schema (columns) and fields (rows) (product-specific)
  • Change data capture: a dataset setting that automatically mirrors all data changes, including deletions, from the source system into Adobe Experience Platform (product-specific)
  • Change Request Type: the file-based ingestion field used to mark a record for deletion with a “d” value (product-specific)
  • _change_request_type: the required column for file-based sources, with values “u” (upsert) or “d” (delete), used to support change tracking (product-specific)
  • Data Distiller: a licensed capability that can be used to support deletion operations directly within Adobe Experience Platform, independent of the source system (product-specific)

Guardrails:

  • Adobe Experience Platform enforces a strict one-to-one relationship between dataflows and datasets (hard limit).
  • To change the data source for a dataset, the existing dataflow must first be deleted before creating a new one that references the same dataset and the new source.
  • Change data capture cannot be enabled on a dataset that already contains ingested data.
  • Adobe Journey Optimizer Campaigns require all onboarded datasets to be enabled with Change data capture.
  • Enabling Change data capture on the Dataset details page displays only datasets that are mapped to relational schemas and include both a primary key and a version descriptor.
  • For file-based sources only, each row in the data file must include a _change_request_type column with values “u” (upsert) or “d” (delete); without this column, the system does not recognize the data as supporting change tracking, and the Orchestrated campaign toggle does not appear, preventing the dataset from being selected for targeting.
  • For file-based sources, the maximum supported upload size is 100MB (hard limit).

Prerequisites and permissions:

  • Data Distiller must be licensed to use it for deleting records directly within Adobe Experience Platform, independent of the source system.

Applicability:

  • Applies: Orchestrated campaigns — the supported sources list and the dataflow configuration steps on this page are scoped to Orchestrated campaigns.

Terminology:

  • Canonical name: Adobe Experience Platform — Acronym: AEP — variants: Platform
  • Canonical name: Adobe Journey Optimizer — Acronym: AJO
  • Synonyms: “dataflow” = “data flow”
  • Do not confuse: “Change data capture” (automatically mirrors source deletions into Adobe Experience Platform) ≠ “Data Distiller” (deletes records only within Adobe Experience Platform, independent of the source system)

FAQ:

  • Q: What must I do before changing the data source for an existing dataset? — Delete the existing dataflow before creating a new one that references the same dataset and the new source, because Adobe Experience Platform enforces a strict one-to-one relationship between dataflows and datasets.
  • Q: Which sources are supported for Orchestrated campaigns? — Cloud Storage (Amazon S3, Google Cloud Storage, SFTP), Cloud Data Warehouses (Snowflake, Google BigQuery, Data Landing Zone, Azure Databricks), and File-Based Uploads (Local File Upload).
  • Q: Can Change data capture be enabled on a dataset that already has ingested data? — No, Change data capture cannot be enabled on a dataset that already contains ingested data.
  • Q: How do I delete a record using file-based ingestion? — Mark the record with a “d” value in the Change Request Type field, which indicates the record should be deleted in Adobe Experience Platform, mirroring the source system.
  • Q: How can I delete records from Adobe Experience Platform without affecting the source data? — Use a proxy or sanitized source table for Change data capture replication, or, if licensed, use Data Distiller to delete records directly within Adobe Experience Platform.
  • Q: What happens if the _change_request_type column is missing from a file-based source? — The system does not recognize the data as supporting change tracking, and the Orchestrated campaign toggle does not appear, preventing the dataset from being selected for targeting.

Related pages:

  • For mapping source file attributes to target schema fields during dataflow configuration: Learn more about targeting dimensions (orchestrated/target-dimension.md)

Personas:

  • developer: Can map each source file attribute to the corresponding field in the target schema during dataflow configuration. Can include a _change_request_type column in file-based source data, with values u for upsert or d for delete, to support change tracking. The page states that without this column, the Orchestrated campaign toggle does not appear, preventing the dataset from being selected for targeting. Where: “Configure a dataflow”.
  • admin: Can configure a dataflow for Orchestrated campaigns using Cloud Storage, Cloud Data Warehouses, or File-Based Uploads sources. Can enable Change data capture only on datasets mapped to relational schemas with a primary key and version descriptor. The page states that a dataflow must be deleted before creating a new one that references the same dataset and a new source. Where: “Guardrails”.

Onboarding:

  • Level: Experienced
  • First minimal step: From the Connections menu, access the Sources menu.
  • Success check: From the Connections menu, select Sources and access the Data Flows tab to track flow execution, review ingested records, and troubleshoot any errors.
  • Next: Mapping source file attributes to target schema fields during dataflow configuration: Create your Targeting dimension (orchestrated/target-dimension.md)
recommendation-more-help
journey-optimizer-help