1.2.2設定結構描述並設定識別碼
在本練習中,您將檢閱分類設定檔資訊和客戶行為所需的XDM結構描述的設定。 在每個XDM結構描述中,您也會看到主要識別碼已定義成將所有客戶相關資訊連結至。
Story
在開始設定XDM結構描述和定義識別碼之前,您必須先思考我們嘗試去做的事情的商業內容:
- 想要取得資料
- 您想要將資料連結至客戶
- 想要建立漸進式的即時客戶個人檔案
我們想要擷取兩種型別的資料:
- 此客戶是誰?
- 此客戶會怎麼做?
但是,問題 此客戶是誰? 是一個非常開放的問題,有許多答案。 當您的組織想要看到此問題的答案時,您會尋找人口統計資訊,例如名字、姓氏和地址。 但也適用於電子郵件地址或行動電話號碼等聯絡資訊。 此外也提供連結至語言、OptIn/OptOut甚至個人資料圖片的資訊。 最後,您真正需要瞭解的是,我們如何在貴組織使用的各種系統中識別此客戶。
問題 此客戶有何行為?。這是個很有答案的開放性問題。 當您的組織想要看到此問題的回答時,您會尋找客戶與您任何線上和離線屬性的任何互動。 造訪過哪些頁面或產品? 此客戶是否已新增產品至購物車,或甚至購買商品? 使用哪些裝置和瀏覽器來瀏覽網站? 這位客戶想要的是什麼資訊,以及我們如何運用這些資訊,為這位客戶設定並提供愉快的體驗? 最後,我們真正需要瞭解的是,我們如何在貴組織將使用的各種系統中識別此客戶。
此客戶是誰
擷取 此客戶是誰?您組織的 是透過登入/註冊頁面完成的。
從結構描述的角度來看,我們將其視為 類別。 問題:此客戶是誰? 是我們在 XDM個別設定檔 類別中定義的專案。
因此,當您建立XDM結構描述以擷取 此客戶是誰?,首先,您需要建立和定義1個參照類別 XDM個別設定檔 的結構描述。
若要指定該問題可有何種答案,您必須定義欄位群組。 欄位群組是Profile類別的延伸模組,而且有非常明確的設定。 例如,名字、姓氏、性別和生日等人口統計資訊是欄位群組的一部分: 人口統計詳細資料。
其次,您的組織需要決定如何識別此客戶。 以您的組織為例,已知客戶的主要識別碼可能是特定客戶ID,例如電子郵件地址。 但技術上來說,還有其他方法可以識別組織中的客戶,例如使用行動電話號碼。
在本實驗中,我們將電子郵件地址定義為主要識別碼,而電話號碼定義為次要識別碼。
最後,區分資料擷取的管道很重要。 在此案例中,我們將討論「網站註冊」,以及需要定義的結構描述必須反映 其中 已擷取註冊資料。 管道在影響所擷取的資料方面也將發揮重要作用。 因此,最佳實務是為每個管道、主要識別碼和收集之資料型別的組合定義結構描述。
根據上文,已在Adobe Experience Platform中建立結構描述。
前往此URL登入Adobe Experience Platform: https://experience.adobe.com/platform。
登入後,您會登入Adobe Experience Platform的首頁。
繼續之前,您必須選取 沙箱。 要選取的沙箱名為--aepSandboxName--
。 選取適當的沙箱後,您會看到畫面變更,現在您已進入專屬沙箱。
在Adobe Experience Platform中,按一下熒幕左邊功能表中的 結構描述。 您會看到可用的結構描述清單。 您應該建立新的結構描述。 若要建立新結構描述,請按一下[建立結構描述]。+。
選取「手動」,然後按一下「選取」。
接著,選取 個別設定檔 並按一下 下一步。
輸入結構描述的名稱,如下所示: --aepUserLdap-- - Demo System - Profile Schema for Website
。 按一下 完成。
現在已建立新結構描述。
現在您需要定義問題 此客戶是誰?的答案 看起來應該像這樣。
在本實驗的簡介中,我們注意到需要下列屬性來定義客戶:
- 名字、姓氏和地址等人口統計資訊
- 連絡資訊,例如住家地址、電子郵件地址或行動電話號碼
- 連結到語言、選擇加入/選擇退出甚至個人資料圖片的其他資訊。
- 客戶的主要識別碼
若要將該資訊加入結構描述的一部分,您必須將下列欄位群組新增到結構描述:
- 人口統計細節(人口統計資訊)
- 個人聯絡詳細資訊(聯絡資訊)
- 同意和偏好設定詳細資料(其他資訊)
- 您組織的自訂設定檔識別欄位群組(主要和次要識別碼)
按一下 欄位群組 下的 +新增 按鈕。
在 新增欄位群組 畫面中,選取欄位群組 人口統計詳細資料、個人聯絡詳細資料 以及 同意和偏好設定詳細資料。
按一下 新增欄位群組 按鈕,將欄位群組新增到您的結構描述。
您現在擁有此功能:
接下來,您需要新的欄位群組來擷取用於資料收集的 識別碼。 如同在上一個練習中所見,有一個識別碼的概念。 主要識別碼是最重要的識別碼,因為所有收集的資料都會連結至此識別碼。
您現在將建立自己的自訂欄位群組,因此,您將擴充XDM結構描述以符合您自己組織的需求。
按一下 欄位群組 下的 +新增 以開始新增欄位群組。
您現在將建立自己的欄位群組,而不是重複使用現有的欄位群組。 您可以選取 建立新欄位群組 來執行此操作。
您現在必須為新的欄位群組提供 顯示名稱 和 描述。
當作結構描述的名稱,我們將使用這個名稱:--aepUserLdap-- - Profile Identification Field Group
按一下 新增欄位群組 按鈕,將新建立的欄位群組新增到您的結構描述。
您現在已具備此結構描述結構。
您的新欄位群組仍然是空的,所以現在您必須將欄位新增到該欄位群組。
在欄位群組 — 清單中,按一下您的自訂欄位群組。
您現在會看到許多新按鈕。
在結構描述的最上層,按一下 +新增欄位 按鈕。
按一下 +新增欄位 按鈕後,您現在會在結構描述中看到新的無標題欄位。
您現在應該使用這些物件定義來輸入這個新欄位的資訊:
- 欄位名稱:
--aepUserLdap--_identification
- 顯示名稱:
--aepUserLdap--_identification
- 類型:物件
- 欄位群組:
--aepUserLdap-- - Profile Identification Field Group
按一下 套用。
您現在會在結構描述中看到新物件,代表結構描述中的自訂 物件,並以您的Adobe Experience Platform租使用者ID命名。 您的Adobe Experience Platform租使用者ID是--aepTenantId--
,並且在每個AEP執行個體中都是唯一的。
您現在會在您剛建立的 識別 物件中,在該租使用者底下新增3個欄位物件。 若要開始新增這3個欄位中的每一個欄位,請按一下每個欄位的 識別 下的 +圖示。
使用以下資訊在 識別碼 物件下建立這3個新欄位:
-
ecid:
- 欄位名稱:
--aepUserLdap--_ecid
- 顯示名稱:
--aepUserLdap--ecid
- 型別: 字串
- 欄位群組:
--aepUserLdap-- - Profile Identification Field Group
- 欄位名稱:
-
emailId
- 欄位名稱:
--aepUserLdap--_emailId
- 顯示名稱:
--aepUserLdap--_emailId
- 型別: 字串
- 欄位群組:
--aepUserLdap-- - Profile Identification Field Group
- 欄位名稱:
-
mobilenr
- 欄位名稱:
--aepUserLdap--_mobilenr
- 顯示名稱:
--aepUserLdap--_mobilenr
- 型別: 字串
- 欄位群組:
--aepUserLdap-- - Profile Identification Field Group
- 欄位名稱:
這是每個欄位在初始欄位設定之後的顯示方式。
--aepUserLdap--_mobilenr
若要儲存欄位,請向下捲動 欄位屬性,直到看到 套用 按鈕為止。 按一下 套用 按鈕。
--aepUserLdap--_ecid
別忘了向下捲動並按一下 套用。
--aepUserLdap--_emailId
別忘了向下捲動並按一下 套用。
每個欄位都定義為型別 字串,您現在會將這些欄位設定為 身分。 針對此結構描述,我們假設客戶將一律由其電子郵件地址識別,這表示您必須將欄位 emailId 設定為 主要 識別碼,並將其他欄位設定為一般識別碼。
您的3個欄位現在必須定義為 身分識別 欄位。
若要開始將這些欄位定義為 身分 — 欄位,請遵循下列步驟:
- 選取欄位
--aepUserLdap--_emailId
。 - 在右側的欄位屬性中,向下捲動直到您看到 身分 為止。 核取 身分 的核取方塊。
- 現在核取 主要身分 的核取方塊。
- 最後,從 名稱空間 清單中選取名稱空間 電子郵件。 Adobe Experience Platform中的身分圖表會使用名稱空間來分類名稱空間中的識別碼,並定義這些名稱空間之間的關係。 按一下 套用 以儲存變更。
接下來,您必須將 --aepUserLdap--_ecid
和 --aepUserLdap--_mobilenr
的其他欄位定義為標準識別碼。
選取欄位 --aepUserLdap--_ecid
。 在右側的欄位屬性中,向下捲動直到您看到 身分 為止。 核取 身分 的核取方塊。
接著,從 名稱空間 清單中選取名稱空間 ECID。
按一下 套用 以儲存變更。
選取欄位 --aepUserLdap--_mobilenr
。 在右側的欄位屬性中,向下捲動直到您看到 身分 為止。 核取 身分 的核取方塊。
從 名稱空間 清單中選取名稱空間 電話。
按一下 套用 以儲存變更。
識別碼 物件現在看起來應該像這樣,3個ID欄位現在也顯示 指紋 圖示,以顯示它們已定義為識別碼。
按一下[儲存]儲存變更。
這裡要做的最後一件事,是啟動要連結至 設定檔 的結構描述。
為設定檔啟用結構描述後,您將確保針對此結構描述傳送至Adobe Experience Platform的所有資料都會成為即時客戶設定檔環境的一部分,以確保所有資料都可用於即時查詢、細分和啟用。
若要這麼做,請選取結構描述的名稱。
在結構描述的右側標籤中,按一下 設定檔切換,目前該切換已停用。
按一下設定檔 — 切換器以啟動。
按一下 啟用 為設定檔啟用此結構描述。
您的結構描述現在已設定為即時客戶設定檔的一部分。 按一下[儲存]儲存結構描述。
此客戶會怎麼做?
擷取問題 此客戶有何行為?您組織的 已透過在產品頁面上執行個體的產品檢視完成。
從結構描述的角度來看,我們將其視為 類別。 問題:此客戶做什麼? 是我們已在類別 ExperienceEvent 中定義的專案。
因此,當您建立XDM結構描述以擷取 的答案時,此客戶會怎麼做?,首先,您需要建立和定義1個參照類別 ExperienceEvent 的結構描述。
若要指定該問題可有何種答案,您必須定義欄位群組。 欄位群組是ExperienceEvent類別的延伸模組,而且有非常明確的設定。 例如,有關客戶檢視或新增至購物車的產品型別屬於欄位群組 Commerce詳細資料 的資訊。
第二,您的組織需要決定您將如何識別此客戶的行為。 由於我們討論的是網站上的互動,因此您的組織可能瞭解客戶,但也可能有未知的匿名訪客活躍在網站上。 因此,我們無法使用像電子郵件地址之類的識別碼。 在此情況下,您的組織可能會決定使用Experience Cloud ID (ECID)作為主要識別碼。
最後,區分資料擷取的管道很重要。 在此案例中,我們將討論網站互動以及需要定義的結構描述,以反映 其中 擷取的互動資料。 管道在影響所擷取的資料方面也將發揮重要作用。 因此,最佳實務是為每個管道、主要識別碼和收集之資料型別的組合定義結構描述。
根據上文,您需在Adobe Experience Platform中設定結構。
登入後,您會登入Adobe Experience Platform的首頁。
繼續之前,您必須選取 沙箱。 要選取的沙箱名稱為--aepSandboxName--
。 選取適當的沙箱後,您會看到畫面變更,現在您已進入專屬沙箱。
在Adobe Experience Platform中,按一下熒幕左邊功能表中的 結構描述,然後前往 瀏覽。 您應該建立新的結構描述。 若要建立新的結構描述,請按一下[建立結構描述]按鈕 +。
選取「手動」,然後按一下「選取」。
選取 體驗事件 並按一下 下一步。
輸入結構描述的名稱,如下所示: --aepUserLdap-- - Demo System - Event Schema for Website
。 按一下 完成。
系統隨即會建立新結構描述,而您可以設定將針對該結構描述收集哪些資料。
現在您必須定義問題 此客戶有何行為? 看起來應該像這樣。
在本實驗的簡介中,我們注意到需要下列屬性來定義客戶的行為:
- 造訪過哪些頁面或產品?
- 此客戶是否將產品新增至購物車,或甚至購買商品?
- 使用哪些裝置和瀏覽器來瀏覽網站?
- 這位客戶想要的是什麼資訊,以及我們如何運用這些資訊,為這位客戶設定並提供愉快的體驗?
- 客戶的主要識別碼
若要將該資訊加入結構描述的一部分,您必須將下列欄位群組新增到結構描述:
- AEP Web SDK ExperienceEvent
- 您組織的自訂設定檔識別欄位群組
按一下 欄位群組 下的 +新增。
在 新增欄位群組 畫面中,選取欄位群組 AEP Web SDK ExperienceEvent。 按一下 新增欄位群組。
之後,您將會擁有此專案:
接下來,您必須建立新的欄位群組,以擷取用於資料收集的 識別碼。
您現在將建立自己的自訂欄位群組,因此,您將擴充XDM結構描述以符合您自己組織的需求。
欄位群組已連結至類別,這表示您不能簡單地重複使用先前建立的欄位群組。
按一下「+新增」按鈕,開始新增欄位群組。
您現在將建立自己的欄位群組,而不是重複使用現有的欄位群組。 選取 建立新欄位群組,然後輸入您的欄位群組的名稱,如下所示: --aepUserLdap-- - ExperienceEvent Identification Field Group
。
按一下 新增欄位群組
您現在應該已具備此結構描述結構。
您的新欄位群組仍為空白,因此現在您必須將欄位新增至該欄位群組。
在欄位群組 — 清單中,按一下您的自訂欄位群組。
您現在會看到許多新按鈕。
在結構描述的頂層,按一下結構描述 — 名稱旁的 + 按鈕。
按一下 + 按鈕後,您現在會在結構描述中看到新的無標題欄位。
使用此欄位來定義您的新欄位:
- 欄位名稱:
--aepUserLdap--_identification
- 顯示名稱:
--aepUserLdap--_identification
- 類型:物件
- 欄位群組:
--aepUserLdap-- - ExperienceEvent Identification Field Group
按一下 套用。
現在會在Adobe Experience Platform租使用者ID下建立您的新欄位。 您的Adobe Experience Platform租使用者ID為--aepTenantId--
。
您現在會在 識別 物件下新增1個欄位。
按一下 識別 物件旁的 + 按鈕以建立新欄位。
ECID — 欄位將定義為型別 字串,而您將設定此欄位為 身分。 針對結構描述 示範系統 — 網站 的事件結構描述,我們假設客戶將一律以其ECID識別,這表示您必須將欄位 ECID 設定為 主要 識別碼
您現在有空白欄位。 您必須依指示設定上述欄位。
-
ecid:
- 欄位名稱:
--aepUserLdap--_ecidweb
- 顯示名稱:
--aepUserLdap--_ecidweb
- 型別: 字串
- 欄位群組:
--aepUserLdap-- - ExperienceEvent Identification Field Group
- 欄位名稱:
這是--aepUserLdap--_ecidweb
欄位在初始欄位設定之後的顯示方式:
向下捲動並按一下 套用。
您現在有新欄位,但此欄位尚未定義為 身分 欄位。
若要開始將這些欄位定義為 身分 — 欄位,請選取欄位 --aepUserLdap--_ecidweb
。
在右側的欄位屬性中,向下捲動直到您看到 身分 為止。 核取 身分 的核取方塊,並核取 主要身分 的核取方塊。
從 名稱空間 清單中選取名稱空間 ECID。
按一下 套用 以儲存變更。
識別碼 物件現在看起來應該像這樣,ecid-field現在也會顯示 指紋 圖示,以顯示它們已定義為識別碼。
按一下[儲存]儲存變更。
請務必注意,最終針對此結構擷取資料時,需要一些欄位。
例如,欄位 _id 和 timestamp 是必要欄位,這是ExperienceEvent類別所強加的要求。
- _id必須包含用於特定資料擷取的唯一id
- 時間戳記必須是此點選的時間戳記,格式為
"YYYY-MM-DDTHH:MM:SSSZ"
,例如:"2024-11-18T07:20:000Z"
您現在已定義結構描述、連結現有和新建立的欄位群組且已定義識別碼。
這裡要做的最後一件事,是啟動要連結至 設定檔 的結構描述。
為設定檔啟用結構描述後,您即可確保針對此結構描述傳送至Adobe Experience Platform的所有資料都會成為即時客戶設定檔的一部分,以確保所有資料都可即時用於查詢、細分和啟用。
若要這麼做,請按一下結構描述的名稱。
在結構描述的右側標籤中,您會看到 設定檔切換,目前該切換已停用。 按一下設定檔 — 切換以啟用它。
您將會看到此訊息。 按一下 啟用 為設定檔啟用此結構描述。
您的結構描述現在已設定為即時客戶設定檔的一部分。
按一下[儲存]儲存結構描述。
您現在已完成建立要在即時客戶個人檔案中使用的結構描述。
讓我們在下個練習中檢視資料集。