대상 구성 만들기
이 페이지는 를 사용하여 고유한 대상 구성을 생성하는 데 사용할 수 있는 API 요청 및 페이로드를 예시합니다. /authoring/destinations
API 엔드포인트.
이 끝점을 통해 구성할 수 있는 기능에 대한 자세한 설명은 다음 문서를 참조하십시오.
대상 구성 API 작업 시작 get-started
계속하기 전에 다음을 검토하십시오. 시작 안내서 필수 대상 작성 권한 및 필수 헤더를 가져오는 방법을 포함하여 API를 성공적으로 호출하기 위해 알아야 하는 중요한 정보입니다.
대상 구성 만들기 create
에 POST 요청을 하여 새 대상 구성을 만들 수 있습니다. /authoring/destinations
엔드포인트.
platform.adobe.io/data/core/activation/authoring/destinations
API 형식
POST /authoring/destinations
다음 요청은 새 를 만듭니다 Amazon S3 페이로드에 제공된 매개 변수로 구성된 대상 구성 아래 페이로드에는 가 허용하는 파일 기반 대상에 대한 모든 매개 변수가 포함되어 있습니다. /authoring/destinations
엔드포인트.
모든 매개 변수를 API 호출에 추가할 필요는 없으며, 페이로드는 API 요구 사항에 따라 사용자 지정할 수 있습니다.
code language-shell |
---|
|
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 18-row-3 19-row-3 20-row-3 21-row-3 22-row-3 23-row-3 24-row-3 25-row-3 26-row-3 27-row-3 28-row-3 29-row-3 30-row-3 31-row-3 layout-auto | ||||
---|---|---|---|---|
매개변수 | 유형 | 설명 | ||
name |
문자열 | Experience Platform 카탈로그에서 대상의 제목을 나타냅니다. | ||
description |
문자열 |
Adobe이 대상 카드의 Experience Platform 대상 카탈로그에서 사용할 설명을 입력합니다. 4-5개 이하의 문장을 목표로 하라.+---------------------------------------+ | img-md |
|
||
status |
문자열 | 대상 카드의 라이프사이클 상태를 나타냅니다. 허용되는 값은 다음과 같습니다 TEST , PUBLISHED , 및 DELETED . 사용 TEST 대상을 처음 구성할 때. |
||
customerAuthenticationConfigurations.authType |
문자열 | 대상 서버에 Experience Platform 고객을 인증하는 데 사용되는 구성을 나타냅니다. 다음을 참조하십시오 고객 인증 구성 지원되는 인증 유형에 대한 자세한 내용은 을 참조하십시오. | ||
customerDataFields.name |
문자열 |
도입 중인 사용자 정의 필드의 이름을 입력합니다.
|
||
customerDataFields.type |
문자열 | 도입 중인 사용자 정의 필드 유형을 나타냅니다. 허용되는 값은 다음과 같습니다 string , object , integer .다음을 참조하십시오 고객 데이터 필드 를 참조하십시오. |
||
customerDataFields.title |
문자열 | Experience Platform 사용자 인터페이스에서 고객에게 표시되는 필드의 이름을 나타냅니다. 다음을 참조하십시오 고객 데이터 필드 를 참조하십시오. |
||
customerDataFields.description |
문자열 | 사용자 정의 필드에 대한 설명을 입력합니다. 다음을 참조하십시오 고객 데이터 필드 를 참조하십시오. | ||
customerDataFields.isRequired |
부울 | 대상 설정 워크플로에서 이 필드가 필요한지 여부를 나타냅니다. 다음을 참조하십시오 고객 데이터 필드 를 참조하십시오. |
||
customerDataFields.enum |
문자열 | 사용자 정의 필드를 드롭다운 메뉴로 렌더링하고 사용자가 사용할 수 있는 옵션을 나열합니다. 다음을 참조하십시오 고객 데이터 필드 를 참조하십시오. |
||
customerDataFields.default |
문자열 | 에서 기본값 정의 enum 목록을 표시합니다. |
||
customerDataFields.pattern |
문자열 | 필요한 경우 사용자 정의 필드에 패턴을 적용합니다. 패턴을 적용하려면 정규 표현식을 사용하십시오. 예를 들어 고객 ID에 숫자나 밑줄이 포함되지 않은 경우 을 입력합니다 ^[A-Za-z]+$ 이 필드에서.다음을 참조하십시오 고객 데이터 필드 를 참조하십시오. |
||
uiAttributes.documentationLink |
문자열 |
에서 설명서 페이지를 참조하십시오. 대상 카탈로그 목적지로요 사용
|
||
uiAttributes.category |
문자열 | Adobe Experience Platform에서 대상에 할당된 카테고리를 나타냅니다. 자세한 내용은 다음을 참조하십시오 대상 범주. 다음 값 중 하나를 사용합니다. adobeSolutions, advertising, analytics, cdp, cloudStorage, crm, customerSuccess, database, dmp, ecommerce, email, emailMarketing, enrichment, livechat, marketingAutomation, mobile, personalization, protocols, social, streaming, subscriptions, surveys, tagManagers, voc, warehouses, payments .다음을 참조하십시오 UI 속성 를 참조하십시오. |
||
uiAttributes.connectionType |
문자열 |
대상에 따른 연결 유형입니다. 지원되는 값:
|
||
uiAttributes.frequency |
문자열 | 대상에서 지원하는 데이터 내보내기 유형을 나타냅니다. 다음으로 설정 Streaming API 기반 통합 또는 Batch 파일을 대상으로 내보낼 때 |
||
identityNamespaces.externalId.acceptsAttributes |
부울 | 고객이 표준 프로필 속성을 구성 중인 ID에 매핑할 수 있는지 여부를 나타냅니다. | ||
identityNamespaces.externalId.acceptsCustomNamespaces |
부울 | 고객이 다음에 속한 ID를 매핑할 수 있는지 여부를 나타냅니다. 사용자 정의 네임스페이스 를 추가합니다. | ||
identityNamespaces.externalId.transformation |
문자열 | 예제 구성에 표시되지 않음. 다음과 같은 경우에 사용됩니다. Platform 고객은 일반 이메일 주소를 속성으로 가지고 있으며 플랫폼은 해시된 이메일만 허용합니다. 여기에서 적용해야 하는 변형을 제공합니다(예: 이메일을 소문자로 변환한 다음 해시로 변환). | ||
identityNamespaces.externalId.acceptedGlobalNamespaces |
- | 다음 항목을 나타냅니다. 표준 id 네임스페이스 (예: IDFA) 고객은 구성 중인 ID에 매핑할 수 있습니다. 를 사용할 때 acceptedGlobalNamespaces , 다음을 사용할 수 있습니다 "requiredTransformation":"sha256(lower($))" 이메일 주소 또는 전화 번호를 소문자로 나타내고 해시합니다. |
||
destinationDelivery.authenticationRule |
문자열 |
방법을 나타냅니다. Platform 고객이 대상에 연결합니다. 허용되는 값은 다음과 같습니다
|
||
destinationDelivery.destinationServerId |
문자열 | 다음 instanceId / 대상 서버 템플릿 이 대상에 사용됩니다. |
||
backfillHistoricalProfileData |
부울 | 대상이 대상으로 활성화될 때 내역 프로필 데이터를 내보내는지 여부를 제어합니다. 항상 다음으로 설정 true . |
||
segmentMappingConfig.mapUserInput |
부울 | 대상 활성화 워크플로의 대상 매핑 ID가 사용자에 의해 입력되는지 여부를 제어합니다. | ||
segmentMappingConfig.mapExperiencePlatformSegmentId |
부울 | 대상 활성화 워크플로의 대상 매핑 ID가 Experience Platform 대상 ID인지 여부를 제어합니다. | ||
segmentMappingConfig.mapExperiencePlatformSegmentName |
부울 | 대상 활성화 워크플로의 대상 매핑 ID가 Experience Platform 대상 이름인지 여부를 제어합니다. | ||
segmentMappingConfig.audienceTemplateId |
부울 | 다음 instanceId / 대상 메타데이터 템플릿 이 대상에 사용됩니다. |
||
schemaConfig.profileFields |
배열 | 사전 정의된 항목을 추가할 때 profileFields 위의 구성에 표시된 대로 사용자는 Experience Platform 속성을 대상 측의 사전 정의된 속성에 매핑할 수 있습니다. |
||
schemaConfig.profileRequired |
부울 | 사용 true 위의 예제 구성에 표시된 대로 사용자가 Experience Platform의 프로필 속성을 대상 측의 사용자 지정 속성에 매핑할 수 있어야 하는 경우입니다. |
||
schemaConfig.segmentRequired |
부울 | 항상 사용 segmentRequired:true . |
||
schemaConfig.identityRequired |
부울 | 사용 true 사용자가 Experience Platform에서 원하는 스키마로 id 네임스페이스를 매핑할 수 있어야 하는 경우 |
API 오류 처리
Destination SDK API 엔드포인트는 일반적인 Experience Platform API 오류 메시지 원칙을 따릅니다. 을(를) 참조하십시오 API 상태 코드 및 요청 헤더 오류 플랫폼 문제 해결 안내서에서 확인할 수 있습니다.
다음 단계
이 문서를 읽고 나면 이제 Destination SDK을 통해 새 대상 구성을 만드는 방법을 이해할 수 있습니다 /authoring/destinations
API 엔드포인트.
이 끝점으로 수행할 수 있는 작업에 대한 자세한 내용은 다음 문서를 참조하십시오.
이 끝점이 대상 작성 프로세스에 맞는 위치를 이해하려면 다음 문서를 참조하십시오.