Sur cette page : découvrez comment ingérer des données dans Adobe Experience Platform à partir de sources prises en charge et configurer un flux de données pour vos campagnes orchestrées.
Adobe Experience Platform permet d’ingérer des données à partir de sources externes tout en vous offrant la possibilité de structurer, d’étiqueter et d’améliorer les données entrantes à l’aide des services d’Experience Platform. Vous pouvez ingérer des données provenant de diverses sources telles que les applications Adobe, les stockages dans le cloud, les bases de données, etc.
Un jeu de données est une structure de stockage et de gestion pour une collection de données, généralement sous la forme d’un tableau, qui contient un schéma (des colonnes) et des champs (des lignes). Les données correctement ingérées par Experience Platform sont conservées sous forme de jeux de données dans le lac de données.
Sources prises en charge pour les campagnes orchestrées supported
Les sources suivantes sont prises en charge pour une utilisation dans des campagnes orchestrées :
Instructions relatives à l’hygiène des données des schémas relationnels cdc
Pour les jeux de données avec l’option Capture des données modifiées activée, toutes les modifications de données, y compris les suppressions, sont automatiquement répliquées dans Adobe Experience Platform à partir du système source. Vous ne pouvez pas activer Modifier la capture de données sur un jeu de données qui contient déjà des données ingérées.
Étant donné que les campagnes Adobe Journey Optimizer nécessitent que tous les jeux de données intégrés aient l’option Capture des données modifiées activée, il est de la responsabilité du client ou de la cliente de gérer les suppressions à la source. Tout enregistrement supprimé dans le système source est automatiquement supprimé du jeu de données correspondant dans Adobe Experience Platform.
Pour supprimer des enregistrements par ingestion basée sur des fichiers, le fichier de données du client ou de la cliente doit marquer l’enregistrement à l’aide d’une valeur d dans le champ Change Request Type. Celle-ci indique que l’enregistrement doit être supprimé dans Adobe Experience Platform, reflétant ainsi le système source.
Si le client ou la cliente souhaite supprimer uniquement des enregistrements dans Adobe Experience Platform sans affecter les données source d’origine, les options suivantes peuvent être utilisées :
-
Table proxy ou table assainie pour la réplication de la capture des données modifiées
Le client ou la cliente peut créer une table source proxy ou assainie pour contrôler quels enregistrements seront répliqués dans Adobe Experience Platform. Les suppressions peuvent ensuite être gérées de manière sélective à partir de cette table intermédiaire.
-
Suppression via Data Distiller
Si une licence est disponible, Data Distiller peut être utilisé pour prendre en charge les opérations de suppression directement dans Adobe Experience Platform, indépendamment du système source.
Configurer un flux de données
Cet exemple montre comment configurer un flux de données qui ingère des données structurées dans Adobe Experience Platform. Le flux de données configuré prend en charge l’ingestion automatisée et planifiée et permet des mises à jour en temps réel.
-
Dans le menu Connexions, accédez au menu Sources.
-
Choisissez votre source en fonction des Sources prises en charge pour les campagnes orchestrées.
-
Connectez votre compte d’espace de stockage dans le cloud ou d’espace de stockage dans le cloud Google si vous avez choisi des sources basées sur le cloud.
-
Sélectionnez les données à ingérer dans Adobe Experience Platform.
-
Depuis la page Détails du jeu de données, cochez Activer la capture des données modifiées pour afficher uniquement les jeux de données mappés à des schémas relationnels et contenant à la fois une clé primaire et un descripteur de version.
En savoir plus sur les directives relatives à l’hygiène des données des schémas relationnels
note important IMPORTANT Pour les sources basées sur des fichiers uniquement, chaque ligne du fichier de données doit inclure une colonne _change_request_typeavec des valeursu(upsert) oud(delete). Sans cette colonne, le système ne reconnaît pas les données comme prenant en charge le suivi des modifications et le bouton Campagne orchestrée n’apparaît pas, empêchant le jeu de données d’être sélectionné pour le ciblage.
-
Sélectionnez le jeu de données créé précédemment et cliquez sur Suivant.
-
Si vous utilisez uniquement des sources basées sur des fichiers, dans la fenêtre Sélectionner les données, chargez vos fichiers locaux et prévisualisez leur structure et leur contenu.
Notez que la taille maximale prise en charge est de 100 Mo.
-
Dans la fenêtre Mappage, vérifiez que chaque attribut de fichier source est correctement mappé avec les champs correspondants dans le schéma cible. Découvrez les dimensions de ciblage.
Cliquez sur Suivant une fois l’opération terminée.
-
Configurez le Planning du flux de données en fonction de la fréquence souhaitée.
-
Cliquez sur Terminer pour créer le flux de données. Il s’exécute automatiquement selon le planning défini.
-
Dans le menu Connexions, sélectionnez Sources et accédez à l’onglet Flux de données pour suivre l’exécution du flux, vérifier les enregistrements ingérés et résoudre les erreurs.
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)