대상 서버 사양은 Adobe Experience Platform에서 데이터를 수신할 대상 플랫폼의 유형 및 플랫폼과 대상 간의 통신 매개 변수를 정의합니다. 예:
이 구성 요소가 Destination SDK으로 만든 통합에 어디에 맞는지 이해하려면 의 다이어그램을 참조하십시오. 구성 옵션 설명서 또는 다음 대상 구성 개요 페이지를 참조하십시오.
다음을 통해 대상 서버 사양을 구성할 수 있습니다. /authoring/destination-servers
엔드포인트. 이 페이지에 표시된 구성 요소를 구성할 수 있는 자세한 API 호출 예는 다음 API 참조 페이지를 참조하십시오.
이 페이지에는 모든 구성 매개 변수와 함께 Destination SDK에서 지원하는 모든 대상 서버 유형이 표시됩니다. 대상을 만들 때 매개 변수 값을 자신의 매개 변수 값으로 바꿉니다.
Destination SDK에서 지원하는 모든 매개변수 이름 및 값은 다음과 같습니다. 대소문자 구분. 대소문자 구분 오류를 방지하려면 설명서에 표시된 대로 매개 변수 이름과 값을 정확히 사용하십시오.
이 페이지에 설명된 기능을 지원하는 통합 유형에 대한 자세한 내용은 아래 표를 참조하십시오.
통합 유형 | 기능 지원 |
---|---|
실시간(스트리밍) 통합 | 예 |
파일 기반 (일괄 처리) 통합 | 예 |
날짜 생성 중 또는 업데이트 중 대상 서버에서는 이 페이지에 설명된 서버 유형 구성 중 하나를 사용합니다. 통합 요구 사항에 따라 이러한 예제의 샘플 매개 변수 값을 자신의 매개 변수로 교체해야 합니다.
Destination SDK을 통해 대상 서버를 만들 때 구성 매개 변수 값을 하드 코딩하거나 템플릿화된 필드를 사용하여 정의할 수 있습니다. 템플릿화된 필드를 사용하면 Platform UI에서 사용자가 제공한 값을 읽을 수 있습니다.
대상 서버 매개 변수에는 구성 가능한 필드가 두 개 있습니다. 이러한 옵션은 하드 코딩된 값을 사용할지 또는 템플릿화된 값을 사용할지 여부를 지정합니다.
매개변수 | 유형 | 설명 |
---|---|---|
templatingStrategy |
문자열 | 필수 여부. 다음을 통해 하드 코딩된 값이 있는지 여부를 정의합니다. value 필드 또는 UI에서 사용자가 구성할 수 있는 값입니다. 지원되는 값:
|
value |
문자열 | 필수 여부. 매개 변수 값을 정의합니다. 지원되는 값 유형:
|
하드 코딩된 필드와 템플릿화된 필드는 만드는 통합 유형에 따라 Destination SDK에서 각각 고유한 용도가 있습니다.
사용자 입력 없이 대상에 연결하는 중
사용자 대상에 연결 platform UI에서 해당 입력 없이 대상 연결 프로세스를 처리할 수 있습니다.
이를 위해 서버 사양에서 대상 플랫폼 연결 매개변수를 하드 코딩할 수 있습니다. 대상 서버 구성에서 하드 코딩된 매개 변수 값을 사용하면 사용자의 입력 없이 Adobe Experience Platform과 대상 플랫폼 간의 연결이 처리됩니다.
아래 예에서 파트너는 path.value
필드가 하드코딩되고 있습니다.
{
"name":"Data Landing Zone destination server",
"destinationServerType":"FILE_BASED_DLZ",
"fileBasedDlzDestination":{
"path":{
"templatingStrategy":"NONE",
"value":"Your/hardcoded/path/here"
},
"useCase": "Your use case"
}
}
따라서 사용자가 대상 연결 자습서, 이(가) 인증 단계. 대신, 아래 이미지에 표시된 대로 인증은 Platform에서 처리됩니다.
사용자 입력으로 대상에 연결하는 중
API 끝점 선택 또는 필드 값 제공과 같이, Platform UI의 특정 사용자 입력 후 Platform과 대상 간의 연결을 설정해야 하는 경우, 서버 사양의 템플릿화된 필드를 사용하여 사용자 입력을 읽고 대상 플랫폼에 연결할 수 있습니다.
아래 예에서 파트너는 실시간(스트리밍) 통합 및 url.value
필드는 템플릿화된 매개 변수를 사용합니다. {{customerData.region}}
사용자 입력을 기반으로 API 끝점의 일부를 개인화합니다.
{
"name":"Templatized API endpoint example",
"destinationServerType":"URL_BASED",
"urlBasedDestination":{
"url":{
"templatingStrategy":"PEBBLE_V1",
"value":"https://api.yourcompany.com/data/{{customerData.region}}/items"
}
}
}
사용자에게 Platform UI에서 값을 선택할 수 있는 옵션을 제공하려면 region
매개 변수도 다음에 정의해야 합니다. 대상 구성 아래 표시된 대로 고객 데이터 필드로:
"customerDataFields":[
{
"name":"region",
"title":"Region",
"description":"Select an option",
"type":"string",
"isRequired":true,
"readOnly":false,
"enum":[
"US",
"EU"
]
}
따라서 사용자가 대상 연결 자습서를 설치한 후 대상 플랫폼에 연결하려면 먼저 지역을 선택해야 합니다. 대상이 대상에 연결되면 템플릿화된 필드입니다 {{customerData.region}}
는 아래 이미지에 표시된 대로 UI에서 사용자가 선택한 값으로 대체됩니다.
이 대상 서버 유형을 사용하면 HTTP 요청을 통해 Adobe Experience Platform의 데이터를 대상으로 내보낼 수 있습니다. 서버 구성에는 메시지를 받는 서버(사용자 측 서버)에 대한 정보가 포함되어 있습니다.
이 프로세스는 사용자 데이터를 일련의 HTTP 메시지로 대상 플랫폼에 전달합니다. 아래의 매개 변수는 HTTP 서버 사양 템플릿을 형성합니다.
아래 샘플은 실시간(스트리밍) 대상에 대한 대상 서버 구성의 예를 보여줍니다.
{
"name":"Your destination server name",
"destinationServerType":"URL_BASED",
"urlBasedDestination":{
"url":{
"templatingStrategy":"PEBBLE_V1",
"value":"{YOUR_API_ENDPOINT}"
}
}
}
매개변수 | 유형 | 설명 |
---|---|---|
name |
문자열 | 필수 여부. Adobe 시에만 표시되는 서버의 친숙한 이름을 나타냅니다. 이 이름은 파트너나 고객에게 표시되지 않습니다. 예: Moviestar destination server . |
destinationServerType |
문자열 | 필수 여부. 다음으로 설정 URL_BASED 스트리밍 대상용입니다. |
templatingStrategy |
문자열 | 필수 여부.
|
value |
문자열 | 필수 여부. Experience Platform이 연결해야 하는 API 끝점의 주소를 입력합니다. |
이 대상 서버를 사용하면 Adobe Experience Platform 데이터가 포함된 파일을 Amazon S3 스토리지로 내보낼 수 있습니다.
아래 샘플은 Amazon S3 대상에 대한 대상 서버 구성의 예를 보여줍니다.
{
"name":"Amazon S3 destination",
"destinationServerType":"FILE_BASED_S3",
"fileBasedS3Destination":{
"bucket":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.bucket}}"
},
"path":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.path}}"
}
}
}
매개변수 | 유형 | 설명 |
---|---|---|
name |
문자열 | 대상 서버의 이름입니다. |
destinationServerType |
문자열 | 대상 플랫폼에 따라 이 값을 설정하십시오. 파일을 로 내보내려면 Amazon S3 버킷, 이 항목을 다음으로 설정 FILE_BASED_S3 . |
fileBasedS3Destination.bucket.templatingStrategy |
문자열 | 필수 여부. 에 사용된 값의 유형에 따라 이 값을 설정하십시오. bucket.value 필드.
|
fileBasedS3Destination.bucket.value |
문자열 | 의 이름입니다. Amazon S3 이 대상에서 사용할 버킷. 이 필드는 의 값을 읽는 템플릿화된 필드일 수 있습니다. 고객 데이터 필드 사용자가 입력(위 예에서 보듯이) 또는 하드 코딩된 값(예: ) "value":"MyBucket" . |
fileBasedS3Destination.path.templatingStrategy |
문자열 | 필수 여부. 에 사용된 값의 유형에 따라 이 값을 설정하십시오. path.value 필드.
|
fileBasedS3Destination.path.value |
문자열 | 에 대한 경로 Amazon S3 이 대상에서 사용할 버킷. 이 필드는 의 값을 읽는 템플릿화된 필드일 수 있습니다. 고객 데이터 필드 사용자가 입력(위 예에서 보듯이) 또는 하드 코딩된 값(예: ) "value":"/path/to/MyBucket" . |
이 대상 서버를 사용하면 Adobe Experience Platform 데이터가 포함된 파일을 SFTP 스토리지 서버입니다.
아래 샘플은 SFTP 대상에 대한 대상 서버 구성의 예를 보여 줍니다.
{
"name":"File-based SFTP destination server",
"destinationServerType":"FILE_BASED_SFTP",
"fileBasedSFTPDestination":{
"rootDirectory":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.rootDirectory}}"
},
"hostName":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.hostName}}"
},
"port":22,
"encryptionMode":"PGP"
}
}
매개변수 | 유형 | 설명 |
---|---|---|
name |
문자열 | 대상 서버의 이름입니다. |
destinationServerType |
문자열 | 대상 플랫폼에 따라 이 값을 설정하십시오. 파일을 로 내보내려면 SFTP 대상, 이 을(를) (으)로 설정 FILE_BASED_SFTP . |
fileBasedSFTPDestination.rootDirectory.templatingStrategy |
문자열 | 필수 여부. 에 사용된 값의 유형에 따라 이 값을 설정하십시오. rootDirectory.value 필드.
|
fileBasedSFTPDestination.rootDirectory.value |
문자열 | 내보낸 파일을 호스팅할 디렉토리의 경로입니다. 이 필드는 의 값을 읽는 템플릿화된 필드일 수 있습니다. 고객 데이터 필드 사용자가 입력(위 예에서 보듯이) 또는 하드 코딩된 값(예: ) "value":"Storage/MyDirectory" |
fileBasedSFTPDestination.hostName.templatingStrategy |
문자열 | 필수 여부. 에 사용된 값의 유형에 따라 이 값을 설정하십시오. hostName.value 필드.
|
fileBasedSFTPDestination.hostName.value |
문자열 | SFTP 서버의 호스트 이름입니다. 이 필드는 의 값을 읽는 템플릿화된 필드일 수 있습니다. 고객 데이터 필드 사용자가 입력(위 예에서 보듯이) 또는 하드 코딩된 값(예: ) "hostName.value":"my.hostname.com" . |
port |
정수 | SFTP 파일 서버 포트입니다. |
encryptionMode |
문자열 | 파일 암호화를 사용할지 여부를 나타냅니다. 지원되는 값:
|
이 대상 서버를 사용하면 Adobe Experience Platform 데이터가 포함된 파일을 Azure Data Lake Storage 계정입니다.
아래 샘플은 다음에 대한 대상 서버 구성의 예를 보여줍니다. Azure Data Lake Storage 대상.
{
"name":"ADLS destination server",
"destinationServerType":"FILE_BASED_ADLS_GEN2",
"fileBasedAdlsGen2Destination":{
"path":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.path}}"
}
}
}
매개변수 | 유형 | 설명 |
---|---|---|
name |
문자열 | 대상 연결의 이름입니다. |
destinationServerType |
문자열 | 대상 플랫폼에 따라 이 값을 설정하십시오. 대상 Azure Data Lake Storage 대상, 다음으로 설정 FILE_BASED_ADLS_GEN2 . |
fileBasedAdlsGen2Destination.path.templatingStrategy |
문자열 | 필수 여부. 에 사용된 값의 유형에 따라 이 값을 설정하십시오. path.value 필드.
|
fileBasedAdlsGen2Destination.path.value |
문자열 | 에 대한 경로 ADLS 스토리지 폴더입니다. 이 필드는 의 값을 읽는 템플릿화된 필드일 수 있습니다. 고객 데이터 필드 사용자가 입력(위 예에서 보듯이) 또는 하드 코딩된 값(예: ) abfs://<file_system>@<account_name>.dfs.core.windows.net/<path>/ . |
이 대상 서버를 사용하면 Adobe Experience Platform 데이터가 포함된 파일을 Azure Blob Storage 컨테이너.
아래 샘플은 다음에 대한 대상 서버 구성의 예를 보여줍니다. Azure Blob Storage 대상.
{
"name":"Blob destination server",
"destinationServerType":"FILE_BASED_AZURE_BLOB",
"fileBasedAzureBlobDestination":{
"path":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.path}}"
},
"container":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.container}}"
}
}
}
매개변수 | 유형 | 설명 |
---|---|---|
name |
문자열 | 대상 연결의 이름입니다. |
destinationServerType |
문자열 | 대상 플랫폼에 따라 이 값을 설정하십시오. 대상 Azure Blob Storage 대상, 다음으로 설정 FILE_BASED_AZURE_BLOB . |
fileBasedAzureBlobDestination.path.templatingStrategy |
문자열 | 필수 여부. 에 사용된 값의 유형에 따라 이 값을 설정하십시오. path.value 필드.
|
fileBasedAzureBlobDestination.path.value |
문자열 | 에 대한 경로 Azure Blob 스토리지. 이 필드는 의 값을 읽는 템플릿화된 필드일 수 있습니다. 고객 데이터 필드 사용자가 입력(위 예에서 보듯이) 또는 하드 코딩된 값(예: ) https://myaccount.blob.core.windows.net/ . |
fileBasedAzureBlobDestination.container.templatingStrategy |
문자열 | 필수 여부. 에 사용된 값의 유형에 따라 이 값을 설정하십시오. container.value 필드. |
fileBasedAzureBlobDestination.container.value |
문자열 | 이 대상에 사용할 Azure Blob 저장소 컨테이너의 이름입니다. 이 필드는 의 값을 읽는 템플릿화된 필드일 수 있습니다. 고객 데이터 필드 사용자가 입력(위 예에서 보듯이) 또는 하드 코딩된 값(예: ) myContainer . |
이 대상 서버를 사용하면 플랫폼 데이터가 포함된 파일을 Data Landing Zone 스토리지.
아래 샘플에서는 Data Landing Zone (DLZ) 대상.
{
"name":"Data Landing Zone destination server",
"destinationServerType":"FILE_BASED_DLZ",
"fileBasedDlzDestination":{
"path":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.path}}"
},
"useCase": "Your use case"
}
}
매개변수 | 유형 | 설명 |
---|---|---|
name |
문자열 | 대상 연결의 이름입니다. |
destinationServerType |
문자열 | 대상 플랫폼에 따라 이 값을 설정하십시오. 대상 Data Landing Zone 대상, 다음으로 설정 FILE_BASED_DLZ . |
fileBasedDlzDestination.path.templatingStrategy |
문자열 | 필수 여부. 에 사용된 값의 유형에 따라 이 값을 설정하십시오. path.value 필드.
|
fileBasedDlzDestination.path.value |
문자열 | 내보낸 파일을 호스팅할 대상 폴더의 경로입니다. |
이 대상 서버를 사용하면 플랫폼 데이터가 포함된 파일을 Google Cloud Storage 계정입니다.
아래 샘플에서는 Google Cloud Storage 대상.
{
"name":"Google Cloud Storage Server",
"destinationServerType":"FILE_BASED_GOOGLE_CLOUD",
"fileBasedGoogleCloudStorageDestination":{
"bucket":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.bucket}}"
},
"path":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.path}}"
}
}
}
매개변수 | 유형 | 설명 |
---|---|---|
name |
문자열 | 대상 연결의 이름입니다. |
destinationServerType |
문자열 | 대상 플랫폼에 따라 이 값을 설정하십시오. 대상 Google Cloud Storage 대상, 다음으로 설정 FILE_BASED_GOOGLE_CLOUD . |
fileBasedGoogleCloudStorageDestination.bucket.templatingStrategy |
문자열 | 필수 여부. 에 사용된 값의 유형에 따라 이 값을 설정하십시오. bucket.value 필드.
|
fileBasedGoogleCloudStorageDestination.bucket.value |
문자열 | 의 이름입니다. Google Cloud Storage 이 대상에서 사용할 버킷. 이 필드는 의 값을 읽는 템플릿화된 필드일 수 있습니다. 고객 데이터 필드 사용자가 입력(위 예에서 보듯이) 또는 하드 코딩된 값(예: ) "value": "my-bucket" . |
fileBasedGoogleCloudStorageDestination.path.templatingStrategy |
문자열 | 필수 여부. 에 사용된 값의 유형에 따라 이 값을 설정하십시오. path.value 필드.
|
fileBasedGoogleCloudStorageDestination.path.value |
문자열 | 에 대한 경로 Google Cloud Storage 이 대상에서 사용할 폴더입니다. 이 필드는 의 값을 읽는 템플릿화된 필드일 수 있습니다. 고객 데이터 필드 사용자가 입력(위 예에서 보듯이) 또는 하드 코딩된 값(예: ) "value": "/path/to/my-bucket" . |
이 문서를 읽고 나면 대상 서버 사양의 의미와 대상 서버 사양을 구성하는 방법을 보다 잘 이해할 수 있습니다.
다른 대상 서버 구성 요소에 대한 자세한 내용은 다음 문서를 참조하십시오.