使用Destination SDK创建的目标的服务器规范

目标服务器规范定义将从Adobe Experience Platform接收数据的目标平台的类型，以及平台与您的目标之间的通信参数。 例如：

• A 流式 目标服务器规范定义将从Platform接收HTTP消息的HTTP服务器端点。 要了解如何配置对端点的HTTP调用的格式，请阅读 模板规范 页面。
• An Amazon S3 目标服务器规范定义 S3 Platform将导出文件的存储段名称和路径。
• An 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处理，如下图所示。

使用用户输入连接到目标

当在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}}"
      }
   }
}

后续步骤

阅读本文后，您应该更好地了解什么是目标服务器规范，以及如何对其进行配置。

要了解有关其他目标服务器组件的更多信息，请参阅以下文章：

• 模板规范
• 消息格式
• 文件格式配置