대상 메타데이터 구성

마지막 업데이트: 2026년 9월 9일

작성 대상:

사용자
관리자

Experience Platform에서 대상으로 데이터를 내보낼 때 대상 이름 또는 대상 ID와 같은 특정 대상 메타데이터가 Experience Platform과(와) 대상 간에 공유되어야 할 수 있습니다.

Destination SDK은(는) 대상 플랫폼에서 대상을 프로그래밍 방식으로 만들거나 업데이트하거나 삭제하는 데 사용할 수 있는 도구를 제공합니다.

이 구성 요소가 Destination SDK을(를) 사용하여 만든 통합에 적합한 위치를 이해하려면 구성 옵션 설명서에서 다이어그램을 참조하거나 Destination SDK을 사용하여 스트리밍 대상을 구성하는 방법에 대한 안내서를 참조하십시오.

/authoring/audience-templates 끝점을 통해 대상 메타데이터 템플릿을 구성할 수 있습니다. 대상 메타데이터 구성을 만든 후 /authoring/destinations 끝점을 사용하여 segmentMappingConfig 및 audienceMetadataConfig 섹션을 구성할 수 있습니다. 이 섹션에서는 대상 템플릿에 매핑해야 하는 대상 메타데이터를 대상에 알려줍니다.

이 페이지에 표시된 구성 요소를 구성할 수 있는 자세한 API 호출 예는 다음 API 참조 페이지를 참조하십시오.

IMPORTANT

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

지원되는 통합 유형 supported-integration-types

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

통합 유형

기능 지원

실시간(스트리밍) 통합

예

파일 기반 (일괄 처리) 통합

예

지원되는 매개 변수 supported-parameters

대상 메타데이터 구성을 생성할 때 아래 표에 설명된 매개 변수를 사용하여 대상 매핑 설정을 구성할 수 있습니다.

"segmentMappingConfig": {
   "mapExperiencePlatformSegmentName":false,
   "mapExperiencePlatformSegmentId":false,
   "mapUserInput":false,
 },
"audienceMetadataConfig":{
   "audienceTemplateId":"YOUR_AUDIENCE_TEMPLATE_ID"
}

매개 변수

유형

설명

mapExperiencePlatformSegmentName

부울

대상 활성화 워크플로의 매핑 ID 값이 Experience Platform 대상 이름이어야 하는지 여부를 나타냅니다.

mapExperiencePlatformSegmentId

부울

대상 활성화 워크플로의 매핑 ID 값이 Experience Platform 대상 ID여야 하는지 여부를 나타냅니다.

mapUserInput

부울

사용자가 대상 활성화 워크플로에서 매핑 ID 값에 대한 입력을 제공할 수 있는지 여부를 제어합니다. true(으)로 설정된 경우 audienceTemplateId이(가) 있을 수 없습니다.

audienceTemplateId

문자열

대상에 사용되는 대상 메타데이터 템플릿의 instanceId입니다.

다음 단계 next-steps

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

recommendation-more-help

experience-platform-help-destinations