대상 구성 만들기
- 주제:
- 대상
작성 대상:
- 관리자
- 사용자
이 페이지는 /authoring/destinations
API 끝점을 사용하여 고유한 대상 구성을 만드는 데 사용할 수 있는 API 요청 및 페이로드를 예시합니다.
이 끝점을 통해 구성할 수 있는 기능에 대한 자세한 설명은 다음 문서를 참조하십시오.
대상 구성 API 작업 시작
계속하기 전에 시작 안내서에서 필요한 대상 작성 권한 및 필수 헤더를 얻는 방법을 포함하여 API를 성공적으로 호출하기 위해 알아야 하는 중요한 정보를 검토하십시오.
대상 구성 만들기
/authoring/destinations
끝점에 대한 POST 요청을 수행하여 새 대상 구성을 만들 수 있습니다.
platform.adobe.io/data/core/activation/authoring/destinations
API 형식
POST /authoring/destinations
다음 요청은 페이로드에 제공된 매개 변수로 구성된 새 Amazon S3 대상 구성을 만듭니다. 아래 페이로드에는 /authoring/destinations
끝점에서 허용하는 파일 기반 대상에 대한 모든 매개 변수가 포함되어 있습니다.
모든 매개 변수를 API 호출에 추가할 필요는 없으며, 페이로드는 API 요구 사항에 따라 사용자 지정할 수 있습니다.
curl -X POST https://platform.adobe.io/data/core/activation/authoring/destinations \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '
{
"name":"Amazon S3 destination with predefined CSV formatting options",
"description":"Amazon S3 destination with predefined CSV formatting options",
"status":"TEST",
"customerAuthenticationConfigurations":[
{
"authType":"S3"
}
],
"customerDataFields":[
{
"name":"bucket",
"title":"Enter the name of your Amazon S3 bucket",
"description":"Amazon S3 bucket name",
"type":"string",
"isRequired":true,
"readOnly":false,
"hidden":false
},
{
"name":"path",
"title":"Enter the path to your S3 bucket folder",
"description":"Enter the path to your S3 bucket folder",
"type":"string",
"isRequired":true,
"pattern":"^[A-Za-z]+$",
"readOnly":false,
"hidden":false
},
{
"name":"compression",
"title":"Compression format",
"description":"Select the desired file compression format.",
"type":"string",
"isRequired":true,
"readOnly":false,
"enum":[
"SNAPPY",
"GZIP",
"DEFLATE",
"NONE"
]
},
{
"name":"fileType",
"title":"Select a fileType",
"description":"Select fileType",
"type":"string",
"isRequired":true,
"readOnly":false,
"hidden":false,
"enum":[
"csv",
"json",
"parquet"
],
"default":"csv"
}
],
"uiAttributes":{
"documentationLink":"https://www.adobe.com/go/destinations-amazon-s3-en",
"category":"cloudStorage",
"icon":{
"key":"amazonS3"
},
"connectionType":"S3",
"frequency":"Batch"
},
"destinationDelivery":[
{
"deliveryMatchers":[
{
"type":"SOURCE",
"value":[
"batch"
]
}
],
"authenticationRule":"CUSTOMER_AUTHENTICATION",
"destinationServerId":"{{destinationServerId}}"
}
],
"schemaConfig":{
"profileRequired":true,
"segmentRequired":true,
"identityRequired":true
},
"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%"
},
"backfillHistoricalProfileData":true
}
}'
name
description

status
TEST
, PUBLISHED
및 DELETED
입니다. 대상을 처음 구성할 때 TEST
을(를) 사용하십시오.customerAuthenticationConfigurations.authType
customerDataFields.name
customerDataFields.type
customerDataFields.title
customerDataFields.isRequired
customerDataFields.enum
customerDataFields.default
enum
목록에서 기본값을 정의합니다.customerDataFields.pattern
^[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 특성을 참조하십시오. 설명서 링크를 표시하는

uiAttributes.category
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
대상에 따른 연결 유형입니다. 지원되는 값:
Server-to-server
Cloud storage
Azure Blob
Azure Data Lake Storage
S3
SFTP
DLZ
uiAttributes.frequency
Streaming
(으)로 설정하거나 파일을 대상으로 내보낼 때 Batch
(으)로 설정합니다.identityNamespaces.externalId.acceptsAttributes
identityNamespaces.externalId.acceptsCustomNamespaces
identityNamespaces.externalId.transformation
identityNamespaces.externalId.acceptedGlobalNamespaces
acceptedGlobalNamespaces
을(를) 사용하는 경우 "requiredTransformation":"sha256(lower($))"
을(를) 사용하여 전자 메일 주소 또는 전화 번호를 소문자로 나타내고 해시할 수 있습니다.destinationDelivery.authenticationRule
Experience Platform명의 고객이 대상에 연결하는 방법을 나타냅니다. 허용되는 값은 CUSTOMER_AUTHENTICATION
, PLATFORM_AUTHENTICATION
, NONE
입니다.
- Experience Platform 고객이 사용자 이름과 암호, 전달자 토큰 또는 다른 인증 방법을 통해 시스템에 로그인하는 경우
CUSTOMER_AUTHENTICATION
을(를) 사용합니다. 예를 들어customerAuthenticationConfigurations
에서authType: OAUTH2
또는authType:BEARER
도 선택한 경우 이 옵션을 선택합니다. - Adobe과 대상 사이에 글로벌 인증 시스템이 있고 Experience Platform 고객이 대상에 연결하기 위해 인증 자격 증명을 제공할 필요가 없는 경우
PLATFORM_AUTHENTICATION
을(를) 사용합니다. 이 경우 자격 증명 API 구성을 사용하여 자격 증명 개체를 만들어야 합니다. - 대상 플랫폼으로 데이터를 보내는 데 인증이 필요하지 않은 경우
NONE
을(를) 사용합니다.
backfillHistoricalProfileData
true
(으)로 설정하십시오.segmentMappingConfig.mapUserInput
segmentMappingConfig.mapExperiencePlatformSegmentId
segmentMappingConfig.mapExperiencePlatformSegmentName
schemaConfig.profileFields
profileFields
을(를) 추가하면 사용자는 Experience Platform 특성을 대상 측의 사전 정의된 특성에 매핑할 수 있습니다.schemaConfig.profileRequired
true
을(를) 사용합니다.schemaConfig.segmentRequired
segmentRequired:true
을(를) 사용하십시오.schemaConfig.identityRequired
true
을(를) 사용합니다.API 오류 처리
Destination SDK API 엔드포인트는 일반적인 Experience Platform API 오류 메시지 원칙을 따릅니다. Experience Platform 문제 해결 안내서에서 API 상태 코드 및 요청 헤더 오류를 참조하십시오.
다음 단계
이 문서를 읽고 나면 이제 Destination SDK /authoring/destinations
API 끝점을 통해 새 대상 구성을 만드는 방법을 알 수 있습니다.
이 끝점으로 수행할 수 있는 작업에 대한 자세한 내용은 다음 문서를 참조하십시오.
이 끝점이 대상 작성 프로세스에 맞는 위치를 이해하려면 다음 문서를 참조하십시오.