結構描述和身分健康情況檢查

結構描述和身分健康情況檢查會掃描您的結構描述和身分識別名稱空間,找出遺失的最佳實務和錯誤設定,導致身分解析不完整、設定檔計數誇大和啟用不正確。

檢查
物件類型
身分欄位驗證
結構描述
身分圖表連結規則
身分識別
人員與非人員身分設定
結構描述,身分
自訂身分名稱空間描述
身分識別
已棄用的身分名稱空間
身分識別
關聯性欄位🔗上的非個人身分
結構描述
多實體關係計數
結構描述
缺少稽核欄位群組
結構描述

身分欄位驗證 identity-field-validation

掃描以確保識別欄位具有最小和最大長度限制,以及資料整合的規則運算式模式規則。

詳細資料
說明
問題
標籤為身分的欄位缺少最小/最大長度或模式驗證。
影響
若未驗證,記憶體值可以輸入Identity Service。 例如「0」、「Guest」或大小寫不符的值(例如「xyz123」與「XYZ123」)會損害分段與啟用期間所組裝之設定檔的完整性。
修正
在標籤為身分的自訂欄位上設定最小/最大長度和模式限制。 使用規則運算式可強制實施僅數字、大寫或小寫或特定字元組合等規則。

當您選取​ 身分欄位驗證 ​卡片時,會在右側開啟詳細資料面板。 面板會顯示:

  • 描述:掃描以確定識別欄位具有最小/最大長度,以及資料完整性規則運算式模式規則。 列出受影響的方案和欄位。
  • 影響:如果結構描述中的身分欄位沒有設定上下限長度和模式驗證,可能會導致資料不一致,進而影響資料的完整性和品質。
  • 影響的一般區域: Identity Service中的低品質識別碼;不可靠的彙整。
  • Experience League檔案:資料模型最佳作法的連結。
  • 受影響的結構描述:受影響的結構描述清單,每個包含可檢視更多詳細資料的擴充器,以及開啟結構描述的連結。

身分欄位驗證詳細資訊面板,顯示說明、影響和受影響的結構描述 {modal="regular"}

如需詳細資訊,請參閱結構描述最佳實務檔案中的資料完整性提示

身分識別圖連結規則 identity-graph-linking-rules

驗證身分圖表連結規則是否已針對沙箱進行設定,以防止摺疊的設定檔。

詳細資料
說明
問題
未針對此沙箱設定身分圖表連結規則。
影響
如果沒有連結規則,多個不同的設定檔可以合併為單一設定檔(圖表收合)。 來自共用裝置或非唯一身分的特定資料可能會觸發不需要的合併,導致不正確的個人化。
修正
導覽至​ 身分 ​功能表,選取​設定,並選取每個圖形的至少一個唯一身分。 如此可啟用身分圖表連結規則,並防止設定檔摺疊。

選取​ 身分圖表連結規則 ​卡片時,右側會開啟詳細資料面板。 面板會顯示:

  • 描述:驗證是否已設定正確的連結規則,以防止摺疊的設定檔。 它會顯示目前的規則狀態和每個圖表的不重複身分。
  • 影響:如果未設定身分圖表連結規則,某些資料可能會嘗試將多個不同的設定檔合併為單一設定檔。 若要防止不想要的合併,應使用透過身分圖表連結規則提供的設定。
  • 影響的一般區域:摺疊或合併的設定檔。
  • Experience League檔案:身分圖表連結規則總覽的連結,以取得詳細資訊。
  • 設定連結規則:檢查失敗時,會出現一個按鈕,讓您可以直接從面板設定連結規則。

身分圖表連結規則詳細資訊面板,顯示說明、影響和設定連結規則按鈕 {modal="regular"}

如需詳細資訊,請參閱身分圖表連結規則總覽實作指南

人員與非人員身分設定 people-non-people-identity

驗證結構描述類別中人員與非人員身分型別的正確使用。

詳細資料
說明
問題
非人員識別碼用於個人設定檔或體驗事件類別結構描述,或人員識別碼用於查詢結構描述。
影響
個人資料結構描述上的非人員識別碼不參與身分圖表,這會導致不完整的身分解析。 查閱結構描述上的人員識別碼會使設定檔計數膨脹,使資料不符合查閱使用案例的資格。 這兩個案例都可能讓未來的產品增強功能破壞您的實作。
修正
檢閱已標幟的結構描述並更正身分型別指派。 儘可能從個人設定檔結構描述中移除非人員識別碼。 對於資料集已使用的結構描述,請參閱結構描述演化規則

選取​ 人員與非人員身分設定 ​卡片時,右側會開啟詳細資料面板。 面板會顯示:

  • 描述:驗證跨結構描述類別正確使用了身分型別。 列出設定錯誤的結構描述,並醒目提示錯誤的指派。
  • 影響:如果非人員實體獲得人員身分,將誇大設定檔計數,並使此資料不符合查閱資格。 如果以非人員身分識別個人實體,資料將無法用於串流或邊緣劃分。
  • 影響的一般領域:不完整的身分圖表;膨脹的設定檔計數;查詢誤用。
  • 受影響的結構描述:有問題的結構描述清單。 展開結構描述列,以檢視每個設定錯誤的路徑、身分名稱和結構描述型別。 使用連結圖示開啟方案。

人員與非人員身分設定詳細資料面板,顯示說明、影響以及包含可擴充列的受影響結構描述 {modal="regular"}

如需詳細資訊,請參閱身分型別檔案結構描述最佳實務

自訂身分名稱空間說明 namespace-missing-description

掃描以確保自訂身分名稱空間中繼資料和說明完整。

詳細資料
說明
問題
自訂身分名稱空間缺少其說明欄位。
影響
缺少說明可能會在使用和偵錯期間導致混淆。
修正
填寫說明欄位以記錄每個自訂名稱空間。 包括驗證條件(最小/最大長度、模式)和識別外部來源系統建立這些身分的生命週期資訊。

當您選取​ 自訂身分名稱空間描述 ​卡片時,會在右側開啟詳細資料面板。 面板會顯示:

  • 描述:掃描以確保名稱空間中繼資料和描述完整。 顯示具有空白說明欄位的名稱空間和擁有者。
  • 影響:在自訂身分名稱空間上設定說明,可提供每個名稱空間目的的內容,提高清晰度。 這有助於團隊成員和利害關係人快速瞭解每個名稱空間的功能,而不會混淆。
  • 影響的一般領域:偵錯或使用方式混淆;不清楚的驗證意圖。
  • Experience League檔案:建立自訂名稱空間的連結,以取得進一步資訊。
  • 受影響的名稱空間:缺少說明的自訂身分名稱空間清單。 使用每個名稱空間旁的連結圖示來檢視或編輯。

自訂身分名稱空間描述詳細資訊面板,顯示描述、影響和受影響的名稱空間清單 {modal="regular"}

如需詳細資訊,請參閱有關建立自訂名稱空間的檔案。

已棄用的身分名稱空間 deprecated-namespace

偵測應標示為要清理的過時或未使用的身分名稱空間。

詳細資料
說明
問題
過時的身分名稱空間不會標示為已過時。
影響
未使用或過時的名稱空間會造成使用中內容的混淆,並會增加身分欄位錯誤標籤的風險。
修正
重新命名未使用的名稱空間以包含「不要使用」前置詞(例如「不要使用 — [原始名稱]」)。 Adobe Experience Platform目前不支援名稱空間刪除,因此建議重新命名。

當您選取​ 已棄用的身分識別名稱空間 ​卡片時,右側會開啟詳細資料面板。 面板會顯示:

  • 描述:偵測過時或未使用的身分名稱空間以進行清除。 列出具有上次使用時間戳記或結構描述參考的未使用名稱空間。
  • 影響:未在任何結構描述中使用的身分名稱空間應標示為移除,方法是在其名稱中新增「DEPRECATED」或「DO NOT USE」標籤。 目前不支援刪除身分名稱空間。
  • 影響的一般領域:混淆和標籤錯誤的風險。
  • Experience League檔案:舊版身分識別名稱空間的連結,以取得進一步檔案。
  • 受影響的名稱空間:過時或未使用的身分識別名稱空間清單。 使用每個名稱空間旁的連結圖示來檢視或管理名稱空間。

已棄用的身分名稱空間詳細資料面板,顯示說明、影響和受影響的名稱空間清單 {modal="regular"}

如需詳細資訊,請參閱有關過時名稱空間的Experience Cloud知識庫文章

關係欄位上的非個人身分 non-person-identity-relationship-field

標示同時具有身分描述項和關係描述項的結構描述欄位。

詳細資料
說明
問題
結構描述欄位同時套用身分描述項和關係描述項,這些描述項互斥。
影響
在相同的欄位上包含兩個描述項是資料模型錯誤。 結果可能包括不正確的分段和受眾啟用。
修正
檢閱標幟的欄位,並根據欄位的運作方式,移除身分描述項或關係描述項。

當您選取​ 關聯性欄位 ​卡片上的非人員身分識別時,會在右側開啟詳細資料面板。 面板會顯示:

  • 描述:說明將關係描述項放在結構描述欄位上,可建立兩個個別結構描述之間的直接、動態結合。 它會告知Real-Time Customer Profile存放區和區段產生器,主要或來源結構描述中的欄位會當做指向目標結構描述中的查閱或維度記錄的外來鍵。 此檢查會檢查在同一欄位中同時具有身分描述項和關係描述項的結構描述欄位。
  • 影響:這些描述項互斥,且在同一欄位上包含這兩個描述項是資料模型錯誤。 結果可能包括不正確的分段和受眾啟用。
  • 影響的一般領域:對象品質。
  • Experience League檔案:身分識別的XDM結構描述構成連結。
  • 受影響的結構描述:包含具有衝突描述項欄位的結構描述清單(若適用)。 未偵測到問題時,面板會改為顯示​ 通過 ​確認。

關聯性欄位上的非人員身分詳細資料面板,顯示說明、影響及通過檢查的確認 {modal="regular"}

如需詳細資訊,請參閱結構描述組合檔案

多實體關係計數 multi-entity-relationship-count

當沙箱中定義的多實體關係數接近平台限制時,監視這些關係。

詳細資料
說明
問題
沙箱中定義的多實體關係數已接近5的上限。
影響
高基數和過多的結構描述加入會增加Real-Time Customer Profile存放區的運算複雜性。 超過上限可能會降低細分服務效能,並增加對象評估延遲。
修正
檢閱現有的多實體關係,並在建立新關係之前移除不再需要的任何關係。

選取​ 多實體關係計數 ​卡片時,右側會開啟詳細資料面板。 面板會顯示:

  • 描述:說明多實體關係會將主要實體(例如Real-Time Customer Profiles或ExperienceEvents)連結到次要維度實體,例如產品目錄、商店位置或企業帳戶。 此檢查會檢查是否超過沙箱中定義的5個多實體關係的限制。
  • 影響:高基數和過多的結構描述加入會增加Real-Time Customer Profile存放區的運算複雜性。 超過上限可能會降低細分服務效能,並增加對象評估延遲。
  • 影響的一般領域:批次細分。
  • Experience League檔案:資料模型最佳作法的連結。

多實體關係計數詳細資料面板,顯示說明、影響、影響的一般區域,以及通過檢查的確認 {modal="regular"}

如需詳細資訊,請參閱資料模型最佳實務多實體細分教學課程

缺少稽核欄位群組 missing-audit-field-group

驗證XDM個別設定檔結構描述是否包含外部Source系統稽核詳細資訊欄位群組。

詳細資料
說明
問題
一個或多個XDM個別設定檔結構描述缺少外部Source系統稽核詳細資訊欄位群組。
影響
若沒有稽核欄位,您擷取資料時就不會有記錄層級的可見度,因而難以疑難排解過時或重複的記錄。
修正
將外部Source系統稽核詳細資料欄位群組新增到缺少該欄位群組的結構描述。

當您選取​ 缺少稽核欄位群組 ​卡片時,右側會開啟詳細資料面板。 面板會顯示:

  • 描述:驗證XDM個別設定檔結構描述是否包含外部Source系統稽核詳細資料欄位群組,這是追蹤記錄來源和更新時間戳記的必要欄位。
  • 影響:若沒有稽核欄位,將資料擷取到Experience Platform時就不會有記錄層級的可見性,因此很難疑難排解過時或重複的記錄。
  • 影響的一般領域:無法稽核外部資料變更。
  • Experience League檔案:外部Source系統稽核詳細資料欄位群組的連結。
  • 建議:如果遺漏,請新增外部Source系統稽核詳細資料欄位群組。
  • 受影響的結構描述:缺少欄位群組的結構描述清單。 使用每個結構描述旁邊的連結圖示來開啟它。

缺少稽核欄位群組詳細資訊面板,顯示說明、影響、建議和受影響的結構描述 {modal="regular"}

如需詳細資訊,請參閱外部Source系統稽核詳細資料欄位群組檔案

後續步驟 next-steps

recommendation-more-help
experience-platform-help-run-and-operate