일괄 처리 구성

마지막 업데이트: 2023-11-07
  • 주제:
  • Destinations
    이 항목에 대한 자세한 내용 보기
  • 작성 대상:
  • Developer
    User
    Admin
    Leader

사용자가 내보낸 파일 이름을 사용자 정의하고 환경 설정에 따라 내보내기 일정을 구성할 수 있도록 하려면 Destination SDK의 배치 구성 옵션을 사용합니다.

Destination SDK을 통해 파일 기반 대상을 만들 때 기본 파일 이름 지정 및 내보내기 일정을 구성하거나, 사용자에게 Platform UI에서 이러한 설정을 구성하는 옵션을 제공할 수 있습니다. 예를 들어 다음과 같은 동작을 구성할 수 있습니다.

  • 대상 ID, 대상 ID 또는 사용자 지정 정보와 같은 특정 정보를 파일 이름에 포함합니다.
  • 사용자가 플랫폼 UI에서 파일 이름을 사용자 정의할 수 있습니다.
  • 설정된 시간 간격으로 실행되도록 파일 내보내기를 구성합니다.
  • 사용자가 Platform UI에서 볼 수 있는 파일 이름 지정 및 내보내기 예약 사용자 지정 옵션을 정의합니다.

배치 구성 설정은 파일 기반 대상에 대한 대상 구성의 일부입니다.

이 구성 요소가 Destination SDK으로 만든 통합에 어디에 맞는지 이해하려면 의 다이어그램을 참조하십시오. 구성 옵션 설명서 또는 방법에 대한 안내서 참조 Destination SDK을 사용하여 파일 기반 대상 구성.

다음을 통해 파일 이름 지정 및 내보내기 예약 설정을 구성할 수 있습니다. /authoring/destinations 엔드포인트. 이 페이지에 표시된 구성 요소를 구성할 수 있는 자세한 API 호출 예는 다음 API 참조 페이지를 참조하십시오.

이 문서에서는 대상에 사용할 수 있는 지원되는 모든 일괄 처리 구성 옵션에 대해 설명하고 고객이 Platform UI에서 보게 되는 내용을 보여 줍니다.

중요

Destination SDK에서 지원하는 모든 매개변수 이름 및 값은 다음과 같습니다. 대소문자 구분. 대소문자 구분 오류를 방지하려면 설명서에 표시된 대로 매개 변수 이름과 값을 정확히 사용하십시오.

지원되는 통합 유형

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

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

지원되는 매개 변수

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

"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"
   ],
   "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
defaultFrequency 열거형 기본 파일 내보내기 빈도를 정의합니다.지원되는 값:
  • ONCE
  • EVERY_3_HOURS
  • EVERY_6_HOURS
  • EVERY_8_HOURS
  • EVERY_12_HOURS
  • DAILY
기본값은 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에 항상 여기에 표시된 순서대로 표시됩니다.

If defaultFilename 은(는) 비어 있습니다. allowedFilenameAppendOptions 목록에는 하나 이상의 매크로가 있어야 합니다.
filenameConfig.defaultFilenameAppendOptions 문자열 필수 여부. 사용자가 선택 취소할 수 있는 기본 파일 이름 매크로가 미리 선택되었습니다.

이 목록에 있는 매크로는에 정의된 매크로의 하위 집합입니다. allowedFilenameAppendOptions.
filenameConfig.defaultFilename 문자열 선택 사항입니다. 내보낸 파일의 기본 파일 이름 매크로를 정의합니다. 사용자가 덮어쓸 수 없습니다.

에 의해 정의된 모든 매크로 allowedFilenameAppendOptions 다음 뒤에 추가됩니다. defaultFilename 매크로.

If defaultFilename 은(는) 비어 있으므로 다음에 하나 이상의 매크로를 정의해야 합니다. allowedFilenameAppendOptions.
segmentGroupingEnabled 부울 대상자를 기준으로 활성화된 대상자를 단일 파일로 내보내야 하는지 아니면 여러 파일로 내보내야 하는지 정의합니다. 병합 정책. 지원되는 값:
  • true: 병합 정책당 하나의 파일을 내보냅니다.
  • false: 병합 정책에 관계없이 대상당 하나의 파일을 내보냅니다. 기본 동작입니다. 이 매개 변수를 완전히 생략하면 동일한 결과를 얻을 수 있습니다.

파일 이름 구성

파일 이름 구성 매크로를 사용하여 내보낸 파일 이름에 포함되어야 하는 내용을 정의합니다. 아래 표의 매크로는 의 UI에 있는 요소를 파일 이름 구성 화면.

가장 좋은 방법은 SEGMENT_ID 내보낸 파일 이름의 매크로. 세그먼트 ID는 고유하므로 파일 이름에 이러한 ID를 포함하는 것이 파일 이름도 고유하도록 하는 가장 좋은 방법입니다.

매크로 UI 레이블 설명
DESTINATION 대상 UI의 대상 이름입니다. Amazon S3
SEGMENT_ID 세그먼트 ID 플랫폼에서 생성한 고유 대상 ID ce5c5482-2813-4a80-99bc-57113f6acde2
SEGMENT_NAME 세그먼트 이름 사용자 정의 대상 이름 VIP 구독자
DESTINATION_INSTANCE_ID 대상 ID 대상 인스턴스에 대한 플랫폼이 생성한 고유 ID 7b891e5f-025a-4f0d-9e73-1919e71da3b0
DESTINATION_INSTANCE_NAME 대상 이름 대상 인스턴스의 사용자 정의 이름입니다. 내 2022 광고 대상
ORGANIZATION_NAME 조직 이름 Adobe Experience Platform에 있는 고객 조직의 이름입니다. 내 조직 이름
SANDBOX_NAME 샌드박스 이름 고객이 사용하는 샌드박스의 이름. prod
DATETIME / TIMESTAMP 날짜 및 시간 DATETIMETIMESTAMP 둘 다 파일 생성 시기를 정의하지만, 서로 다른 형식으로 정의됩니다.

  • DATETIME 는 YYYYMMDD_HHMMSS 형식을 사용합니다.
  • TIMESTAMP 는 10자리 Unix 형식을 사용합니다.
DATETIMETIMESTAMP 는 함께 사용할 수 없으며 동시에 사용할 수 없습니다.
  • 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 이미지

다음 단계

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

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

이 페이지에서는