使用建立架構 Schema Editor
Adobe Experience Platform使用者介面可讓您建立和管理 Experience Data Model (XDM)結構描述在稱為 Schema Editor. 本教學課程涵蓋如何使用 Schema Editor.
為了示範,本教學課程中的步驟涉及建立範例結構描述,以說明客戶忠誠度計畫的成員。 雖然您可以利用這些步驟建立不同的結構描述以供您個人使用,但建議您先依照建立範例結構描述一起來瞭解 Schema Editor.
快速入門
此教學課程需要您實際瞭解架構建立中Adobe Experience Platform的各個層面。 在開始本教學課程之前,請檢閱檔案以瞭解下列概念:
- Experience Data Model (XDM):作為依據的標準化架構 Platform 組織客戶體驗資料。
- 結構描述組合基本概念:XDM結構描述及其建置區塊的概觀,包括類別、結構描述欄位群組、資料型別和個別欄位。
- Real-Time Customer Profile:根據來自多個來源的彙總資料,提供統一的即時消費者個人檔案。
開啟 方案 工作區 browse
此 方案 中的工作區 Platform UI可提供 Schema Library,可讓您檢視管理組織可用的結構描述。 工作區也包含 Schema Editor,即可在整個教學課程中撰寫結構描述的畫布。
登入後 Experience Platform,選取 方案 在左側導覽以開啟 方案 工作區。 此 瀏覽 標籤顯示方案清單(此清單的 Schema Library),供您檢視及自訂。 此清單包括結構描述所根據的名稱、型別、類別和行為(記錄或時間序列),以及上次修改結構描述的日期和時間。
請參閱以下指南: 在UI中探索現有的XDM資源 以取得詳細資訊。
建立方案並為其命名 create
若要開始構成方案,請選取 建立結構描述 位於的右上角 方案 工作區。
此 建立結構描述 工作流程隨即顯示。 接著,選擇結構描述的基底類別。 您可以在下列核心類別之間選擇 XDM個別設定檔 和 XDM ExperienceEvent,或 其他 如果這些類別不適合您的用途。 此 其他 類別選項可讓您 建立新類別 或從其他預先存在的類別中選擇。
請參閱 XDM個別設定檔 和 XDM ExperienceEvent 檔案,以取得這些類別的詳細資訊。 在本教學課程中,請選取 XDM個別設定檔 後面接著 下一個.
選取類別後, 名稱和評論 區段隨即顯示。 您可以在此段落中提供名稱和說明,以識別您的結構描述。 決定結構描述的名稱時,有幾個重要考量事項需要考慮:
- 結構描述名稱應簡短且具有描述性,以便之後可以輕鬆找到結構描述。
- 結構描述名稱必須是唯一的,這表示它也應該是足夠具體的,以使其在將來不會重複使用。 例如,如果貴組織針對不同品牌有不同的忠誠度計畫,則明智的做法是命名您的方案為「品牌A忠誠度會員」,以便輕鬆區別於您稍後可能定義的其他忠誠度相關方案。
- 您也可以使用結構描述來提供關於結構描述的任何其他內容相關資訊。
本教學課程撰寫結構描述以擷取與忠誠計畫成員相關的資料,因此該結構描述命名為「Loyalty Members「。
結構描述的基本結構(由類別提供)會顯示在畫布中,供您檢閱及驗證選取的類別和結構描述結構。
輸入人性化的 結構描述顯示名稱 在文字欄位中。 接下來,輸入適當的說明來協助識別您的結構描述。 當您檢閱了結構描述結構並對設定感到滿意時,請選取「 」 完成 以建立架構。
此 Schema Editor 隨即顯示。 這是您將在其中撰寫結構描述的畫布。 系統會自動在「 」中建立自標頭綱要 結構 出現在編輯器時畫布的區段,以及您在所選基底類別中包含的標準欄位。 結構描述的指派類別也會列在 類別 在 組合 區段。
新增欄位群組 field-group
您現在可以透過新增欄位群組來開始將欄位新增到結構描述。 欄位群組是一或多個欄位的群組,通常搭配使用來描述特定概念。 本教學課程使用欄位群組來說明熟客方案的成員,並擷取關鍵資訊,例如,姓名、生日、電話號碼、地址等。
若要新增欄位群組,請選取 新增 在 欄位群組 子區段。
新的對話方塊隨即出現,顯示可用欄位群組的清單。 每個欄位群組僅供特定類別使用,因此對話方塊僅列出與您選取的類別相容的欄位群組(在此例中, XDM Individual Profile 類別)。 如果您使用標準XDM類別,欄位群組清單將會根據使用人氣聰明地排序。
您可以選取左側邊欄中的其中一個篩選器,將標準欄位群組清單縮小至特定 產業 如零售、金融服務及醫療保健。
從清單中選取欄位群組後,該群組就會顯示在右側邊欄中。 您可以視需要選取多個欄位群組,在確認前將每個欄位群組新增到右側欄的清單中。 此外,圖示會顯示在目前所選欄位群組的右側,可讓您預覽其所提供的欄位結構。
預覽欄位群組時,右側邊欄會提供欄位群組的結構描述詳細資訊。 您還可以瀏覽提供的畫布中的欄位群組欄位。 當您選取不同欄位時,右側欄會更新,顯示有關問題欄位的詳細資訊。 選取 返回 完成預覽以返回欄位群組選取對話方塊時。
在本教學課程中,選取 人口統計細節 欄位群組,然後選取 新增欄位群組.
結構畫布會重新出現。 此 欄位群組 區段現在列出"人口統計細節」和 結構 區段包含欄位群組貢獻的欄位。 您可以在欄位群組名稱底下選取 欄位群組 區段來反白顯示它在畫布中提供的特定欄位。
此欄位群組在頂層名稱下提供了數個欄位 person
資料型別為"個人「。 這組欄位說明個人的相關資訊,包括姓名、出生日期和性別。
請注意 name
欄位的資料型別為"完整名稱「」,表示也說明一般概念並包含與名稱相關的子欄位,例如名字、姓氏、尊稱和尾碼。
選取畫布中的不同欄位,以顯示這些欄位對結構描述結構貢獻的任何其他欄位。
新增更多欄位群組 field-group-2
您現在可以重複相同的步驟來新增另一個欄位群組。 當您檢視 新增欄位群組 這次對話方塊中,請注意「人口統計細節「欄位群組已灰顯,且無法選取其旁邊的核取方塊。 這可防止您不小心複製已包含在目前結構描述中的欄位群組。
在本教學課程中,請選取標準欄位群組 個人聯絡詳細資訊 和 熟客方案細節 從清單中,然後選取 新增欄位群組 以將它們新增至結構描述。
畫布會重新出現,並在下方列出新增的欄位群組 欄位群組 在 組合 以及新增至結構描述結構的複合欄位。
定義自訂欄位群組 define-field-group
此 熟客方案會員 綱要用於擷取和熟客方案會員相關的資料,以及標準 熟客方案細節 您新增到結構描述的欄位群組提供大部分這類內容,包括方案型別、點、加入日期等。
但是,在某些情況下,您可能會想要包含標準欄位群組未涵蓋的其他自訂欄位,以便實現您的使用案例。 如果新增自訂忠誠度欄位,您有兩個選項:
- 建立新的自訂欄位群組以擷取這些欄位。 本教學課程將涵蓋此方法。
- 擴充標準 熟客方案細節 包含自訂欄位的欄位群組。 這導致 熟客方案細節 轉換為自訂欄位群組,且原始標準欄位群組將不再可用。 請參閱 方案 UI指南,瞭解更多關於 將自訂欄位新增至標準欄位群組的結構.
若要建立新的欄位群組,請選取 新增 在 欄位群組 子區段,跟以前一樣,但這次選取 建立新欄位群組 靠近出現的對話方塊頂端。 接著,系統會要求您提供新欄位群組的顯示名稱和說明。 在本教學課程中,將新的欄位群組命名為"Custom Loyalty Details",然後選取 新增欄位群組.
"Custom Loyalty Details「 」現在應顯示在下方 欄位群組 位於畫布左側,但是還沒有任何欄位與其相關聯,因此下方不會出現任何新欄位 結構.
新增欄位至欄位群組 field-group-fields
現在您已建立「Custom Loyalty Details「欄位群組」,現在該定義欄位群組將貢獻給結構描述的欄位了。
若要開始,請選取 加(+) 圖示加以存取(位於畫布中的結構描述名稱旁)。
一個"未命名的欄位「預留位置會顯示在畫布中,而右邊欄會更新以顯示欄位的設定選項。
在此案例中,結構描述需要物件型別欄位,以詳細描述人員目前的熟客方案。 使用右側邊欄中的控制項,開始建立 loyaltyTier
型別為「」的欄位物件」中,用於儲存您的相關欄位。
在 指派給,您必須選取要指派欄位的欄位群組。 請記住,所有結構描述欄位都屬於類別或欄位群組,由於此結構描述使用標準類別,因此您唯一的選項是選取欄位群組。 開始輸入名稱»Custom Loyalty Details「」,然後從清單中選取欄位群組。
完成後,選取 套用.
變更會套用且新建立的 loyaltyTier
物件隨即顯示。 由於這是自訂欄位,因此會自動巢狀內嵌在您組織租使用者ID名稱空間中的物件,前面再加上底線(_tenantId
在此範例中)。
選取 加(+) 圖示加以存取 loyaltyTier
物件,以開始新增子欄位。 新的欄位預留位置隨即出現, 欄位屬性 區域會顯示在畫布的右側。
每個欄位都需要下列資訊:
- 欄位名稱: 欄位名稱,最好以駝峰式大小寫撰寫。 不允許使用空格字元。 這是用來參照程式碼和其他下游應用程式中的欄位的名稱。
- 範例:loyaltyLevel
- 顯示名稱: 欄位名稱,以標題大小寫撰寫。 這是檢視或編輯結構描述時,畫布中顯示的名稱。
- 範例:忠誠度等級
- 型別: 欄位的資料型別。 這包括基本純量型別和 Schema Registry. 範例: 字串, 整數, 布林值, 個人, 地址, 電話號碼等
- 說明: 欄位的可選說明應包含最多200個字元。
的第一個欄位 loyaltyTier
物件會是一個字串,稱為 id
,代表忠誠會員目前層級的ID。 每個忠誠會員的層級ID將是唯一的,因為該公司會根據不同因素為每個客戶設定不同的忠誠度層級臨界值。 將新欄位的型別設為"字串「,以及 欄位屬性 區段會填入多個套用限制的選項,包括預設值、格式和最大長度。 請參閱以下檔案: 資料驗證欄位的最佳實務 以進一步瞭解。
從 id
會是隨機產生的自由字串,不需要進一步的限制。 選取 套用 以套用您的變更。
新增更多欄位至欄位群組 field-group-fields-2
現在您已新增 id
欄位,您可以新增其他欄位以擷取熟客層級資訊,例如:
- 目前點臨界值(整數):成員必須維護以保留在目前層級中的最小熟客點數。
- 下一個層級點臨界值(整數):成員要畢業到下一個層級必須累積的熟客點數。
- 生效日期(日期 — 時間):熟客會員加入此階層的日期。
若要將每個欄位新增至結構描述,請選取 加(+) 圖示加以存取 loyalty
物件,並填入必要的資訊。
完成後, loyaltyTier
物件將包含 id
, currentThreshold
, nextThreshold
、和 effectiveDate
.
新增列舉欄位至欄位群組 enum
在中定義欄位時 Schema Editor,您可以套用至基本欄位型別的其他選項,以便對欄位可包含的資料提供進一步限制。 下表說明這些限制的使用案例:
在本教學課程中, loyaltyTier
結構描述中的物件需要新的列舉欄位來說明層級類別,其中值只能是四個可能選項之一。 若要將此欄位新增至結構描述,請選取 加(+) 圖示旁邊 loyaltyTier
並填寫下列專案的必填欄位: 欄位名稱 和 顯示名稱. 的 型別,選取「字串「。
選擇欄位型別後,該欄位會出現其他核取方塊,包括的核取方塊 陣列, 列舉和建議值, 身分、和 關係.
選取 列舉和建議值 核取方塊,然後選取 列舉. 您可以在此處輸入 值 (在駝峰式大小寫中)和 顯示名稱 (標題大寫中為方便讀者的選用名稱),適用於每個可接受的忠誠度等級類別。
完成所有欄位屬性後,選取 套用 新增 tierClass
欄位至 loyaltyTier
物件。
將多欄位物件轉換為資料型別 datatype
此 loyaltyTier
物件現在包含數個欄位,並代表通用資料結構,可用於其他結構描述。 此 Schema Editor 可讓您將可重複使用的多欄位物件的結構轉換為資料型別,以輕鬆套用這些物件。
資料型別允許一致地使用多欄位結構,並且比欄位群組提供更大的彈性,因為它們可以在結構描述內的任何位置使用。 這是透過設定欄位的 型別 值為中定義之任何資料型別的值 Schema Registry.
若要轉換 loyaltyTier
物件變更為資料型別,請選取 loyaltyTier
欄位,然後選取 轉換為新資料型別 位於編輯器右側下方的 欄位屬性.
系統會顯示通知,確認物件已成功轉換。 在畫布中,您現在可以看到 loyaltyTier
欄位現在有連結圖示,而右側欄位則表示其資料型別為"Loyalty Tier「。
在未來的結構描述中,您現在可以將欄位指派為"Loyalty Tier" type且會自動包含ID、層類別、點臨界值及有效日期的欄位。
搜尋和篩選結構描述欄位
除了其基底類別提供的欄位外,您的結構描述現在包含多個欄位群組。 使用較大的結構描述時,您可以選取左側邊欄中欄位群組名稱旁邊的核取方塊,將顯示的欄位篩選為您感興趣的欄位群組所提供的欄位。
如果您在結構描述中尋找特定欄位,也可以使用搜尋列依名稱篩選顯示的欄位,無論這些欄位是在哪個欄位群組下提供。
將結構描述欄位設定為身分欄位 identity-field
結構提供的標準資料結構可用於識別跨多個來源屬於同一個人的資料,以允許各種下游使用案例,例如細分、報表、資料科學分析等。 若要根據個人身分拼接資料,索引鍵欄位必須標籤為 身分 個欄位。
Experience Platform 可讓您透過使用輕鬆表示身分欄位 身分 中的核取方塊 Schema Editor. 不過,您必須根據資料的性質,判斷哪個欄位最適合作為身分使用。
例如,可能有數千名忠誠計畫成員屬於相同的忠誠度等級,而數個成員可能共用相同的實體地址。 不過,在此案例中,註冊時,熟客方案的每位成員都會提供其個人電子郵件地址。 由於個人電子郵件地址通常由一人管理,因此欄位 personalEmail.address
(由 個人聯絡詳細資訊 欄位群組)是身分欄位的適合候選者。
identityMap
欄位以包含身分資訊。選取 personalEmail.address
欄位,以及 身分 核取方塊會顯示在 欄位屬性. 核取方塊和選項,將此項設為 主要身分 隨即顯示。 也請選取此方塊。
接下來,您必須提供 身分名稱空間 從下拉式清單中的預先定義名稱空間清單。 由於此欄位是客戶的電子郵件地址,請選取「電子郵件」從下拉式清單中選取。 選取 套用 以確認更新 personalEmail.address
欄位。
套用變更後, personalEmail.address
顯示指紋符號,表示它現在是身分欄位。 此欄位也會列於下的左側邊欄中 身分.
現在,所有資料已擷取至 personalEmail.address
欄位將用來協助識別該個人,並將該客戶的單一檢視拼接在一起。 若要進一步瞭解如何使用中的身分 Experience Platform,請檢閱 Identity Service 檔案。
啟用結構以用於 Real-Time Customer Profile profile
Real-Time Customer Profile 在中利用身分資料 Experience Platform 以提供每個個別客戶的整體檢視。 此服務為客戶屬性建立穩固的360度設定檔,並附有時間戳記的帳戶,說明客戶在與整合的任何系統中進行的每次互動 Experience Platform.
為了讓結構描述能夠搭配使用 Real-Time Customer Profile,必須定義主要身分。 如果您嘗試在未先定義主要身分的情況下啟用結構描述,將會收到錯誤訊息。
若要啟用「熟客會員」綱要以用於以下專案: Profile,從選取畫布中的結構描述標題開始。
在編輯器的右側,會顯示有關結構的資訊,包括其顯示名稱、說明和型別。 除了此資訊外, 個人資料 切換按鈕。
選取 個人資料 畫面會顯示彈出視窗,要求您確認要為其啟用綱要 Profile.
選取 啟用 以確認您的選擇。 您可以選取 個人資料 如果您希望停用綱要,但儲存綱要時,請再次切換以停用綱要 Profile 已啟用,無法再停用。
更多動作 more
在架構編輯器中,您還可以執行快速動作以複製架構的JSON結構或刪除架構。 選取 更多 在檢視頂端,顯示包含快速動作的下拉式清單。
刪除結構描述 delete-a-schema
可以使用在UI中從結構編輯器刪除結構描述 更多 動作,以及結構描述詳細資訊 瀏覽 標籤。 在某些情況下,無法刪除結構描述。 如果符合下列條件,則無法刪除結構描述:
- 此結構描述已針對設定檔啟用。
- 此結構描述已啟用設定檔功能,且具有關聯的資料集。
- 此結構描述有關聯的資料集,但未針對設定檔啟用。
複製 JSON 結構 copy-json-structure
選取 複製JSON結構 ,以為Schema Library中的任何結構描述產生匯出裝載。 此動作會將JSON結構複製到剪貼簿。 接著,您就可以使用匯出的JSON將結構描述及任何相關資源匯入不同的沙箱或組織。 如此一來,在不同環境之間共用和重複使用結構會變得簡單而有效。
後續步驟和其他資源
現在您已經完成撰寫結構描述,您可以在畫布中看到完整的結構描述。 選取 儲存 而且結構描述將會儲存到 Schema Library,可透過以下方式存取: Schema Registry.
您的新結構描述現在可用於將資料擷取到 Platform. 請記住,一旦使用結構描述來擷取資料後,只能進行加總變更。 請參閱 結構描述組合的基本面 以取得架構版本設定的詳細資訊。
您現在可以依照本教學課程的 在UI中定義結構描述關係 ,將新的關係欄位新增至「忠誠會員」結構描述。
您也可以使用來檢視和管理「忠誠會員」結構。 Schema Registry API。 若要開始使用API,請先閱讀 Schema Registry API 開發人員指南.
視訊資源
以下影片說明如何在中建立簡單的結構描述 Platform UI。
以下影片旨在讓您更瞭解如何使用欄位群組和類別。
附錄
以下小節提供有關使用的額外資訊 Schema Editor.
建立新類別 create-new-class
Experience Platform 可讓您根據組織獨有的類別靈活定義結構。 若要瞭解如何建立新類別,請參閱以下指南: 在UI中建立和編輯類別.
變更結構描述的類別 change-class
您可以在儲存結構描述之前,在初始構成程式期間隨時變更結構描述的類別。
若要瞭解如何變更綱要的類別,請參閱以下指南: 在UI中管理方案.