合作伙伴架构配置

Experience Platform 会使用架构，以便以可重用的一致方式描述数据结构。当数据被摄取到Platform中时，它会根据XDM架构进行构建。 有关架构组合模型的更多信息，包括设计原则和最佳实践，请参阅 模式组合基础.

使用Destination SDK构建目标时，您可以定义自己的合作伙伴架构以供目标平台使用。 这使用户能够将配置文件属性从Platform映射到目标平台可识别的特定字段，所有这些字段均在Platform UI中。

在为目标配置合作伙伴架构时，您可以优化目标平台支持的字段映射，例如：

• 允许用户映射 phoneNumber XDM属性到 phone 目标平台支持的属性。
• 创建动态合作伙伴架构，Experience Platform可以动态调用这些架构以检索目标中所有受支持属性的列表。
• 定义目标平台所需的必填字段映射。

要了解此组件在何处适合使用Destination SDK创建的集成，请参阅中的图表 配置选项 文档或参阅指南，了解如何 使用Destination SDK配置基于文件的目标.

您可以通过以下方式配置架构设置 /authoring/destinations 端点。 有关详细的API调用示例，请参阅以下API参考页面，您可以在其中配置此页面中显示的组件。

• 创建目标配置
• 更新目标配置

本文介绍了可用于目标的所有受支持的架构配置选项，并显示了客户将在Platform UI中看到的内容。

支持的集成类型

有关哪些类型的集成支持此页面上描述的功能，请参阅下表。

支持的架构配置

Destination SDK支持多种架构配置：

• 静态架构是通过 profileFields 中的数组 schemaConfig 部分。 在静态架构中，您定义了应在Experience PlatformUI中显示的每个目标属性 profileFields 数组。 如果需要更新架构，您必须 更新目标配置.
• 动态架构使用其他目标服务器类型，称为 动态模式服务器，以动态检索支持的目标属性并根据您自己的API生成架构。 动态架构不使用 profileFields 数组。 如果需要更新架构，则无需 更新目标配置. 动态架构服务器而是从API中检索更新的架构。
• 在架构配置中，您可以选择添加所需的（或预定义的）映射。 用户可以在Platform UI中查看这些映射，但在设置与目标的连接时，无法修改这些映射。 例如，您可以强制电子邮件地址字段始终发送到目标。

此 schemaConfig 部分会根据所需的架构类型使用多个配置参数，如下部分所示。

创建静态架构

要创建具有配置文件属性的静态架构，请在 profileFields 数组，如下所示。

"schemaConfig":{
      "profileFields":[
           {
              "name":"phoneNo",
              "title":"phoneNo",
              "description":"This is a fixed attribute on your destination side that customers can map profile attributes to. For example, the mobilePhone.number value in Experience Platform could be phoneNo on your side.",
              "type":"string",
              "isRequired":false,
              "readOnly":false,
              "hidden":false
           },
                      {
              "name":"firstName",
              "title":"firstName",
              "description":"This is a fixed attribute on your destination side that customers can map profile attributes to. For example, the person.name.firstName value in Experience Platform could be firstName on your side.",
              "type":"string",
              "isRequired":false,
              "readOnly":false,
              "hidden":false
           },
                      {
              "name":"lastName",
              "title":"lastName",
              "description":"This is a fixed attribute on your destination side that customers can map profile attributes to. For example, the person.name.lastName value in Experience Platform could be phoneNo on your side.",
              "type":"string",
              "isRequired":false,
              "readOnly":false,
              "hidden":false
           }
        ],
      "useCustomerSchemaForAttributeMapping":false,
      "profileRequired":true,
      "segmentRequired":true,
      "identityRequired":true,
      "segmentNamespaceAllowList": ["someNamespace"],
      "segmentNamespaceDenyList": ["someOtherNamespace"]

}

生成的UI体验如下图所示。

当用户选择目标映射时，他们将会看到中定义的字段。 profileFields 数组。

选择属性后，他们可以在目标字段列中看到这些属性。

创建动态架构

Destination SDK支持创建动态合作伙伴架构。 与静态架构不同，动态架构不使用 profileFields 数组。 动态架构会改用动态架构服务器，该服务器会连接到您自己的API，并在其中检索架构配置。

在动态模式配置中， profileFields 数组被替换为 dynamicSchemaConfig 部分，如下所示。

"schemaConfig":{
   "dynamicSchemaConfig":{
      "dynamicEnum": {
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"DYNAMIC_SCHEMA_SERVER_ID",
         "value": "Schema Name",
         "responseFormat": "SCHEMA"
      }
   },
   "profileRequired":true,
   "segmentRequired":true,
   "identityRequired":true
}

必需的映射

在架构配置中，除了静态或动态架构外，您还可以选择添加所需的（或预定义的）映射。 用户可以在Platform UI中查看这些映射，但在设置与目标的连接时，无法修改这些映射。

例如，您可以强制电子邮件地址字段始终发送到目标。

请参阅以下两个具有所需映射的架构配置示例，以及它们在的映射步骤中会是什么样子 将数据激活到批处理目标工作流.

"schemaConfig": {
    "requiredMappingsOnly": true,
    "requiredMappings": [
      {
        "sourceType": "text/x.schema-path",
        "source": "personalEmail.address",
        "destination": "personalEmail.address"
      }
    ]
}

"schemaConfig": {
    "requiredMappingsOnly": true,
    "requiredMappings": [
      {
        "destination": "identityMap.ExamplePartner_ID",
        "mandatoryRequired": true,
        "primaryKeyRequired": true
      }
    ]
}

后续步骤

阅读本文后，您应该更好地了解Destination SDK支持哪些架构类型，以及如何配置架构。

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

• 客户身份验证
• OAuth2身份验证
• UI属性
• 客户数据字段
• 身份命名空间配置
• 支持的映射配置
• 目标投放
• 受众元数据配置
• 聚合策略
• 批次配置
• 历史配置文件资格

Business.Adobe.com 资源