以Destination SDK建立的目的地的伺服器規格

目的地伺服器規格會定義從Adobe Experience Platform接收資料的目的地平台型別，以及平台和目的地之間的通訊引數。 例如：

• A 串流 目的地伺服器規格會定義從Platform接收HTTP訊息的HTTP伺服器端點。 若要瞭解如何設定端點的HTTP呼叫格式，請閱讀 範本規格 頁面。
• 一個 Amazon S3 目的地伺服器規格會定義 S3 Platform將匯出檔案的時段名稱和路徑。
• 一個 SFTP 目的地伺服器規格會定義Platform將匯出檔案之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處理，如下圖所示。

使用使用者輸入連線到您的目的地

當平台UI中的特定使用者輸入（例如選取API端點或提供欄位值）之後，應該建立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)目的地伺服器

此目的地伺服器可讓您將包含Platform資料的檔案匯出至 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 目的地伺服器

此目的地伺服器可讓您將包含Platform資料的檔案匯出至 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 資源