文档Experience Platform目标指南

批次配置 batch-configuration

最近更新： 2026年9月9日

创建对象：

  • 用户
  • 管理员

使用Destination SDK中的批处理配置选项，允许用户自定义导出的文件名并根据自己的偏好配置导出计划。

当您通过Destination SDK创建基于文件的目标时，可以配置默认的文件命名和导出计划，也可以为用户提供从Experience Platform UI中配置这些设置的选项。 例如，您可以配置行为，例如：

  • 在文件名中包含特定信息，例如受众ID、目标ID或自定义信息。
  • 允许用户从Experience Platform UI自定义文件命名。
  • 将文件导出配置为在设定的时间间隔内进行。
  • 定义用户可以在Experience Platform UI中看到的文件命名和导出计划自定义选项。

批量配置设置是基于文件的目标的目标配置的一部分。

要了解此组件在何处适合使用Destination SDK创建的集成，请参阅配置选项文档中的关系图，或参阅如何使用Destination SDK配置基于文件的目标的指南。

您可以通过/authoring/destinations端点配置文件命名和导出计划设置。 有关详细的API调用示例，请参阅以下API参考页面，您可以在其中配置此页面中显示的组件。

本文介绍了可用于目标的所有受支持的批处理配置选项，并显示了客户将在Experience Platform UI中看到的内容。

IMPORTANT
Destination SDK支持的所有参数名称和值均区分大小写​**​**。 要避免区分大小写错误，请完全按照文档中所示使用参数名称和值。

支持的集成类型 supported-integration-types

有关哪些类型的集成支持此页面上描述的功能，请参阅下表。

集成类型
支持功能
实时（流）集成
否
基于文件（批处理）的集成
是

batchConfig与datasetBatchConfig batchconfig-vs-datasetbatchconfig

本页介绍两个相关但不同的配置对象：

  • batchConfig：控制导出​ 受众 ​的目标（人员、帐户或潜在客户受众）的文件命名和导出计划设置。
  • datasetBatchConfig： batchConfig中的嵌套对象，它控制文件夹命名和导出计划设置，专门用于导出​ 数据集 ​的目标。 当目标支持数据集导出时（即，目标配置中设置了"sources": ["DATASETS"]），请使用此选项。

支持的参数 supported-parameters

您在此处设置的值在基于文件的目标激活工作流的计划受众导出步骤中显示。

"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
   }
参数
类型
描述
allowMandatoryFieldSelection
布尔值
设置为true以允许客户指定哪些配置文件属性是必需的。 默认值为 false。 有关详细信息，请参阅必需属性。
allowDedupeKeyFieldSelection
布尔值
设置为true以允许客户指定重复数据删除键。 默认值为 false。 有关详细信息，请参阅重复数据删除键。
defaultExportMode
枚举

定义默认文件导出模式。 支持的值：

  • DAILY_FULL_EXPORT
  • FIRST_FULL_THEN_INCREMENTAL

默认值为 DAILY_FULL_EXPORT。 有关文件导出计划的详细信息，请参阅批量激活文档。

allowedExportModes
列表

定义客户可用的文件导出模式。 支持的值：

  • DAILY_FULL_EXPORT
  • FIRST_FULL_THEN_INCREMENTAL
allowedScheduleFrequency
列表

定义客户可用的文件导出频率。 支持的值：

  • ONCE
  • EVERY_3_HOURS
  • EVERY_6_HOURS
  • EVERY_8_HOURS
  • EVERY_12_HOURS
  • DAILY
  • WEEKLY
  • MONTHLY
defaultFrequency
枚举

定义默认文件导出频率。支持的值：

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

默认值为 DAILY。

defaultStartTime
字符串
定义文件导出的默认开始时间。 使用24小时文件格式。 默认值为“00:00”。
filenameConfig.allowedFilenameAppendOptions
字符串

必需。 可供用户选择的可用文件名宏列表。 这会确定哪些项目已附加到导出的文件名（受众ID、组织名称、导出日期和时间等）。 设置defaultFilename时，请确保避免复制宏。

支持的值：

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

无论定义宏的顺序如何，Experience Platform UI将始终按此处显示的顺序显示它们。

如果defaultFilename为空，则allowedFilenameAppendOptions列表必须至少包含一个宏。

filenameConfig.defaultFilenameAppendOptions
字符串
必需。 预先选定的默认文件名宏，用户可以取消选中。

此列表中的宏是allowedFilenameAppendOptions中定义的宏的子集。
filenameConfig.defaultFilename
字符串
可选。 为导出的文件定义默认文件名宏。 用户无法覆盖这些内容。

由allowedFilenameAppendOptions定义的任何宏都将附加到defaultFilename宏之后。

如果defaultFilename为空，则必须在allowedFilenameAppendOptions中至少定义一个宏。
segmentGroupingEnabled
布尔值

根据受众合并策略，定义激活的受众是应导出到单个文件还是多个文件中。 支持的值：

  • true：每个合并策略导出一个文件。
  • false：每个受众导出一个文件，不考虑合并策略。 这是默认行为。 完全忽略此参数也可以获得相同的结果。

文件名配置 file-name-configuration

使用文件名配置宏定义导出的文件名应包含的内容。 下表中的宏描述了UI中文件名配置屏幕中的元素。

TIP
作为最佳实践，您应始终在导出的文件名中包含SEGMENT_ID宏。 区段ID是唯一的，因此将它们包含在文件名中是确保文件名唯一的最佳方法。
宏
UI标签
描述
示例
DESTINATION
目标
UI中的目标名称。
Amazon S3
SEGMENT_ID
区段ID
Experience Platform生成的唯一受众ID
ce5c5482-2813-4a80-99bc-57113f6acde2
SEGMENT_NAME
区段名称
用户定义的受众名称
VIP订阅者
DESTINATION_INSTANCE_ID
目标ID
Experience Platform生成的唯一目标实例ID
7b891e5f-025a-4f0d-9e73-1919e71da3b0
DESTINATION_INSTANCE_NAME
目标名称
用户定义的目标实例名称。
我的2022 Advertising目标
ORGANIZATION_NAME
组织名称
Adobe Experience Platform中客户组织的名称。
我的组织名称
SANDBOX_NAME
沙盒名称
客户使用的沙盒的名称。
prod
DATETIME / TIMESTAMP
日期和时间

DATETIME和TIMESTAMP都定义生成文件的时间，但采用不同的格式。

  • DATETIME使用以下格式： YYYYMMDD_HHMMSS。
  • TIMESTAMP使用10位Unix格式。

DATETIME和TIMESTAMP是互斥的，不能同时使用。

  • DATETIME: 20220509_210543
  • TIMESTAMP: 1652131584
CUSTOM_TEXT
自定义文本
要包含在文件名中的用户定义的自定义文本。 无法在defaultFilename中使用。
My_Custom_Text
TIMESTAMP
日期和时间
生成文件时间的10位数时间戳，采用Unix格式。
1652131584
MERGE_POLICY_ID
合并策略ID
用于生成导出受众的合并策略的ID。 当您根据合并策略在文件中分组导出的受众时，使用此宏。 将此宏与segmentGroupingEnabled:true一起使用。
e8591fdb-2873-4b12-b63e-15275b1c1439
MERGE_POLICY_NAME
合并策略名称
用于生成导出受众的合并策略的名称。 当您根据合并策略在文件中分组导出的受众时，使用此宏。 将此宏与segmentGroupingEnabled:true一起使用。
我的自定义合并策略

文件名配置示例 file-name-configuration-example

以下配置示例显示了API调用中使用的配置与UI中显示的选项之间的对应关系。

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

显示具有预选宏的文件名配置屏幕的用户界面图像

数据集导出配置 dataset-export-configuration

使用嵌套在batchConfig中的datasetBatchConfig对象为支持数据集导出的目标配置文件夹命名和导出计划。

IMPORTANT
仅当目标配置包含"sources": ["DATASETS"]时，此对象才适用。 有关完整目标配置示例，请参阅配置受众数据类型，或按照分步指南配置数据集导出目标。
"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"
      ]
   }
}
参数
类型
描述
datasetBatchConfig.allowedFoldernameAppendOptions
列表

必需。 可供用户选择的可用文件夹名称宏列表。 这些操作可确定哪些项目已附加到导出文件夹路径。 如果defaultFoldernameAppendOptions为空，则必须在此至少指定一个宏。 支持的值：

  • DESTINATION
  • DATASET_ID
  • DATASET_NAME
  • EXPORT_TIME
  • DESTINATION_INSTANCE_ID
  • DESTINATION_INSTANCE_NAME
  • ORGANIZATION_NAME
  • SANDBOX_NAME
  • DATETIME
  • CUSTOM_TEXT
datasetBatchConfig.defaultFoldernameAppendOptions
列表
必需。 预先选定的默认文件夹名称宏。 必须是allowedFoldernameAppendOptions中定义的值的子集。
datasetBatchConfig.allowedExportModes
列表

定义用户可用于数据集导出的导出模式。 支持的值：

  • DAILY_FULL_EXPORT
  • FIRST_FULL_THEN_INCREMENTAL
datasetBatchConfig.allowedScheduleFrequency
列表

定义用户可用于数据集导出的导出频率选项。 支持的值：

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

文件夹名称宏 folder-name-macros

下表中的宏可在allowedFoldernameAppendOptions和defaultFoldernameAppendOptions中使用，以定义数据集导出文件夹路径的结构。

宏
描述
示例
DESTINATION
UI中的目标名称。
Amazon S3
DATASET_ID
导出数据集的Experience Platform生成的唯一ID。
6966075d-f6b4-4a04-bd35-d438e1ebd1c3
DATASET_NAME
导出数据集的名称。
我的数据集
EXPORT_TIME
以exportTime=YYYYMMDDHHMM格式导出时间。
exportTime=202212091200
DESTINATION_INSTANCE_ID
Experience Platform生成的唯一目标实例ID。
7b891e5f-025a-4f0d-9e73-1919e71da3b0
DESTINATION_INSTANCE_NAME
用户定义的目标实例名称。
我的2024 Advertising目标
ORGANIZATION_NAME
Adobe Experience Platform中客户组织的名称。
我的组织名称
SANDBOX_NAME
客户使用的沙盒的名称。
prod
DATETIME
日期和时间，格式为YYYYMMDD_HHMMSS。
20220509_210543
CUSTOM_TEXT
要包含在文件夹名称中的用户定义的自定义文本。
My_Custom_Text

后续步骤 next-steps

阅读本文后，您应该更好地了解如何为基于文件的目标配置文件命名和导出计划。

要了解有关其他目标组件的更多信息，请参阅以下文章：

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