Destination SDK으로 생성된 대상의 서버 사양

대상 서버 사양은 Adobe Experience Platform에서 데이터를 수신할 대상 플랫폼의 유형 및 플랫폼과 대상 간의 통신 매개 변수를 정의합니다. 예:

• A 스트리밍 대상 서버 사양은 플랫폼에서 HTTP 메시지를 수신할 HTTP 서버 엔드포인트를 정의합니다. 끝점에 대한 HTTP 호출의 형식을 구성하는 방법에 대해 알아보려면 사양 템플릿 페이지를 가리키도록 업데이트하는 중입니다.
• An Amazon 대상 서버 사양은 S3 플랫폼이 파일을 내보낼 버킷 이름 및 경로입니다.
• An SFTP 대상 서버 사양은 플랫폼이 파일을 내보내는 SFTP 서버의 호스트 이름, 루트 디렉터리, 통신 포트 및 암호화 유형을 정의합니다.

이 구성 요소가 Destination SDK으로 만든 통합에 어디에 맞는지 이해하려면 의 다이어그램을 참조하십시오. 구성 옵션 설명서 또는 다음 대상 구성 개요 페이지를 참조하십시오.

• Destination SDK을 사용하여 스트리밍 대상 구성
• Destination SDK을 사용하여 파일 기반 대상 구성

다음을 통해 대상 서버 사양을 구성할 수 있습니다. /authoring/destination-servers 엔드포인트. 이 페이지에 표시된 구성 요소를 구성할 수 있는 자세한 API 호출 예는 다음 API 참조 페이지를 참조하십시오.

• 대상 서버 구성 만들기
• 대상 서버 구성 업데이트

이 페이지에는 모든 구성 매개 변수와 함께 Destination SDK에서 지원하는 모든 대상 서버 유형이 표시됩니다. 대상을 만들 때 매개 변수 값을 자신의 매개 변수 값으로 바꿉니다.

지원되는 통합 유형

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

날짜 생성 중 또는 업데이트 중 대상 서버에서는 이 페이지에 설명된 서버 유형 구성 중 하나를 사용합니다. 통합 요구 사항에 따라 이러한 예제의 샘플 매개 변수 값을 자신의 매개 변수로 교체해야 합니다.

하드 코딩된 필드와 템플릿화된 필드

Destination SDK을 통해 대상 서버를 만들 때 구성 매개 변수 값을 하드 코딩하거나 템플릿화된 필드를 사용하여 정의할 수 있습니다. 템플릿화된 필드를 사용하면 Platform UI에서 사용자가 제공한 값을 읽을 수 있습니다.

대상 서버 매개 변수에는 구성 가능한 필드가 두 개 있습니다. 이러한 옵션은 하드 코딩된 값을 사용할지 또는 템플릿화된 값을 사용할지 여부를 지정합니다.

하드 코딩된 필드와 템플릿화된 필드를 사용해야 하는 경우

하드 코딩된 필드와 템플릿화된 필드는 만드는 통합 유형에 따라 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}"
      }
   }
}

Amazon S3 대상 서버

이 대상 서버를 사용하면 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}}"
      }
   }
}

SFTP 대상 서버

이 대상 서버를 사용하면 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"
   }
}

Azure Data Lake Storage (ADLS) 대상 서버

이 대상 서버를 사용하면 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}}"
      }
   }
}

Azure Blob Storage 대상 서버

이 대상 서버를 사용하면 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}}"
      }
   }
}

Data Landing Zone (DLZ) 대상 서버

이 대상 서버를 사용하면 플랫폼 데이터가 포함된 파일을 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"
   }
}

Google Cloud Storage 대상 서버

이 대상 서버를 사용하면 플랫폼 데이터가 포함된 파일을 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}}"
      }
   }
}

다음 단계

이 문서를 읽고 나면 대상 서버 사양의 의미와 대상 서버 사양을 구성하는 방법을 보다 잘 이해할 수 있습니다.

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

• 사양 템플릿
• 메시지 포맷
• 파일 서식 구성

Business.Adobe.com 리소스