結構描述組合基本概念

本檔案將介紹 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 Service 以進一步瞭解身分資訊如何協助您為客戶傳遞數位體驗。

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

  1. 透過「 」將身分描述項新增至個別欄位 結構描述編輯器UI 或使用 結構描述登入API
  2. 使用 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。

將先前的選用欄位設定為必要欄位時,請記住以下事項:

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

結構描述和資料擷取

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

結構描述的建置區塊

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

使用下列公式來撰寫結構描述:

類別+結構描述欄位群組* = XDM結構描述

*結構描述由一個類別和零個或多個結構描述欄位群組組成。 這表示您可以撰寫資料集結構描述,完全不使用欄位群組。

類別

構成結構描述從指派類別開始。 類別會定義結構描述將包含之資料(記錄或時間序列)的行為方面。 除此之外,類別會說明所有根據該類別的結構描述都必須包含的最少數目的共同屬性,並提供方法來合併多個相容的資料集。

結構描述的類別決定哪些欄位群組符合在該結構描述中使用的資格。 有關詳細資訊,請參閱 下一節.

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,您必須使用以下元件來在結構描述中擷取它們:

後續步驟

現在您已瞭解方案構成的基本概念,您已準備好開始使用探索和建立方案 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中提供的資料夾結構中。

缺點:

自由格式欄位

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

優點:

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

缺點:

  • 自由格式欄位在結構描述中的位置是臨時的,這表示它們在結構描述編輯器中按字母順序顯示。 這可能會讓結構描述的結構性降低,而類似的自由格式欄位可能會因名稱而異。

本頁內容