대상 구성 만들기
이 페이지는 /authoring/destinations
API 끝점을 사용하여 고유한 대상 구성을 만드는 데 사용할 수 있는 API 요청 및 페이로드를 예시합니다.
이 끝점을 통해 구성할 수 있는 기능에 대한 자세한 설명은 다음 문서를 참조하십시오.
대상 구성 API 작업 시작 get-started
계속하기 전에 시작 안내서에서 필요한 대상 작성 권한 및 필수 헤더를 얻는 방법을 포함하여 API를 성공적으로 호출하기 위해 알아야 하는 중요한 정보를 검토하십시오.
대상 구성 만들기 create
/authoring/destinations
끝점에 대한 POST 요청을 수행하여 새 대상 구성을 만들 수 있습니다.
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개 이하의 문장을 목표로 하라. 대상 설명을 표시하는 {width="100" modal="regular"} |
status |
문자열 | 대상 카드의 라이프사이클 상태를 나타냅니다. 허용되는 값은 TEST , PUBLISHED 및 DELETED 입니다. 대상을 처음 구성할 때 TEST 을(를) 사용하십시오. |
customerAuthenticationConfigurations.authType |
문자열 | 대상 서버에 Experience Platform 고객을 인증하는 데 사용되는 구성을 나타냅니다. 지원되는 인증 유형에 대한 자세한 내용은 고객 인증 구성을 참조하십시오. |
customerDataFields.name |
문자열 | 도입 중인 사용자 정의 필드의 이름을 입력합니다. 이러한 설정에 대한 자세한 내용은 고객 데이터 필드를 참조하십시오. 고객 데이터 필드를 표시하는 {width="100" modal="regular"} |
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 |
문자열 | 대상의 대상 카탈로그에 있는 문서 페이지를 참조합니다. https://www.adobe.com/go/destinations-YOURDESTINATION-en 을(를) 사용합니다. 여기서 YOURDESTINATION 은(는) 대상 이름입니다. Moviestar라는 대상의 경우 https://www.adobe.com/go/destinations-moviestar-en 을(를) 사용합니다. 이 링크는 Adobe이 대상을 라이브로 설정하고 설명서가 게시된 후에만 작동합니다.이러한 설정에 대한 자세한 내용은 UI 특성을 참조하십시오. 설명서 링크를 표시하는 {width="100" modal="regular"} |
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 |
문자열 | 대상에서 지원하는 데이터 내보내기 유형을 나타냅니다. API 기반 통합을 위해 Streaming (으)로 설정하거나 파일을 대상으로 내보낼 때 Batch (으)로 설정합니다. |
identityNamespaces.externalId.acceptsAttributes |
부울 | 고객이 표준 프로필 속성을 구성 중인 ID에 매핑할 수 있는지 여부를 나타냅니다. |
identityNamespaces.externalId.acceptsCustomNamespaces |
부울 | 고객이 사용자 지정 네임스페이스에 속하는 ID를 구성할 수 있는지 여부를 나타냅니다. |
identityNamespaces.externalId.transformation |
문자열 | 예제 구성에 표시되지 않음. 예를 들어 Platform 고객이 일반 이메일 주소를 특성으로 가지고 있고 플랫폼이 해시된 이메일만 수락하는 경우 사용됩니다. 여기에서 적용해야 하는 변형을 제공합니다(예: 이메일을 소문자로 변환한 다음 해시로 변환). |
identityNamespaces.externalId.acceptedGlobalNamespaces |
- | 사용자가 구성하는 ID에 고객이 매핑할 수 있는 표준 ID 네임스페이스(예: IDFA)를 나타냅니다.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 |
부울 | 사용자가 위의 예제 구성에 표시된 대로 Experience Platform의 프로필 특성을 대상 측의 사용자 지정 특성에 매핑할 수 있어야 하는 경우 true 을(를) 사용합니다. |
schemaConfig.segmentRequired |
부울 | 항상 segmentRequired:true 을(를) 사용하십시오. |
schemaConfig.identityRequired |
부울 | 사용자가 Experience Platform에서 원하는 스키마로 ID 네임스페이스를 매핑할 수 있어야 하는 경우 true 을(를) 사용합니다. |
API 오류 처리
Destination SDK API 엔드포인트는 일반적인 Experience Platform API 오류 메시지 원칙을 따릅니다. 플랫폼 문제 해결 안내서에서 API 상태 코드 및 요청 헤더 오류를 참조하십시오.
다음 단계
이 문서를 읽은 후에는 Destination SDK /authoring/destinations
API 끝점을 통해 새 대상 구성을 만드는 방법을 알 수 있습니다.
이 끝점으로 수행할 수 있는 작업에 대한 자세한 내용은 다음 문서를 참조하십시오.
이 끝점이 대상 작성 프로세스에 맞는 위치를 이해하려면 다음 문서를 참조하십시오.