설명서Experience Platform대상 안내서

일괄 처리 구성 batch-configuration

Last update: Thu Aug 07 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 관리자
  • 사용자

사용자가 내보낸 파일 이름을 사용자 정의하고 환경 설정에 따라 내보내기 일정을 구성할 수 있도록 하려면 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

이 페이지에 설명된 기능을 지원하는 통합 유형에 대한 자세한 내용은 아래 표를 참조하십시오.

통합 유형
기능 지원
실시간(스트리밍) 통합
아니요
파일 기반 (일괄 처리) 통합
예

지원되는 매개 변수 supported-parameters

여기에서 설정한 값은 파일 기반 대상 활성화 워크플로의 대상자 내보내기 예약 단계에 표시됩니다.

"batchConfig":{
   "allowMandatoryFieldSelection":true,
   "allowDedupeKeyFieldSelection":true,
   "defaultExportMode":"DAILY_FULL_EXPORT",
   "allowedExportMode":[
      "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는 고유하므로 파일 이름에 이러한 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과(와) 함께 사용합니다.
내 사용자 지정 병합 정책

파일 이름 구성 예

아래 구성 예는 API 호출에 사용된 구성과 UI에 표시된 옵션 간의 대응을 보여 줍니다.

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

미리 선택된 매크로가 있는 파일 이름 구성 화면을 표시하는 UI 이미지

다음 단계 next-steps

이 문서를 읽은 후에는 파일 기반 대상에 대한 파일 이름 지정 및 내보내기 일정을 구성하는 방법을 더 잘 이해할 수 있어야 합니다.

다른 대상 구성 요소에 대한 자세한 내용은 다음 문서를 참조하십시오.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6