文件Experience Platform目的地指南

批次設定 batch-configuration

最後更新： 2026年9月16日

建立對象：

  • 使用者
  • 管理員

使用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
區段識別碼
Experience Platform產生的唯一受眾ID
ce5c5482-2813-4a80-99bc-57113f6acde2
SEGMENT_NAME
區段名稱
使用者定義的對象名稱
VIP訂閱者
DESTINATION_INSTANCE_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
用來產生匯出對象的合併原則識別碼。 當您根據合併原則將匯出的對象分組到檔案中時，請使用此巨集。 使用此巨集與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%"
}

顯示檔案名稱組態畫面的UI影像，其中包含預先選取的巨集

資料集匯出設定 dataset-export-configuration

使用datasetBatchConfig物件（巢狀在batchConfig內）為支援資料集匯出的目的地設定資料夾命名和匯出排程。

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