合作夥伴結構描述設定
Experience Platform使用結構描述，以一致且可重複使用的方式說明資料結構。 將資料內嵌至Platform時，會根據XDM結構描述進行建構。 如需結構描述組合模型的詳細資訊，包括設計原則和最佳實務，請參閱結構描述組合的基本概念。
使用Destination SDK建立目的地時，您可以定義自己的合作夥伴結構描述，以供目的地平台使用。 這可讓使用者將設定檔屬性從Platform對應至目的地平台可辨識的特定欄位，而且全都在Platform UI中。
為您的目的地設定合作夥伴結構描述時，您可以微調目的地平台支援的欄位對應，例如：
- 允許使用者將
phoneNumberXDM屬性對應到目的地平台支援的phone屬性。 - 建立動態合作夥伴結構描述，讓Experience Platform可以動態呼叫，以擷取目的地內所有支援屬性的清單。
- 定義目的地平台所需的必要欄位對應。
若要瞭解此元件在何處適合使用Destination SDK建立的整合，請參閱設定選項檔案中的圖表，或參閱如何使用Destination SDK設定檔案型目的地的指南。
您可以透過/authoring/destinations端點設定您的結構描述設定。 請參閱下列API參考頁面，以取得詳細的API呼叫範例，您可在此範例設定本頁面中顯示的元件。
本文會說明您可用於目的地的所有支援結構描述設定選項，並顯示客戶會在Platform UI中看到的內容。
支援的整合型別 supported-integration-types
如需瞭解哪些型別的整合支援本頁面所述功能的詳細資訊，請參閱下表。
支援的結構描述設定 supported-schema-types
Destination SDK支援多種結構描述設定：
- 靜態結構描述是透過
schemaConfig區段中的profileFields陣列來定義。 在靜態結構描述中，您定義應顯示在profileFields陣列中Experience PlatformUI的每個目標屬性。 如果您需要更新結構描述，您必須更新目的地組態。 - 動態結構描述會使用稱為動態結構描述伺服器的其他目的地伺服器型別，以動態擷取支援的目標屬性，並根據您自己的API產生結構描述。 動態結構描述不使用
profileFields陣列。 如果您需要更新結構描述，則無需更新目的地組態。 而是由動態結構描述伺服器從您的API擷取更新的結構描述。 - 在架構設定中，您可以選擇新增必要（或預先定義）的對應。 這些是使用者可以在Platform UI中檢視的對應，但在設定與您的目的地的連線時無法修改。 例如，您可以強制電子郵件位址列位一律傳送到目的地。
schemaConfig區段會根據您所需的結構描述型別，使用多個設定引數，如下節所示。
建立靜態結構描述 attributes-schema
若要使用設定檔屬性建立靜態結構描述，請在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"]
}
profileFieldsprofileFields陣列時，您可以完全省略useCustomerSchemaForAttributeMapping引數。useCustomerSchemaForAttributeMapping啟用或停用客戶結構描述中的屬性對應到您在profileFields陣列中定義的屬性。
- 如果設為
true，使用者只會在對應欄位中看到來源欄。profileFields不適用於此情況。 - 如果設為
false，使用者可以從其結構描述將來源屬性對應到您在profileFields陣列中定義的屬性。
預設值為 false。
profileRequiredtrue。segmentRequiredtrue。segmentNamespaceAllowListsegmentNamespaceDenyList.一起使用
範例：
"segmentNamespaceAllowList": ["AudienceManager"]將允許使用者僅將對象從AudienceManager名稱空間對應至此目的地。若要允許使用者將任何對象匯出至您的目的地，您可以忽略此引數。
如果您的設定中同時缺少
segmentNamespaceAllowList和segmentNamespaceDenyList，使用者將只能匯出源自分段服務的對象。segmentNamespaceDenyListsegmentNamespaceAllowed一起使用。範例：
"segmentNamespaceDenyList": ["AudienceManager"]將封鎖使用者從AudienceManager名稱空間對應對象到此目的地。若要允許使用者將任何對象匯出至您的目的地，您可以忽略此引數。
如果您的設定中同時缺少
segmentNamespaceAllowed和segmentNamespaceDenyList，使用者將只能匯出源自分段服務的對象。若要允許匯出所有對象，無論來源為何，請設定
"segmentNamespaceDenyList":[]。產生的UI體驗會顯示在下圖中。
當使用者選取目標對應時，他們可以看到profileFields陣列中定義的欄位。
選取屬性後，他們便可在目標欄位欄中看到這些屬性。
建立動態結構描述 dynamic-schema-configuration
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
}
dynamicEnum.authenticationRuledynamicEnum.destinationServerIdinstanceId。 此目的地伺服器包含API端點，Experience Platform會呼叫該API端點來擷取動態結構描述。dynamicEnum.valuedynamicEnum.responseFormatSCHEMA。profileRequiredtrue。segmentRequiredtrue。必要的對應 required-mappings
在結構描述設定中，除了您的靜態或動態結構描述外，您還可以選擇新增必要（或預先定義）的對應。 這些是使用者可以在Platform UI中檢視的對應，但在設定與您的目的地的連線時無法修改。
例如，您可以強制電子郵件位址列位一律傳送到目的地。
- 您可以設定必要來源欄位和必要目的地欄位。 在此情況下，使用者無法編輯或選取兩個欄位中的任何一個，並且只能檢視選取專案。
- 您只能設定必要的目的地欄位。 在此情況下，使用者可選取來源欄位，以對應至目的地。
請參閱以下兩個結構描述設定範例，其中包含必要的對應，以及啟動資料至批次目的地工作流程的對應步驟中這些設定的外觀。
以下範例顯示必要的來源和目的地對應。 當來源欄位和目的地欄位都指定為必要對應時，使用者無法選取或編輯這兩個欄位中的任何一個，且只能檢視預先定義的選取專案。
| code language-json |
|---|
|
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 layout-auto | |||
|---|---|---|---|
| 參數 | 類型 | 必要/選用 | 說明 |
requiredMappingsOnly |
布林值 | 選填 | 當此設定為true時，除了您在requiredMappings陣列中定義的必要對應之外，使用者無法對應啟動流程中的其他屬性和身分。 |
requiredMappings.sourceType |
字串 | 必要 |
指示
|
requiredMappings.source |
字串 | 必要 |
表示來源欄位的值。 支援的值型別：
|
requiredMappings.destination |
字串 | 必要 | 表示目標欄位的值。 當來源欄位和目的地欄位都指定為必要對應時，使用者無法選取或編輯這兩個欄位中的任何一個，且只能檢視選取專案。 |
因此，Platform UI中的 Source欄位 和 Target欄位 區段都會呈現灰色。
以下範例顯示必要的目的地對應。 如果僅將目的地欄位指定為必要欄位，則使用者可以選擇要與其對應的來源欄位。
| code language-json |
|---|
|
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 layout-auto | |||
|---|---|---|---|
| 參數 | 類型 | 必要/選用 | 說明 |
requiredMappingsOnly |
布林值 | 選填 | 當此設定為true時，除了您在requiredMappings陣列中定義的必要對應之外，使用者無法對應啟動流程中的其他屬性和身分。 |
requiredMappings.destination |
字串 | 必要 | 表示目標欄位的值。 當僅指定目的地欄位時，使用者可以選取來源欄位以對應至目的地。 |
mandatoryRequired |
布林值 | 選填 | 指示對應是否應標示為必要屬性。 |
primaryKeyRequired |
布林值 | 選填 | 指示對應是否應標示為重複資料刪除索引鍵。 |
因此，Platform UI中的 Target欄位 區段會呈現灰色，而 Source欄位 區段為作用中，使用者可以與其互動。 必要索引鍵 和 重複資料刪除索引鍵 選項作用中，使用者無法變更它們。
設定對外部對象的支援 external-audiences
若要設定您的目的地以支援外部產生的對象的啟用，請在schemaConfig區段中加入以下程式碼片段。
"schemaConfig": {
"segmentNamespaceDenyList": [],
...
}
請參閱本頁上方的表格中的屬性說明，以進一步瞭解segmentNamespaceDenyList功能。
後續步驟 next-steps
閱讀本文後，您應該更瞭解Destination SDK支援哪些結構描述型別，以及如何設定您的結構描述。
若要深入瞭解其他目的地元件，請參閱下列文章：