DocumentaciónExperience PlatformGuía de destinos

Configuración por lotes batch-configuration

Última actualización: 9 de septiembre de 2026

Creado para:

  • Usuario
  • Administrador

Utilice las opciones de configuración por lotes de Destination SDK para permitir que los usuarios personalicen los nombres de archivo exportados y configuren la programación de exportación según sus preferencias.

Cuando crea destinos basados en archivos mediante Destination SDK, puede configurar programaciones predeterminadas de nomenclatura y exportación de archivos, o bien puede dar a los usuarios la opción de configurar estas opciones desde la interfaz de usuario de Experience Platform. Por ejemplo, puede configurar comportamientos como:

  • Incluya información específica en el nombre del archivo, como ID de audiencia, ID de destino o información personalizada.
  • Permita que los usuarios personalicen el nombre de archivo desde la interfaz de usuario de Experience Platform.
  • Configure las exportaciones de archivos para que se produzcan a intervalos de tiempo establecidos.
  • Defina las opciones de personalización de programación de exportación y nomenclatura de archivos que los usuarios pueden ver en la interfaz de usuario de Experience Platform.

Los ajustes de configuración por lotes forman parte de la configuración de destino para destinos basados en archivos.

Para saber dónde encaja este componente en una integración creada con Destination SDK, consulte el diagrama en la documentación de opciones de configuración o vea la guía sobre cómo usar Destination SDK para configurar un destino basado en archivos.

Puede configurar la nomenclatura de archivos y exportar la configuración de programación a través del extremo /authoring/destinations. Consulte las siguientes páginas de referencia de la API para ver ejemplos detallados de llamadas de la API donde puede configurar los componentes que se muestran en esta página.

Este artículo describe todas las opciones de configuración por lotes admitidas que puede utilizar para su destino y muestra lo que los clientes verán en la interfaz de usuario de Experience Platform.

IMPORTANT
Todos los nombres y valores de parámetro admitidos por Destination SDK distinguen entre mayúsculas y minúsculas. Para evitar errores de distinción entre mayúsculas y minúsculas, utilice los nombres y valores de parámetros exactamente como se muestra en la documentación.

Tipos de integración admitidos supported-integration-types

Consulte la tabla siguiente para obtener detalles sobre qué tipos de integraciones admiten la funcionalidad descrita en esta página.

Tipo de integración
Admite funcionalidad
Integraciones en tiempo real (streaming)
No
Integraciones basadas en archivos (por lotes)
Sí

batchConfig vs. datasetBatchConfig batchconfig-vs-datasetbatchconfig

Esta página describe dos objetos de configuración relacionados pero distintos:

  • batchConfig: controla la nomenclatura de archivos y la configuración de programación de exportación para destinos que exportan audiencias (audiencias de personas, cuentas o clientes potenciales).
  • datasetBatchConfig: un objeto anidado dentro de batchConfig que controla la nomenclatura de carpetas y exporta la configuración de programación específicamente para destinos que exportan conjuntos de datos. Utilícelo cuando su destino admita exportaciones de conjuntos de datos (es decir, "sources": ["DATASETS"] está establecido en su configuración de destino).

Parámetros admitidos supported-parameters

Los valores que configuró aquí aparecen en el paso Programar exportación de audiencias del flujo de trabajo de activación de destinos basados en archivos.

"batchConfig":{
   "allowMandatoryFieldSelection":true,
   "allowDedupeKeyFieldSelection":true,
   "defaultExportMode":"DAILY_FULL_EXPORT",
   "allowedExportModes":[
      "DAILY_FULL_EXPORT",
      "FIRST_FULL_THEN_INCREMENTAL"
   ],
   "allowedScheduleFrequency":[
      "DAILY",
      "EVERY_3_HOURS",
      "EVERY_6_HOURS",
      "EVERY_8_HOURS",
      "EVERY_12_HOURS",
      "ONCE",
      "WEEKLY",
      "MONTHLY"
   ],
   "defaultFrequency":"DAILY",
   "defaultStartTime":"00:00",
   "filenameConfig":{
         "allowedFilenameAppendOptions":[
            "SEGMENT_NAME",
            "DESTINATION_INSTANCE_ID",
            "DESTINATION_INSTANCE_NAME",
            "ORGANIZATION_NAME",
            "SANDBOX_NAME",
            "DATETIME",
            "CUSTOM_TEXT"
         ],
         "defaultFilenameAppendOptions":[
            "DATETIME"
         ],
         "defaultFilename":"%DESTINATION%_%SEGMENT_ID%"
      },
   "segmentGroupingEnabled": true
   }
Parámetro
Tipo
Descripción
allowMandatoryFieldSelection
Booleano
Se establece en true para permitir que los clientes especifiquen qué atributos de perfil son obligatorios. El valor predeterminado es false. Consulte Atributos obligatorios para obtener más información.
allowDedupeKeyFieldSelection
Booleano
Establezca en true para permitir que los clientes especifiquen las claves de anulación de duplicación. El valor predeterminado es false. Consulte Claves de deduplicación para obtener más información.
defaultExportMode
Enumeración

Define el modo de exportación de archivos predeterminado. Valores compatibles:

  • DAILY_FULL_EXPORT
  • FIRST_FULL_THEN_INCREMENTAL

El valor predeterminado es DAILY_FULL_EXPORT. Consulte la documentación de activación por lotes para obtener detalles acerca de la programación de exportaciones de archivos.

allowedExportModes
Lista

Define los modos de exportación de archivos disponibles para los clientes de. Valores compatibles:

  • DAILY_FULL_EXPORT
  • FIRST_FULL_THEN_INCREMENTAL
allowedScheduleFrequency
Lista

Define la frecuencia de exportación de archivos disponible para los clientes. Valores compatibles:

  • ONCE
  • EVERY_3_HOURS
  • EVERY_6_HOURS
  • EVERY_8_HOURS
  • EVERY_12_HOURS
  • DAILY
  • WEEKLY
  • MONTHLY
defaultFrequency
Enumeración

Define la frecuencia predeterminada de exportación de archivos.Valores compatibles:

  • ONCE
  • EVERY_3_HOURS
  • EVERY_6_HOURS
  • EVERY_8_HOURS
  • EVERY_12_HOURS
  • DAILY
  • WEEKLY
  • MONTHLY

El valor predeterminado es DAILY.

defaultStartTime
Cadena
Define la hora de inicio predeterminada para la exportación de archivos. Utiliza el formato de archivo de 24 horas. El valor predeterminado es 00:00.
filenameConfig.allowedFilenameAppendOptions
Cadena

Requerido. Lista de macros de nombre de archivo disponibles para que los usuarios elijan. Esto determina qué elementos se anexan a los nombres de archivo exportados (ID de audiencia, nombre de organización, fecha y hora de exportación, etc.). Al establecer defaultFilename, asegúrese de evitar la duplicación de macros.

Valores compatibles:

  • DESTINATION
  • SEGMENT_ID
  • SEGMENT_NAME
  • DESTINATION_INSTANCE_ID
  • DESTINATION_INSTANCE_NAME
  • ORGANIZATION_NAME
  • SANDBOX_NAME
  • DATETIME
  • CUSTOM_TEXT

Independientemente del orden en que defina las macros, la interfaz de usuario de Experience Platform siempre las mostrará en el orden presentado aquí.

Si defaultFilename está vacío, la lista allowedFilenameAppendOptions debe contener al menos una macro.

filenameConfig.defaultFilenameAppendOptions
Cadena
Requerido. Macros de nombre de archivo predeterminado preseleccionadas que los usuarios pueden desmarcar.

Las macros de esta lista son un subconjunto de las definidas en allowedFilenameAppendOptions.
filenameConfig.defaultFilename
Cadena
Opcional. Define las macros de nombre de archivo predeterminadas para los archivos exportados. Los usuarios no pueden sobrescribirlos.

Cualquier macro definida por allowedFilenameAppendOptions se anexará después de las macros defaultFilename.

Si defaultFilename está vacío, debe definir al menos una macro en allowedFilenameAppendOptions.
segmentGroupingEnabled
Booleano

Define si las audiencias activadas deben exportarse en un solo archivo o en varios, según la audiencia política de combinación. Valores compatibles:

  • true: exporta un archivo por política de combinación.
  • false: exporta un archivo por audiencia, independientemente de la política de combinación. Este es el comportamiento predeterminado. Puede lograr el mismo resultado omitiendo este parámetro por completo.

Configuración del nombre de archivo file-name-configuration

Utilice macros de configuración de nombres de archivo para definir qué nombres de archivo exportados deben incluir. Las macros de la tabla siguiente describen los elementos que se encuentran en la interfaz de usuario de la pantalla configuración de nombre de archivo.

TIP
Como práctica recomendada, siempre debe incluir la macro SEGMENT_ID en los nombres de archivo exportados. Los ID de segmento son únicos, por lo que incluirlos en el nombre de archivo es la mejor manera de asegurarse de que los nombres de archivo también sean únicos.
Macro
Etiqueta de IU
Descripción
Ejemplo
DESTINATION
Destino
Nombre del destino en la interfaz de usuario.
Amazon S3
SEGMENT_ID
ID de segmento
ID único de audiencia generado por Experience Platform
ce5c5482-2813-4a80-99bc-57113f6acde2
SEGMENT_NAME
Nombre del segmento
Nombre de audiencia definido por el usuario
suscriptor de VIP
DESTINATION_INSTANCE_ID
ID de destino
ID único de la instancia de destino generado por Experience Platform
7b891e5f-025a-4f0d-9e73-1919e71da3b0
DESTINATION_INSTANCE_NAME
Nombre de destino
Nombre definido por el usuario de la instancia de destino.
Mi destino de Advertising 2022
ORGANIZATION_NAME
Nombre de la organización
Nombre de la organización del cliente en Adobe Experience Platform.
Nombre de mi organización
SANDBOX_NAME
Nombre de zona protegida
Nombre de la zona protegida utilizada por el cliente.
picar
DATETIME / TIMESTAMP
Fecha y hora

DATETIME y TIMESTAMP definen cuándo se generó el archivo, pero en formatos diferentes.

  • DATETIME usa el siguiente formato: AAAAMMDD_HHMMSS.
  • TIMESTAMP usa el formato Unix de 10 dígitos.

DATETIME y TIMESTAMP se excluyen mutuamente y no se pueden usar simultáneamente.

  • DATETIME: 20220509_210543
  • TIMESTAMP: 1652131584
CUSTOM_TEXT
Texto personalizado
Texto personalizado definido por el usuario que se incluirá en el nombre del archivo. No se puede usar en defaultFilename.
My_Custom_Text
TIMESTAMP
Fecha y hora
Marca de tiempo de 10 dígitos de la hora en la que se generó el archivo, en formato Unix.
1652131584
MERGE_POLICY_ID
Id. de política de combinación
El identificador de política de combinación usado para generar la audiencia exportada. Utilice esta macro cuando agrupe audiencias exportadas en archivos, según la política de combinación. Use esta macro junto con segmentGroupingEnabled:true.
e8591fdb-2873-4b12-b63e-15275b1c1439
MERGE_POLICY_NAME
Nombre de política de combinación
Nombre de política de combinación que se utilizó para generar la audiencia exportada. Utilice esta macro cuando agrupe audiencias exportadas en archivos, según la política de combinación. Use esta macro junto con segmentGroupingEnabled:true.
Mi política de combinación personalizada

Ejemplo de configuración de nombre de archivo file-name-configuration-example

El ejemplo de configuración siguiente muestra la correspondencia entre la configuración utilizada en la llamada de API y las opciones que se muestran en la interfaz de usuario.

"filenameConfig":{
   "allowedFilenameAppendOptions":[
      "CUSTOM_TEXT",
      "SEGMENT_ID",
      "DATETIME"
   ],
   "defaultFilenameAppendOptions":[
      "SEGMENT_ID",
      "DATETIME"
   ],
   "defaultFilename": "%DESTINATION%"
}

Imagen de interfaz de usuario que muestra la pantalla de configuración de nombre de archivo con macros preseleccionadas

Configuración de exportación del conjunto de datos dataset-export-configuration

Utilice el objeto datasetBatchConfig, anidado en batchConfig, para configurar las programaciones de nomenclatura y exportación de carpetas para los destinos que admiten exportaciones de conjuntos de datos.

IMPORTANT
Este objeto solo es aplicable cuando la configuración de destino incluye "sources": ["DATASETS"]. Consulte Configurar tipo de datos de audiencia para ver el ejemplo completo de configuración de destino, o siga la guía paso a paso para configurar un destino de exportación de conjunto de datos.
"batchConfig":{
   "datasetBatchConfig":{
      "allowedFoldernameAppendOptions":[
         "DESTINATION",
         "DATASET_ID",
         "DATASET_NAME",
         "EXPORT_TIME",
         "DESTINATION_INSTANCE_ID",
         "DESTINATION_INSTANCE_NAME",
         "ORGANIZATION_NAME",
         "SANDBOX_NAME",
         "DATETIME",
         "CUSTOM_TEXT"
      ],
      "defaultFoldernameAppendOptions":[
         "DATASET_ID",
         "EXPORT_TIME"
      ],
      "allowedExportModes":[
         "DAILY_FULL_EXPORT",
         "FIRST_FULL_THEN_INCREMENTAL"
      ],
      "allowedScheduleFrequency":[
         "DAILY",
         "EVERY_3_HOURS",
         "EVERY_6_HOURS",
         "EVERY_8_HOURS",
         "EVERY_12_HOURS",
         "ONCE"
      ]
   }
}
Parámetro
Tipo
Descripción
datasetBatchConfig.allowedFoldernameAppendOptions
Lista

Requerido. Lista de macros de nombre de carpeta disponibles para que los usuarios elijan. Estos determinan qué elementos se anexan a la ruta de la carpeta de exportación. Si defaultFoldernameAppendOptions está vacío, debe especificarse al menos una macro aquí. Valores compatibles:

  • DESTINATION
  • DATASET_ID
  • DATASET_NAME
  • EXPORT_TIME
  • DESTINATION_INSTANCE_ID
  • DESTINATION_INSTANCE_NAME
  • ORGANIZATION_NAME
  • SANDBOX_NAME
  • DATETIME
  • CUSTOM_TEXT
datasetBatchConfig.defaultFoldernameAppendOptions
Lista
Requerido. Macros de nombre de carpeta predeterminadas preseleccionadas. Debe ser un subconjunto de los valores definidos en allowedFoldernameAppendOptions.
datasetBatchConfig.allowedExportModes
Lista

Define los modos de exportación disponibles para los usuarios para las exportaciones de conjuntos de datos. Valores compatibles:

  • DAILY_FULL_EXPORT
  • FIRST_FULL_THEN_INCREMENTAL
datasetBatchConfig.allowedScheduleFrequency
Lista

Define las opciones de frecuencia de exportación disponibles para los usuarios para las exportaciones de conjuntos de datos. Valores compatibles:

  • ONCE
  • EVERY_3_HOURS
  • EVERY_6_HOURS
  • EVERY_8_HOURS
  • EVERY_12_HOURS
  • DAILY

Macros de nombre de carpeta folder-name-macros

Las macros de la tabla siguiente se pueden usar en allowedFoldernameAppendOptions y defaultFoldernameAppendOptions para definir la estructura de la ruta de la carpeta de exportación del conjunto de datos.

Macro
Descripción
Ejemplo
DESTINATION
Nombre del destino en la interfaz de usuario.
Amazon S3
DATASET_ID
ID único del conjunto de datos exportado generado por Experience Platform.
6966075d-f6b4-4a04-bd35-d438e1ebd1c3
DATASET_NAME
Nombre del conjunto de datos exportado.
Mi conjunto de datos
EXPORT_TIME
Hora de exportación en formato exportTime=YYYYMMDDHHMM.
exportTime=202212091200
DESTINATION_INSTANCE_ID
ID único de la instancia de destino generado por Experience Platform.
7b891e5f-025a-4f0d-9e73-1919e71da3b0
DESTINATION_INSTANCE_NAME
Nombre definido por el usuario de la instancia de destino.
Mi destino de Advertising 2024
ORGANIZATION_NAME
Nombre de la organización del cliente en Adobe Experience Platform.
Nombre de mi organización
SANDBOX_NAME
Nombre de la zona protegida utilizada por el cliente.
picar
DATETIME
Fecha y hora con el formato YYYYMMDD_HHMMSS.
20220509_210543
CUSTOM_TEXT
Texto personalizado definido por el usuario que se incluirá en el nombre de la carpeta.
My_Custom_Text

Próximos pasos next-steps

Después de leer este artículo, debería tener una mejor comprensión de cómo puede configurar la nomenclatura de archivos y las programaciones de exportación para sus destinos basados en archivos.

Para obtener más información acerca de los demás componentes de destino, consulte los siguientes artículos:

recommendation-more-help
experience-platform-help-destinations