사용자가 내보낸 파일 이름을 사용자 정의하고 환경 설정에 따라 내보내기 일정을 구성할 수 있도록 하려면 Destination SDK의 배치 구성 옵션을 사용합니다.
Destination SDK을 통해 파일 기반 대상을 만들 때 기본 파일 이름 지정 및 내보내기 일정을 구성하거나, 사용자에게 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 입니다. 다음을 참조하십시오. 일괄 활성화 설명서 파일 내보내기 예약에 대한 자세한 내용. |
allowedExportModes |
목록 | 고객이 사용할 수 있는 파일 내보내기 모드를 정의합니다. 지원되는 값:
|
allowedScheduleFrequency |
목록 | 고객이 사용할 수 있는 파일 내보내기 빈도를 정의합니다. 지원되는 값:
|
defaultFrequency |
열거형 | 기본 파일 내보내기 빈도를 정의합니다.지원되는 값:
DAILY 입니다. |
defaultStartTime |
문자열 | 파일 내보내기의 기본 시작 시간을 정의합니다. 24시간 파일 형식을 사용합니다. 기본값은 "00:00"입니다. |
filenameConfig.allowedFilenameAppendOptions |
문자열 | 필수 여부. 사용자가 선택할 수 있는 사용 가능한 파일 이름 매크로 목록입니다. 내보낸 파일 이름(대상 ID, 조직 이름, 내보내기 날짜 및 시간 등)에 추가될 항목을 결정합니다. 설정 시 defaultFilename 매크로를 복제하지 않도록 하십시오. 지원되는 값:
If defaultFilename 은(는) 비어 있습니다. allowedFilenameAppendOptions 목록에는 하나 이상의 매크로가 있어야 합니다. |
filenameConfig.defaultFilenameAppendOptions |
문자열 | 필수 여부. 사용자가 선택 취소할 수 있는 기본 파일 이름 매크로가 미리 선택되었습니다. 이 목록에 있는 매크로는에 정의된 매크로의 하위 집합입니다. allowedFilenameAppendOptions . |
filenameConfig.defaultFilename |
문자열 | 선택 사항입니다. 내보낸 파일의 기본 파일 이름 매크로를 정의합니다. 사용자가 덮어쓸 수 없습니다. 에 의해 정의된 모든 매크로 allowedFilenameAppendOptions 다음 뒤에 추가됩니다. defaultFilename 매크로. If defaultFilename 은(는) 비어 있으므로 다음에 하나 이상의 매크로를 정의해야 합니다. allowedFilenameAppendOptions . |
segmentGroupingEnabled |
부울 | 대상자를 기준으로 활성화된 대상자를 단일 파일로 내보내야 하는지 아니면 여러 파일로 내보내야 하는지 정의합니다. 병합 정책. 지원되는 값:
|
파일 이름 구성 매크로를 사용하여 내보낸 파일 이름에 포함되어야 하는 내용을 정의합니다. 아래 표의 매크로는 의 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 |
날짜 및 시간 | DATETIME 및 TIMESTAMP 둘 다 파일 생성 시기를 정의하지만, 서로 다른 형식으로 정의됩니다.
DATETIME 및 TIMESTAMP 는 함께 사용할 수 없으며 동시에 사용할 수 없습니다. |
|
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%"
}
이 문서를 읽은 후에는 파일 기반 대상에 대한 파일 이름 지정 및 내보내기 일정을 구성하는 방법을 더 잘 이해할 수 있어야 합니다.
다른 대상 구성 요소에 대한 자세한 내용은 다음 문서를 참조하십시오.