結構描述和身分健康情況檢查
結構描述和身分健康情況檢查會掃描您的結構描述和身分識別名稱空間,找出遺失的最佳實務和錯誤設定,導致身分解析不完整、設定檔計數誇大和啟用不正確。
身分欄位驗證 identity-field-validation
掃描以確保識別欄位具有最小和最大長度限制,以及資料整合的規則運算式模式規則。
當您選取 身分欄位驗證 卡片時,會在右側開啟詳細資料面板。 面板會顯示:
- 描述:掃描以確定識別欄位具有最小/最大長度,以及資料完整性規則運算式模式規則。 列出受影響的方案和欄位。
- 影響:如果結構描述中的身分欄位沒有設定上下限長度和模式驗證,可能會導致資料不一致,進而影響資料的完整性和品質。
- 影響的一般區域: Identity Service中的低品質識別碼;不可靠的彙整。
- Experience League檔案:資料模型最佳作法的連結。
- 受影響的結構描述:受影響的結構描述清單,每個包含可檢視更多詳細資料的擴充器,以及開啟結構描述的連結。
如需詳細資訊,請參閱結構描述最佳實務檔案中的資料完整性提示。
身分識別圖連結規則 identity-graph-linking-rules
驗證身分圖表連結規則是否已針對沙箱進行設定,以防止摺疊的設定檔。
選取 身分圖表連結規則 卡片時,右側會開啟詳細資料面板。 面板會顯示:
- 描述:驗證是否已設定正確的連結規則,以防止摺疊的設定檔。 它會顯示目前的規則狀態和每個圖表的不重複身分。
- 影響:如果未設定身分圖表連結規則,某些資料可能會嘗試將多個不同的設定檔合併為單一設定檔。 若要防止不想要的合併,應使用透過身分圖表連結規則提供的設定。
- 影響的一般區域:摺疊或合併的設定檔。
- Experience League檔案:身分圖表連結規則總覽的連結,以取得詳細資訊。
- 設定連結規則:檢查失敗時,會出現一個按鈕,讓您可以直接從面板設定連結規則。
如需詳細資訊,請參閱身分圖表連結規則總覽和實作指南。
人員與非人員身分設定 people-non-people-identity
驗證結構描述類別中人員與非人員身分型別的正確使用。
選取 人員與非人員身分設定 卡片時,右側會開啟詳細資料面板。 面板會顯示:
- 描述:驗證跨結構描述類別正確使用了身分型別。 列出設定錯誤的結構描述,並醒目提示錯誤的指派。
- 影響:如果非人員實體獲得人員身分,將誇大設定檔計數,並使此資料不符合查閱資格。 如果以非人員身分識別個人實體,資料將無法用於串流或邊緣劃分。
- 影響的一般領域:不完整的身分圖表;膨脹的設定檔計數;查詢誤用。
- 受影響的結構描述:有問題的結構描述清單。 展開結構描述列,以檢視每個設定錯誤的路徑、身分名稱和結構描述型別。 使用連結圖示開啟方案。
自訂身分名稱空間說明 namespace-missing-description
掃描以確保自訂身分名稱空間中繼資料和說明完整。
當您選取 自訂身分名稱空間描述 卡片時,會在右側開啟詳細資料面板。 面板會顯示:
- 描述:掃描以確保名稱空間中繼資料和描述完整。 顯示具有空白說明欄位的名稱空間和擁有者。
- 影響:在自訂身分名稱空間上設定說明,可提供每個名稱空間目的的內容,提高清晰度。 這有助於團隊成員和利害關係人快速瞭解每個名稱空間的功能,而不會混淆。
- 影響的一般領域:偵錯或使用方式混淆;不清楚的驗證意圖。
- Experience League檔案:建立自訂名稱空間的連結,以取得進一步資訊。
- 受影響的名稱空間:缺少說明的自訂身分名稱空間清單。 使用每個名稱空間旁的連結圖示來檢視或編輯。
如需詳細資訊,請參閱有關建立自訂名稱空間的檔案。
身分名稱空間未使用 namespace-not-in-use
偵測應標示為要清理的過時或未使用的身分名稱空間。 此檢查先前記錄為「過時的身分名稱空間」。
當您選取 未使用的身分名稱空間 卡片時,右側會開啟詳細資料面板。 面板會顯示:
- 描述:偵測過時或未使用的身分名稱空間以進行清除。 列出具有上次使用時間戳記或結構描述參考的未使用名稱空間。
- 影響:未在任何結構描述中使用的身分名稱空間應標示為移除,方法是在其名稱中新增「DEPRECATED」或「DO NOT USE」標籤。 目前不支援刪除身分名稱空間。
- 影響的一般領域:混淆和標籤錯誤的風險。
- Experience League檔案:舊版身分識別名稱空間的連結,以取得進一步檔案。
- 受影響的名稱空間:過時或未使用的身分識別名稱空間清單。 使用每個名稱空間旁的連結圖示來檢視或管理名稱空間。
如需詳細資訊,請參閱有關過時名稱空間的Experience Cloud知識庫文章。
關係欄位上的非個人身分 non-person-identity-relationship-field
標示同時具有身分描述項和關係描述項的結構描述欄位。
當您選取 關聯性欄位 卡片上的非人員身分識別時,會在右側開啟詳細資料面板。 面板會顯示:
- 描述:說明將關係描述項放在結構描述欄位上,可建立兩個個別結構描述之間的直接、動態結合。 它會告知Real-Time Customer Profile存放區和對象產生器,主要或來源結構描述中的欄位會當做指向目標結構描述中的查閱或維度記錄的外來鍵。 此檢查會檢查在同一欄位中同時具有身分描述項和關係描述項的結構描述欄位。
- 影響:這些描述項互斥,且在同一欄位上包含這兩個描述項是資料模型錯誤。 結果可能包括不正確的分段和受眾啟用。
- 影響的一般領域:對象品質。
- Experience League檔案:身分識別的XDM結構描述構成連結。
- 受影響的結構描述:包含具有衝突描述項欄位的結構描述清單(若適用)。 未偵測到問題時,面板會改為顯示 通過 確認。
如需詳細資訊,請參閱結構描述組合檔案。
多實體關係計數 multi-entity-relationship-count
當沙箱中定義的多實體關係數接近平台限制時,監視這些關係。
選取 多實體關係計數 卡片時,右側會開啟詳細資料面板。 面板會顯示:
- 描述:說明多實體關係會將主要實體(例如Real-Time Customer Profiles或ExperienceEvents)連結到次要維度實體,例如產品目錄、商店位置或企業帳戶。 此檢查會檢查是否超過沙箱中定義的5個多實體關係的限制。
- 影響:高基數和過多的結構描述加入會增加Real-Time Customer Profile存放區的運算複雜性。 超過上限可能會降低細分服務效能,並增加對象評估延遲。
- 影響的一般領域:批次細分。
- Experience League檔案:資料模型最佳作法的連結。
缺少稽核欄位群組 missing-audit-field-group
驗證XDM個別設定檔結構描述是否包含外部Source系統稽核詳細資訊欄位群組。
當您選取 缺少稽核欄位群組 卡片時,右側會開啟詳細資料面板。 面板會顯示:
- 描述:驗證XDM個別設定檔結構描述是否包含外部Source系統稽核詳細資料欄位群組,這是追蹤記錄來源和更新時間戳記的必要欄位。
- 影響:若沒有稽核欄位,將資料擷取到Experience Platform時就不會有記錄層級的可見性,因此很難疑難排解過時或重複的記錄。
- 影響的一般領域:無法稽核外部資料變更。
- Experience League檔案:外部Source系統稽核詳細資料欄位群組的連結。
- 建議:如果遺漏,請新增外部Source系統稽核詳細資料欄位群組。
- 受影響的結構描述:缺少欄位群組的結構描述清單。 使用每個結構描述旁邊的連結圖示來開啟它。
如需詳細資訊,請參閱外部Source系統稽核詳細資料欄位群組檔案。
主要身分的唯一性 primary-identity-uniqueness
根據身分圖表連結規則中身分名稱空間的定義方式,比較身分名稱空間作為主要身分的使用方式。
當您選取 主要身分唯一性 卡片時,右側會開啟詳細資料面板。 面板會顯示:
- 描述:說明主要身分驅動了Real-Time Customer Profiles的元件。 連結規則定義哪些身分名稱空間應該和不應該在相同身分圖表中出現多次。 此檢查會根據身分圖表連結規則中身分名稱空間定義的方式,來比較身分名稱空間作為主要身分的使用方式。
- 影響:使用非唯一的設定檔身分來儲存具有簡單純量值的設定檔類別記錄,會導致在存取設定檔時忽略除一個記錄以外的所有記錄。 有兩個例外:僅包含合併陣列的結構描述,以及永遠根據擷取計時和合併原則選取所需記錄的情況。
- 影響的一般領域:設定檔正確性、對象品質和啟動品質。
- Experience League檔案:身分圖表連結規則總覽的連結。
如需詳細資訊,請參閱身分圖表連結規則總覽。
多層級關係 multi-level-relationships
偵測二維結構描述之間未正確定義的關係。
當您選取 多重層級關係 卡片時,會在右側開啟詳細資料面板。 面板會顯示:
- 描述:說明僅應在XDM Individual Profile或XDM ExperienceEvent類別的結構描述與維度結構描述之間建立關係。 此檢查會檢查二維結構描述之間未正確定義的關係。
- 影響:不支援多重層級關聯性鏈結,且會在細分期間導致無法預測的行為。
- 影響的一般領域:細分和對象品質。
- Experience League檔案:資料模型最佳作法的連結。
如需詳細資訊,請參閱資料模型最佳實務。
主要身分欄位深度 primary-identity-field-depth
驗證主要身分欄位在結構描述欄位階層中的巢狀結構是否太深。
當您選取 主要身分欄位深度 卡片時,會在右側開啟詳細資料面板。 面板會顯示:
- 說明:說明主要身分欄位深度是指XDM結構描述的欄位階層中放置主要身分欄位的位置,以及控管該位置的限制和最佳實務。 此檢查會驗證主要身分欄位是否未巢狀內嵌超過四個層級。
- 影響:巢狀超過四個層級的主要身分欄位,可能會在資料擷取和分段中造成無法預測的行為。
- 影響的一般領域:資料擷取、細分和對象品質。
- Experience League檔案:資料模型最佳作法的連結。
如需詳細資訊,請參閱資料模型最佳實務。
跨結構描述複製欄位群組 duplicate-field-groups-across-schemas
偵測在多個結構描述中保持作用中的非身分欄位群組。
當您選取「跨結構描述重複欄位群組」卡片時,右側會開啟詳細資料面板。 面板會顯示:
- 描述:說明Experience Platform允許將特定欄位群組包含到多個結構描述中。 雖然這是建立結構描述時的正常用法,但將個別非身分欄位保持為多個結構描述中可見是不好的資料模型做法。 此檢查會檢查多個結構描述中是否有任何非身分欄位保持作用中。
- 影響:將相同結構描述欄位的值來源化為多個資料集,可能會讓測試這些欄位的對象結果變得無法預測。 合併原則可將此問題降至最低,但絕不會完全消除此問題,而且產生的變數通常很難除錯。
- 影響的一般領域:細分和對象結果。
- Experience League檔案:將欄位群組新增至結構描述的連結。
- 建議:使用Managed相關欄位功能編輯結構描述,並在除一個結構描述外的所有結構描述中隱藏非身分欄位。
- 受影響的欄位群組:跨結構描述共用的欄位群組清單,包含欄位群組參照和結構描述名稱。 使用連結圖示開啟方案。
如需詳細資訊,請參閱將欄位群組新增至結構描述。
缺少機器人偵測欄位群組 bot-detection-field-group-missing
驗證ExperienceEvent結構描述是否包含「機器人偵測資訊」欄位群組。
botDetection.isBot布林欄位,然後從區段中排除機器人。當您選取「機器人偵測欄位群組遺失」卡片時,右側會開啟詳細資料面板。 面板會顯示:
- 描述:說明Experience Platform提供XDM ExperienceEvent結構描述的機器人偵測欄位群組。 此欄位群組可在事件層級標幟非人類流量,例如網頁爬蟲、刮刀和自動化代理程式。 此檢查會視需要驗證欄位群組是否已包含在ExperienceEvent結構描述中。
- 影響:當擷取Web或應用程式互動資料的ExperienceEvent結構描述中缺少此欄位群組時,沒有標準化機制可識別來自合法客戶活動的機器人產生事件。
- 影響的一般領域:對象細分和串流對象評估效能輸送量。
- Experience League檔案: Bot Detection Information欄位群組的連結。
- 建議:將機器人偵測資訊欄位群組新增至每個已標幟的ExperienceEvent結構描述。 使用機器人偵測訊號填入
botDetection.isBot欄位,然後從區段中排除機器人。
如需詳細資訊,請參閱機器人偵測資訊欄位群組檔案。
允許零長度字串 zero-length-strings-allowed
驗證字串欄位是否需要最小長度為一個字元。
選取 允許零長度字串 卡片時,右側會開啟詳細面板。 面板會顯示:
- 描述:說明Experience Platform預設在資料擷取期間同時允許null值和零長度字串值。 最佳實務是禁止長度為零的字串值,方法是在所有字串欄位上指定最小長度1。 此檢查會檢查缺少此最小長度設定的結構描述。
- 影響:當字串欄位缺少最小長度限制時,可以擷取長度為零的字串,這會導致在對象定義、SQL編寫、Adobe Journey Optimizer規則和其他功能期間無法使用此資料。
- 影響的一般領域:對象品質。
- Experience League檔案:資料模型最佳作法的連結。
- 建議:新增最小長度限制至所有字串欄位。
- 受影響的結構描述:受影響的結構描述和欄位路徑的清單。 使用連結圖示開啟方案。
如需詳細資訊,請參閱資料模型最佳實務。
沒有限制的陣列 arrays-without-constraints
驗證陣列欄位是否定義最小和最大專案限制。
當您選取 沒有限制的陣列 卡片時,會在右側開啟詳細面板。 面板會顯示:
- 描述:說明Experience Platform允許指定陣列欄位中專案數的最小和最大長度。 此檢查會檢查陣列欄位是否缺少可包含專案數的限制。
- 影響:若未定義結構描述中的最小或最大長度限制,資料擷取期間將不會驗證陣列中的專案數,這可能會導致擷取記錄超過護欄。
- 影響的一般領域:資料擷取和對象品質。
- Experience League檔案:資料模型最佳作法的連結。
如需詳細資訊,請參閱資料模型最佳實務。
同意欄位群組遺失 consent-field-group-missing
驗證啟用設定檔的結構描述是否包含同意和偏好設定詳細資訊欄位群組。
當您選取 同意欄位群組遺失 卡片時,右側會開啟詳細資料面板。 面板會顯示:
- 說明:說明「同意和偏好設定」欄位群組以標準化結構擷取客戶同意訊號,例如行銷管道、個人化和資料收集的加入和退出偏好設定。 此檢查會檢查欄位群組是否包含在至少一個已啟用設定檔的結構描述中。
- 影響:當啟用設定檔的結構描述中缺少此欄位群組時,Experience Platform無法使用原始同意基礎結構在設定檔層級強制執行同意原則。
- 影響的一般領域:啟動品質。
- Experience League檔案: 「同意和偏好設定」欄位群組的連結。
如需詳細資訊,請參閱同意和偏好設定欄位群組檔案。
後續步驟 next-steps
- 返回健康情況檢查總覽以探索其他檢查類別。
- 瞭解設計可靠資料模型的結構描述最佳做法。
- 瞭解身分圖表連結規則以防止設定檔摺疊。
- 檢閱身分識別名稱空間檔案,以取得名稱空間管理的最佳實務。