結構描述組合基本概念

上次更新： 2023-11-14

主題：
Schemas
檢視有關此主題的更多資訊

建立對象：
Developer

User

Admin

Leader

本檔案將介紹 Experience Data Model (XDM)方案以及構成要在Adobe Experience Platform中使用的方案的建置組塊、原則和最佳實務。如需XDM的一般資訊，以及在中如何使用XDM。 Platform，請參閱 XDM系統概覽.

瞭解結構描述

結構是一組規則，可代表及驗證資料的結構和格式。從高層面來說，結構提供了真實對象 (如人) 的抽象定義，並概述應包含在該對象的每個執行個體中的資料 (如名字、姓氏、生日等)。

除了說明資料結構外，結構描述還會對資料套用限制和期望，以便在系統之間移動時進行驗證。這些標準定義可讓資料以一致方式解譯，無論其來源為何，並移除跨應用程式翻譯的需求。

Experience Platform 使用結構描述維護此語意標準化。結構描述是描述資料的標準方式 Experience Platform，所有符合結構描述的資料都可在同一組織內重複使用，而不會產生衝突，甚至可在多個組織間共用。

XDM結構描述適合用來以獨立格式儲存大量複雜的資料。請參閱以下小節：內嵌物件和巨量資料於本檔案附錄中，以瞭解有關XDM如何完成此工作的詳細資訊。

中的結構描述型工作流程 Experience Platform

標準化是背後的一項關鍵概念 Experience Platform. XDM以Adobe為驅動，致力於標準化客戶體驗資料並定義客戶體驗管理的標準結構描述。

基礎結構 Experience Platform 已建置，稱為 XDM System，促進以方案為基礎的工作流程，並包含 Schema Registry， Schema Editor、結構描述中繼資料和服務使用模式。請參閱 XDM系統概覽以取得詳細資訊。

在中運用結構有幾個主要優點 Experience Platform. 首先，結構描述可提供更好的資料控管和資料最小化，這對隱私權法規尤其重要。第二，使用Adobe的標準元件建置結構描述可允許現成的深入分析和以最少的自訂使用AI/ML服務。最後，結構描述可提供資料共用見解和高效協調的基礎架構。

規劃您的結構描述

建立結構描述的第一步是決定您嘗試在結構描述中擷取的概念，或真實世界的物件。一旦您識別了想要描述的概念，就可以開始規劃方案，考慮資料型別、潛在的身分欄位以及方案未來可能的發展方式。

中的資料行為 Experience Platform

打算用於以下專案的資料： Experience Platform 分為兩種行為型別：

記錄資料：提供主旨屬性的相關資訊。主旨可以是組織或個人。
時間序列資料：提供記錄主體直接或間接執行動作時的系統快照。

所有XDM結構描述都說明可歸類為記錄或時間序列的資料。結構描述的資料行為由結構描述的類別定義，該類別在首次建立時指派給結構描述。本檔案稍後將詳細說明XDM類別。

記錄和時間序列結構描述都包含身分地圖(xdm:identityMap)。此欄位包含主旨的身分表示，從標示為「身分」的欄位中擷取，如下節所述。

身分

結構用於擷取資料到 Experience Platform. 此資料可用於多項服務，以建立個別實體的單一、統一檢視。因此，在考慮結構時，請務必考量客戶身分以及哪些欄位可用來識別主旨，無論資料來自何處。

為了協助進行此程式，結構描述中的關鍵欄位可以標示為身分。資料擷取後，這些欄位中的資料會插入"身分圖表」代表該個人。之後，即可透過以下方式存取圖表資料： Real-Time Customer Profile 和其他 Experience Platform 服務，提供每個個別客戶的彙整檢視表。

通常標示為"的欄位身分"包含：電子郵件地址、電話號碼、 Experience Cloud ID (ECID)、CRM ID或其他唯一ID欄位。您也應考量貴組織特有的任何唯一識別碼，因為這些識別碼可能很好」身分」欄位。

在結構描述規劃階段請務必考量客戶身分，以協助確保資料彙集在一起，以儘可能建置最強大的設定檔。請參閱以下主題的概觀： Adobe Experience Platform Identity服務以進一步瞭解身分資訊如何協助您為客戶提供數位體驗。

有兩種方式可將身分資料傳送至Platform：

透過結構描述編輯器UI 或使用結構描述登入API
使用 identityMap 欄位

`identityMap`

identityMap 是一個對應型別欄位，說明個人的各種身分值及其關聯的名稱空間。此欄位可用於提供結構描述的身分資訊，而非在結構描述本身的結構中定義身分值。

使用的主要缺點 identityMap 身分會嵌入資料中，因此而變得不那麼可見。如果您要擷取原始資料，則應在實際結構描述結構中定義個別身分欄位。

注意

使用的結構描述 identityMap 可作為關聯性中的來源結構描述，但不能用作參考結構描述。這是因為所有參考結構描述都必須具備可見的身分識別，且可以在來源結構描述內的參考欄位中進行對應。請參閱以下的UI指南：關係以取得來源和參考結構描述需求的詳細資訊。

不過，如果您從同時儲存身分的來源引進資料(例如 Airship 或Adobe Audience Manager)，或當結構描述有變數身分時。此外，如果您使用 Adobe Experience Platform Mobile SDK.

簡單身分對應的範例看起來像這樣：

"identityMap": {
  "email": [
    {
      "id": "jsmith@example.com",
      "primary": true
    }
  ],
  "ECID": [
    {
      "id": "87098882279810196101440938110216748923",
      "primary": false
    },
    {
      "id": "55019962992006103186215643814973128178",
      "primary": false
    }
  ],
  "CRMID": [
    {
      "id": "2e33192000007456-0365c00000000000",
      "primary": false
    }
  ]
}

如上述範例所示，在 identityMap 物件代表身分名稱空間。每個索引鍵的值都是一個物件陣列，代表身分值(id)時，不會隱藏任何專案。請參閱 Identity Service 的檔案標準身分名稱空間清單可由Adobe應用程式辨識。

注意

表示該值是否為主要身分的布林值(primary)也可針對每個身分值提供。主要身分只需要設定為要用於中的結構描述 Real-Time Customer Profile. 請參閱以下小節：聯合結構描述以取得詳細資訊。

結構描述演化原則

由於數位體驗的性質持續演化，因此用來代表體驗的結構描述也必須持續演化。因此，設計良好的結構描述能夠視需要調整和演變，而不會對結構描述的先前版本造成破壞性變更。

由於維持回溯相容性對架構演化至關重要， Experience Platform 強制使用純粹加法版本化原則。此原則可確保對結構描述的任何修訂只會產生非破壞性的更新和變更。換句話說， 不支援重大變更。

注意

如果結構描述尚未用來將資料擷取到 Experience Platform 而且尚未啟用以用於即時客戶個人檔案，因此您可能會對該結構描述進行重大變更。不過，一旦結構已被用於 Platform，則須遵守加法版本設定原則。

下表劃分在編輯方案、欄位群組和資料型別時支援的變更：

支援的變更	重大變更（不支援）
將新欄位新增至資源將必填欄位設為選用引入新的必填欄位* 變更資源的顯示名稱和說明啟用結構描述以參與設定檔	移除先前定義的欄位重新命名或重新定義現有欄位移除或限制先前支援的欄位值將現有欄位移至樹狀結構中的其他位置刪除結構描述停用參與設定檔的結構描述

*請參閱以下章節，以瞭解有關以下各項的重要考量設定新的必填欄位.

必填欄位

個別結構欄位可以是標示為必要，這表示任何內嵌的記錄都必須包含這些欄位中的資料，才能通過驗證。例如，視需要設定結構描述的主要身分欄位有助於確保所有擷取的記錄都將參與即時客戶個人檔案，而視需要設定時間戳記欄位則可確保所有時間序列事件按時間順序保留。

重要

無論結構欄位是否為必填欄位，平台不接受 null 或任何內嵌欄位的空白值。如果記錄或事件中沒有特定欄位的值，則應該從擷取裝載中排除該欄位的索引鍵。

在內嵌後視需要設定欄位

如果欄位曾用於擷取資料，且最初未設定為必要，則該欄位對於某些記錄可能會有null值。如果您將此欄位設為必要的擷取後，即使歷史記錄可能為Null，所有未來記錄都必須包含此欄位的值。

將先前可選欄位設為必要欄位時，請記住下列事項：

如果您查詢歷史資料並將結果寫入新資料集，某些列會失敗，因為它們包含必要欄位的null值。
如果欄位參與即時客戶個人檔案而且在視需要設定資料之前，請先匯出資料，某些設定檔可能會為空值。
您可以使用Schema Registry API來檢視Platform中所有XDM資源的時間戳記變更記錄，包括新的必要欄位。請參閱稽核記錄端點以取得詳細資訊。

結構描述和資料擷取

為了將資料擷取到 Experience Platform，必須先建立資料集。資料集是資料轉換和追蹤的建置組塊 Catalog Service，通常代表包含已擷取資料的表格或檔案。所有資料集都以現有的XDM結構描述為基礎，這些結構描述會針對所擷取的資料應該包含的內容以及應該如何建構提供限制。請參閱以下主題的概觀： Adobe Experience Platform資料擷取以取得詳細資訊。

結構描述的建置區塊

Experience Platform 使用組合方法，其中結合標準建置區塊以建立方案。此方法可促進現有元件的重複使用性，並推動整個產業的標準化，以支援中的廠商方案和元件 Platform.

使用下列公式來構成結構描述：

類別+結構描述欄位群組&ast； = XDM結構描述

&ast；結構描述是由類別和零個或多個結構描述欄位群組所組成。這表示您完全可以使用欄位群組來撰寫資料集結構。

類別

構成結構描述從指派類別開始。類別會定義結構描述將包含之資料（記錄或時間序列）的行為方面。除此之外，類別會說明基於該類別的所有結構描述所需包含的最小通用屬性數量，並提供合併多個相容資料集的方法。

結構描述的類別會決定哪些欄位群組適合在該結構描述中使用。有關詳細討論，請參見下一節.

Adobe提供幾個標準（「核心」） XDM類別。其中兩個類別， XDM Individual Profile 和 XDM ExperienceEvent幾乎所有下游平台程式都需要。除了這些核心類別以外，您也可以建立自己的自訂類別，以說明貴組織更具體的使用案例。當沒有Adobe定義的核心類別可用於描述獨特的使用案例時，自訂類別由組織定義。

下列熒幕擷圖示範類別在Platform UI中的呈現方式。由於顯示的範例結構描述不包含任何欄位群組，因此所有顯示的欄位都由結構描述的類別(XDM個別設定檔)。

有關可用標準XDM類別的最新清單，請參閱官方XDM存放庫. 或者，您也可以參閱以下指南：探索XDM元件如果您偏好在UI中檢視資源。

欄位群組

欄位群組是可重複使用的元件，可定義一或多個實作特定功能的欄位，例如個人詳細資料、飯店偏好設定或地址。欄位群組是要包含在實作相容類別的結構描述中。

欄位群組會根據其代表的資料行為（記錄或時間序列），定義其相容的類別。這表示並非所有欄位群組都可用於所有類別。

Experience Platform 包含許多標準Adobe欄位群組，同時也允許廠商為其使用者定義欄位群組，以及允許個別使用者為自己的特定概念定義欄位群組。

例如，若要擷取詳細資訊，例如"名字「和」住家地址適用於您的「」熟客方案會員」綱要，您將能夠使用定義這些常見概念的標準欄位群組。不過，標準欄位群組可能未涵蓋的組織專用概念（例如自訂忠誠度方案詳細資訊或產品屬性）。在這種情況下，您必須定義自己的欄位群組來擷取此資訊。

注意

強烈建議您在結構描述中儘可能使用標準欄位群組，因為這些欄位可透過以下方式隱含瞭解 Experience Platform 服務並提供更一致的使用方式 Platform 元件。

標準元件（例如「名字」和「電子郵件地址」）提供的欄位包含基本純量欄位型別以外的新增內涵，告訴 Platform 任何共用相同資料型別的欄位都將以相同的方式運作。無論資料來自何處，或是來自何處，這種行為都可以信賴為一致 Platform 資料正在使用的服務。

請記住，結構描述是由「零個或多個」欄位群組組成，因此這表示您可以撰寫有效的結構描述而不需使用任何欄位群組。

下列熒幕擷圖示範欄位群組在Platform UI中的呈現方式。單一欄位群組(人口統計細節)新增至此範例中的結構描述，提供結構描述結構的一組欄位。

如需可用標準XDM欄位群組的最新清單，請參閱官方XDM存放庫. 或者，您也可以參閱以下指南：探索XDM元件如果您偏好在UI中檢視資源。

資料類型

資料型別在類別或結構描述中作為參考欄位型別使用，其使用方式與基本常值欄位相同。主要差異在於資料型別可以定義多個子欄位。它們可以與欄位群組相同的方式定義多個子欄位，但主要區別在於資料型別可以包含在結構描述中的任意位置，方法是將其新增為欄位的「資料型別」。雖然欄位群組僅與某些類別相容，但資料型別可包含在任何父類別或欄位群組中。

Experience Platform 提供許多常見資料型別，屬於 Schema Registry 支援使用標準模式來說明通用資料結構。有關詳細解釋，請參閱 Schema Registry 教學課程，當您逐步完成定義資料型別的步驟時，教學課程會變得更清晰。

下列熒幕擷圖示範資料型別在Platform UI中的呈現方式。提供的其中一個欄位人口統計細節欄位群組使用"物件"資料型別，如垂直號字元(|)的欄位名稱。此特定資料型別提供與個人名稱相關的幾個子欄位，此建構可重複用於需要擷取個人名稱的其他欄位。

如需可用標準XDM資料型別的最新清單，請參閱官方XDM存放庫. 或者，您也可以參閱以下指南：探索XDM元件如果您偏好在UI中檢視資源。

欄位

欄位是結構描述中最基本的建置區塊。欄位透過定義特定資料型別，提供其可包含之資料型別的相關限制。這些基本資料型別會定義單一欄位，而資料型別前述可讓您定義多個子欄位，並在各種結構描述中重複使用相同的多欄位結構。因此，除了將欄位的「資料型別」定義為登入中定義的其中一種資料型別外， Experience Platform 支援基本純量型別，例如：

字串
整數
雙倍
布林值
陣列
物件

秘訣

請參閱附錄有關在物件型別欄位上使用自由格式欄位的優缺點資訊。

這些純量型別的有效範圍可以進一步限製為特定圖樣、格式、最小值/最大值或預先定義的值。使用這些限制，可以表示各種更具體的欄位型別，包括：

列舉
長
短
位元組
日期
日期時間
地圖

注意

「對應」欄位型別允許索引鍵值配對資料，包括單一索引鍵的多個值。可以在標準XDM類別和欄位群組中找到對應，但您也可以使用結構描述登入API定義自訂對應。請參閱上的教學課程定義自訂欄位以取得詳細資訊。

組合範例

結構描述會呈現要擷取到的資料格式和結構 Platform、和，都是使用組合模型建置的。如前所述，這些結構描述由一個類別和零個或多個與該類別相容的欄位群組組成。

例如，說明在零售商店購買的結構描述可能稱為"儲存交易「。此結構描述會實作 XDM ExperienceEvent 與標準結合的類別商務欄位群組和使用者定義產品資訊欄位群組。

追蹤網站流量的另一個結構描述可能稱為"網站造訪「。也會實作 XDM ExperienceEvent 類別，但這次結合了 Web 欄位群組。

下圖顯示這些結構以及每個欄位群組貢獻的欄位。此範本也包含兩個結構描述，分別基於 XDM Individual Profile 類別，包括"熟客方案會員「本指南先前提到的結構描述。

Union

當 Experience Platform 可讓您針對特定使用案例來撰寫方案，也可讓您檢視特定類別型別的方案「聯合」。上圖顯示兩個根據XDM ExperienceEvent類別的結構描述，以及兩個根據的結構描述 XDM Individual Profile 類別。聯合（如下所示）會彙總共用相同類別的所有結構描述的欄位(XDM ExperienceEvent 和 XDM Individual Profile（分別是）。

透過啟用結構描述以用於 Real-Time Customer Profile，則會包含在該類別型別的聯合中。 Profile 提供客戶屬性的強大集中設定檔，以及客戶在任何整合系統內所發生事件的時間戳記帳戶 Platform. Profile 使用聯合檢視來表示此資料，並提供每個個別客戶的整體檢視。

有關使用的詳細資訊 Profile，請參閱即時客戶個人檔案總覽.

將資料檔對應至XDM結構描述

擷取到的所有資料檔 Experience Platform 必須符合XDM結構描述的結構。如需如何格式化資料檔以符合XDM階層的詳細資訊（包括範例檔案），請參閱以下檔案：範例ETL轉換. 如需擷取資料檔的一般資訊 Experience Platform，請參閱批次擷取概觀.

外部對象的結構

如果您要將受眾從外部系統引進Platform，您必須使用以下元件在您的結構中擷取它們：

區段定義類別：此標準類別用於擷取外部區段定義的索引鍵屬性。
區塊會籍細節欄位群組：將此欄位群組新增至您的 XDM個別設定檔結構描述，以便將客戶設定檔與特定對象建立關聯。

後續步驟

現在您已瞭解結構描述構成的基本知識，您已準備好開始使用探索和建置結構描述 Schema Registry.

若要檢閱兩個核心XDM類別的結構及其常用的相容欄位群組，請參閱下列參考檔案：

此 Schema Registry 用於存取 Schema Library Adobe Experience Platform ，並提供使用者介面和RESTful API，可供您存取所有可用的程式庫資源。此 Schema Library 包含由Adobe定義的產業資源，由定義的廠商資源 Experience Platform 合作夥伴、類別、欄位群組、資料型別，以及組織成員組成的結構描述。

若要開始使用UI構成方案，請遵循以下說明：結構描述編輯器教學課程以建置本檔案中提及的「忠誠會員」方案。

若要開始使用 Schema Registry API，從讀取 Schema Registry API開發人員指南. 閱讀開發人員指南後，請遵循以下教學課程中概述的步驟使用結構描述登入API建立結構描述.

附錄

以下小節包含有關結構描述組合原則的其他資訊。

關聯式表格與內嵌物件

使用關聯式資料庫時，最佳實務包括標準化資料，或是將實體分割為多個分散的片段，然後顯示在多個表格中。若要整體讀取資料或更新實體，必須使用JOIN對許多個別表格進行讀取和寫入作業。

透過使用內嵌物件，XDM結構描述可以直接表示複雜的資料，並將其儲存在具有階層結構的獨立檔案中。此結構的主要優點之一，是它可讓您查詢資料，而不需透過昂貴的連線來重新建構實體，以連線多個非正規化表格。對於您的結構描述階層可以包含多少層級，沒有嚴格限制。

結構描述和巨量資料

現代數位系統會產生大量行為訊號（交易資料、網站記錄檔、物聯網、顯示等）。這種巨量資料提供絕佳機會來最佳化體驗，但由於資料的規模和多樣性而難以使用。為了從資料中獲得價值，其結構、格式和定義必須標準化，以便能一致且有效地處理。

結構描述可解決此問題，其方式是允許從多個來源整合資料、透過通用結構和定義進行標準化，並在解決方案之間共用。這可讓後續程式和服務回答針對資料提出的任何型別的問題，擺脫傳統資料模型化的方法，即將針對資料提出的所有問題都事先已知，且資料模型化以符合這些期望。

物件與自由表單欄位

在設計結構時，透過自由格式欄位選擇物件時要考慮一些關鍵因素：

物件	自由格式欄位
增加巢狀	較少或沒有巢狀
建立邏輯欄位群組	欄位會放置在臨機位置

物件

以下列出在自由格式欄位上使用物件的優缺點。

優點:

當您想要建立特定欄位的邏輯群組時，最好使用物件。
物件會以更具結構化的方式組織結構描述。
物件間接有助於在區段產生器UI中建立良好的功能表結構。結構描述中的分組欄位會直接反映在區段產生器UI中提供的資料夾結構中。

缺點:

欄位會變得更巢狀。
使用時 Adobe Experience Platform查詢服務，則必須提供較長的參考字串來查詢巢狀內嵌在物件中的欄位。

自由格式欄位

以下列出在物件上使用自由格式欄位的優點和缺點。

優點:

自由格式的欄位會直接在結構描述的根物件下建立(_tenantId)，增加可見度。
使用查詢服務時，自由格式欄位的參考字串往往較短。

缺點:

結構描述中自由格式欄位的位置是臨機操作的，這表示它們會依字母順序出現在結構描述編輯器中。這會使結構描述較少結構化，而類似的自由格式欄位可能會根據其名稱出現大幅分隔。