En esta página: Aprenda a ingerir datos en Adobe Experience Platform desde fuentes compatibles y a configurar un flujo de datos para sus campañas orquestadas.
Adobe Experience Platform permite la ingesta de datos desde fuentes externas, al tiempo que ofrece la posibilidad de estructurar, etiquetar y mejorar los datos entrantes mediante los servicios de Experience Platform. Puede ingerir datos de una variedad de fuentes, como aplicaciones de Adobe, almacenamiento basado en la nube, bases de datos y muchas otras.
Un conjunto de datos es una construcción de almacenamiento y administración para una colección de datos, normalmente una tabla, que contiene un esquema (columnas) y campos (filas). Los datos que se incorporan correctamente a Experience Platform se almacenan dentro del lago de datos como conjuntos de datos.
Fuentes compatibles con las campañas orquestadas supported
Los siguientes recursos son compatibles con las campañas orquestadas:
Directrices para la higiene de datos de esquemas relacionales cdc
Para los conjuntos de datos habilitados con Cambiar captura de datos, todos los cambios de datos, incluidas las eliminaciones, se reflejarán automáticamente desde el sistema de origen a Adobe Experience Platform. No puede habilitar Cambiar captura de datos en un conjunto de datos que ya contiene datos ingeridos.
Dado que Adobe Journey Optimizer Campaign requiere que todos los conjuntos de datos incorporados estén habilitados con Cambiar captura de datos, es responsabilidad del cliente administrar las eliminaciones en el origen. Cualquier registro eliminado del sistema de origen se eliminará automáticamente del conjunto de datos correspondiente en Adobe Experience Platform.
Para eliminar registros mediante la ingesta basada en archivos, el archivo de datos del cliente debe marcar el registro con un valor d en el campo Change Request Type. Esto indica que el registro debe eliminarse en Adobe Experience Platform, reflejando el sistema de origen.
Si el cliente desea eliminar registros solo de Adobe Experience Platform sin afectar a los datos de origen originales, están disponibles las siguientes opciones:
-
Replicación de captura de datos proxy o saneada para cambio
El cliente puede crear una tabla de origen proxy o saneada para controlar qué registros se replican en Adobe Experience Platform. Las eliminaciones se pueden administrar de forma selectiva desde esta tabla intermedia.
-
Eliminación mediante Data Distiller
Si tiene licencia, Data Distiller se puede usar para admitir operaciones de eliminación directamente en Adobe Experience Platform, independientemente del sistema de origen.
Configuración de un flujo de datos
En este ejemplo se muestra cómo configurar un flujo de datos que ingiere datos estructurados en Adobe Experience Platform. El flujo de datos configurado admite la ingesta automatizada y programada y permite realizar actualizaciones en tiempo real.
-
Desde el menú Conexiones, acceda al menú Fuentes.
-
Elija su fuente según las Fuentes compatibles con las campañas orquestadas.
-
Conecte su cuenta de Cloud Storage o Google Cloud Storage si elige fuentes basadas en la nube.
-
Elija los datos que desea introducir en Adobe Experience Platform.
-
En la página Detalles del conjunto de datos, marque Habilitar la captura de datos de cambio para mostrar solo los conjuntos de datos asignados a esquemas relacionales e incluir una clave principal y un descriptor de versión.
Obtenga más información sobre las directrices para la higiene de los datos de esquemas relacionales
note important IMPORTANT Solo para orígenes basados en archivos, cada fila del archivo de datos debe incluir una columna _change_request_typecon los valoresu(actualización) od(eliminación). Sin esta columna, el sistema no reconocerá los datos como compatibles con el seguimiento de cambios y no aparecerá la opción de campaña orquestada, lo que evitará que se seleccione el conjunto de datos para la segmentación.
-
Seleccione el conjunto de datos creado anteriormente y haga clic en Siguiente.
-
Si solo usa orígenes basados en archivos, en la ventana Seleccionar datos, cargue los archivos locales y obtenga una vista previa de su estructura y contenido.
Tenga en cuenta que el tamaño máximo admitido es de 100 MB.
-
En la ventana Mapping, compruebe que cada atributo del archivo de origen esté asignado correctamente con los campos correspondientes del esquema de destino. Más información sobre las dimensiones de segmentación.
Haga clic en Siguiente cuando haya terminado.
-
Configure el flujo de datos Programar según la frecuencia que desee.
-
Haga clic en Finalizar para crear el flujo de datos. Se ejecuta automáticamente según la programación definida.
-
En el menú Conexiones, seleccione Fuentes y acceda a la pestaña Flujos de datos para rastrear la ejecución del flujo, revisar los registros ingeridos y solucionar cualquier error.
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)