スキーマとIDのヘルスチェック

スキーマとIDのヘルスチェックでは、スキーマとID名前空間をスキャンして、不完全なID解決、プロファイル数の増加、不正確なアクティベーションにつながるベストプラクティスの欠落や設定のミスがないか確認します。

ID フィールドの検証 identity-field-validation

ID フィールドにデータ整合性の最小長と最大長の制約と正規表現パターンルールがあることを確認するためにスキャンします。

詳細
説明
問題
IDとしてマークされたフィールドに、最小長/最大長またはパターン検証がありません。
影響
検証がなければ、ガベージ値はIdentity Serviceと入力できます。 「0」、「Guest」、ケーシングの不一致(例えば、「xyz123」と「XYZ123」)などの値は、セグメント化とアクティブ化の際に組み立てられるプロファイルの整合性を損ないます。
修正
IDとしてマークされたカスタムフィールドに対して、最小/最大の長さとパターンの制約を設定します。 正規表現を使用して、数字のみ、大文字または小文字、または特定の文字の組み合わせなどのルールを適用します。

ID フィールド検証 カードを選択すると、右側に詳細パネルが開きます。 パネルには次の内容が表示されます。

  • 説明: ID フィールドの長さが最小/最大であること、およびデータの整合性を確保するための正規表現パターンルールを確認するためにスキャンします。 影響を受けるスキーマとフィールドのリスト。
  • 影響: スキーマのID フィールドの最小値/最大値とパターン検証が設定されていない場合、データの一貫性が損なわれ、データの整合性と品質が損なわれる可能性があります。
  • 一般的な影響エリア: Identity Serviceの低画質のID。信頼性のないステッチです。
  • Experience League ドキュメント: データモデリングのベストプラクティスへのリンク。
  • 影響を受けるスキーマ:影響を受けるスキーマのリスト。各スキーマには、詳細を表示するためのエクスパンダーと、スキーマを開くためのリンクが含まれています。

説明、影響、影響を受けるスキーマを示す ID フィールド検証の詳細パネル ​ {modal="regular"}

詳しくは、スキーマのベストプラクティス ドキュメントの「​ データ整合性のヒント ​」を参照してください。

ID グラフのリンクルール identity-graph-linking-rules

折りたたまれたプロファイルを防ぐために、ID グラフのリンク ルールがサンドボックス用に設定されていることを確認します。

詳細
説明
問題
ID グラフのリンクルールは、このサンドボックス用に設定されていません。
影響
ルールをリンクしないと、複数の異なるプロファイルを1つのプロファイルに統合できます(グラフの折りたたみ)。 共有デバイスのデータや重複したIDを利用すると、望ましくないデータの統合がトリガーになり、不正確なパーソナライゼーションにつながる可能性があります。
修正
ID メニューに移動し、設定​を選択し、グラフごとに少なくとも1つの一意のIDを選択します。 これにより、ID グラフのリンク ルールが有効になり、プロファイルの折りたたみを防ぐことができます。

ID グラフ リンク ルール カードを選択すると、右側に詳細パネルが開きます。 パネルには次の内容が表示されます。

  • 説明:適切なリンクルールが設定されていることを確認して、壊れたプロファイルを防ぎます。 現在のルールステータスとグラフごとの一意のIDが表示されます。
  • 影響: ID グラフのリンク ルールが設定されていない場合、特定のデータで、複数の異なるプロファイルを単一のプロファイルに結合しようとすることがあります。 望ましくない結合を防ぐには、ID グラフのリンクルールを通じて提供される設定を使用する必要があります。
  • 一般的な影響エリア:折りたたまれたプロファイルまたは結合されたプロファイル。
  • Experience League ドキュメント:詳しくは、ID グラフのリンキングルールの概要へのリンクを参照してください。
  • リンクルールの設定:チェックが失敗すると、ボタンが表示され、パネルから直接リンクルールを設定できます。

説明、影響、およびリンクルールの設定ボタンを表示する ID グラフ リンクルールの詳細パネル ​ {modal="regular"}

詳細については、ID グラフ リンク ルールの概要および実装ガイド ​を参照してください。

人物および人以外のID設定 people-non-people-identity

スキーマクラス全体で、人物および人物以外のID タイプの正しい使用を検証します。

詳細
説明
問題
個人プロファイルまたはエクスペリエンスイベントクラスのスキーマでは人物以外の識別子が使用され、ルックアップスキーマでは人物識別子が使用されます。
影響
プロファイルスキーマ上の人物以外のIDはID グラフに関与しないため、ID解決が不完全になります。 ルックアップスキーマの人物IDは、プロファイル数を増やし、データをルックアップユースケースの対象外にします。 どちらの場合も、将来の製品の機能強化によって実装が損なわれるリスクがあります。
修正
フラグ付きスキーマを確認し、ID タイプの割り当てを修正します。 可能な限り、個人プロファイルスキーマから人物以外のIDを削除します。 データセットで既に使用されているスキーマについては、​ スキーマ進化ルール ​を参照してください。

People & Non-People ID Config カードを選択すると、右側に詳細パネルが開きます。 パネルには次の内容が表示されます。

  • 説明: スキーマクラス全体でID タイプの適切な使用を検証します。 誤って設定されたスキーマを一覧表示し、誤った割り当てを強調表示します。
  • 影響:人物でないエンティティに個人IDが与えられた場合、プロファイル数が増加し、このデータがルックアップとして無効になります。 個人エンティティに個人ID以外のIDが与えられた場合、そのデータはストリーミングやエッジセグメント化には使用できません。
  • 一般的な影響エリア:不完全なID グラフ、プロファイル数の増加、ルックアップの誤用。
  • 影響を受けるスキーマ:問題のあるスキーマのリスト。 スキーマ行を展開して、設定ミスごとにパス、ID名、スキーマタイプを確認します。 リンクアイコンを使用してスキーマを開きます。

拡張可能な行を持つ説明、影響、影響を受けるスキーマを表示する人物および人物以外のID設定の詳細パネル ​ {modal="regular"}

詳しくは、ID タイプのドキュメント ​および​ スキーマのベストプラクティス ​を参照してください。

カスタム ID名前空間の説明 namespace-missing-description

スキャンして、カスタム ID名前空間のメタデータと説明が完了していることを確認します。

詳細
説明
問題
カスタム ID名前空間に説明フィールドがありません。
影響
説明が見つからない場合、使用時やデバッグ時に混乱が生じる可能性があります。
修正
説明フィールドに入力して、各カスタム名前空間を文書化します。 検証基準(最小/最大の長さ、パターン)と、これらのIDを作成する外部ソースシステムを特定するライフサイクル情報を含めます。

カスタム ID名前空間説明 カードを選択すると、右側に詳細パネルが開きます。 パネルには次の内容が表示されます。

  • 説明:名前空間のメタデータと説明が完了していることを確認するためにスキャンします。 空の説明フィールドを持つ名前空間と所有者を表示します。
  • 影響: カスタム ID名前空間に説明を設定すると、各名前空間の目的のコンテキストが提供されるので、わかりやすくなります。 これにより、チームメンバーや関係者は、各ネームスペースの機能を混乱することなく、すばやく把握できます。
  • 一般的な影響エリア: デバッグまたは使用の混乱。検証の意図が明確ではありません。
  • Experience League ドキュメント:詳細については、カスタム名前空間を作成するためのリンクを参照してください。
  • 影響を受ける名前空間:説明が不足しているカスタム ID名前空間のリスト。 各名前空間の横にあるリンクアイコンを使用して、表示または編集します。

説明、影響、影響を受ける名前空間リストを表示するカスタム ID名前空間説明パネル ​ {modal="regular"}

詳しくは、​ カスタム名前空間の作成に関するドキュメントを参照してください。

非推奨のID名前空間 deprecated-namespace

クリーンアップ用にマークする必要がある古いID名前空間または未使用のID名前空間を検出します。

詳細
説明
問題
古いID名前空間は、非推奨としてマークされません。
影響
未使用の名前空間や古い名前空間は、アクティブに使用されている名前空間に関する混乱を引き起こし、ID フィールドに誤ったラベルを付けるリスクを高めます。
修正
未使用の名前空間の名前を「使用しない」プレフィックスを含めるように変更します(例:「使用しない – [元の名前]」)。 Adobe Experience Platformは現在、名前空間の削除をサポートしていないため、名前の変更が推奨されます。

非推奨ID名前空間 カードを選択すると、右側に詳細パネルが開きます。 パネルには次の内容が表示されます。

  • 説明:クリーンアップ用に古いID名前空間または未使用のID名前空間を検出します。 最後に使用したタイムスタンプまたはスキーマ参照を含む、未使用の名前空間を一覧表示します。
  • 影響:どのスキーマでも使用されていないID名前空間は、名前に「非推奨」または「使用しない」タグを追加することで、削除するようにマークする必要があります。 ID名前空間の削除は現在サポートされていません。
  • 一般的な影響領域:混乱とラベル変更のリスク。
  • Experience League ドキュメント:詳細なドキュメントについては、廃止されたID名前空間へのリンクを参照してください。
  • 影響を受ける名前空間:古いID名前空間または未使用のID名前空間のリスト。 各名前空間の横にあるリンクアイコンを使用して、表示または管理します。

説明、影響、影響を受ける名前空間リストを表示する非推奨のID名前空間の詳細パネル ​ {modal="regular"}

詳しくは、廃止された名前空間🔗に関するExperience Cloud ナレッジベースの記事を参照してください。

関係フィールド上の非個人ID non-person-identity-relationship-field

ID記述子と関係記述子の両方を同時に持つスキーマフィールドにフラグを付けます。

詳細
説明
問題
スキーマフィールドには、ID記述子と関係記述子の両方が適用されており、これらの記述子は相互に排他的です。
影響
同じフィールドに両方の記述子を含めると、データモデリングエラーになります。 結果には、誤ったセグメンテーションやオーディエンスのアクティベーションが含まれる場合があります。
修正
フラグ付きフィールドを確認し、フィールドの機能に応じて、ID記述子または関係記述子のいずれかを削除します。

関係フィールド ​人以外のID カードを選択すると、右側に詳細パネルが開きます。 パネルには次の内容が表示されます。

  • 説明: スキーマフィールドに関係記述子を配置すると、2つの別々のスキーマ間の直接的で動的な結合が確立されることを説明します。 Real-Time Customer Profile ストアと​ セグメントビルダーに、プライマリスキーマまたはソーススキーマのフィールドが、ターゲットスキーマのルックアップまたはディメンションレコードを指す外部キーとして機能することを伝えます。 このチェックは、ID記述子と同じフィールドの関係記述子の両方を持つスキーマフィールドを検査します。
  • 影響:これらの記述子は相互に排他的であり、同じフィールドに両方を含めることはデータモデリングエラーです。 結果には、誤ったセグメンテーションやオーディエンスのアクティベーションが含まれる場合があります。
  • 一般的な影響エリア: オーディエンスの品質。
  • Experience League ドキュメント:ID用のXDM スキーマ構成へのリンク。
  • 影響を受けるスキーマ:該当する場合、競合する記述子を持つフィールドを持つスキーマのリスト。 問題が検出されない場合、代わりにパネルに​ 合格チェック ​の確認が表示されます。

関係フィールドの詳細パネルに、説明、影響、および合格した確認の確認が表示されている人物でないID {modal="regular"}

詳しくは、​ スキーマ構成ドキュメント ​を参照してください。

複数エンティティの関係数 multi-entity-relationship-count

プラットフォームの制限に近づくと、サンドボックスで定義されたマルチエンティティ関係の数を監視します。

詳細
説明
問題
サンドボックスで定義されたマルチエンティティ関係の数が、5の制限に近づいています。
影響
高い基数と過剰なスキーマ結合は、Real-Time Customer Profile ストア全体で計算の複雑さを増します。 制限を超えると、Segmentation Serviceのパフォーマンスが低下し、オーディエンス評価の遅延が増加する可能性があります。
修正
既存のマルチエンティティ関係を確認し、不要になった関係を削除してから新しい関係を作成します。

Multi-Entity Relationship Count」カードを選択すると、右側に詳細パネルが開きます。 パネルには次の内容が表示されます。

  • 説明:複数のエンティティの関係が、Real-Time Customer ProfilesやExperienceEventsなどのプライマリエンティティを、商品カタログ、店舗、ビジネスアカウントなどのセカンダリディメンションエンティティにリンクすることを説明します。 このチェックは、サンドボックスで定義された5つのマルチエンティティ関係の制限を超えているかどうかを調べます。
  • 影響:高い基数と過度のスキーマ結合は、Real-Time Customer Profile ストア全体で計算の複雑さを高めます。 制限を超えると、Segmentation Serviceのパフォーマンスが低下し、オーディエンス評価の遅延が増加する可能性があります。
  • 一般的な影響領域: バッチセグメント化。
  • Experience League ドキュメント: データモデリングのベストプラクティスへのリンク。

説明、影響、一般的な影響エリア、および通過した確認を確認するマルチエンティティ関係数の詳細パネル ​ {modal="regular"}

詳しくは、​ データモデリングのベストプラクティス ​および複数エンティティのセグメント化チュートリアル ​を参照してください。

監査フィールドグループがありません missing-audit-field-group

XDM Individual Profile スキーマにExternal Source System Audit Details フィールドグループが含まれていることを確認します。

詳細
説明
問題
1つ以上のXDM個人プロファイルスキーマに、外部Source System Audit Details フィールドグループがありません。
影響
監査フィールドがなければ、データがいつ取り込まれたかをレコードレベルで把握できないため、古くなったレコードや重複したレコードのトラブルシューティングが困難になります。
修正
「External Source System Audit Details」フィールドグループを、スキーマに追加します。

環境にない監査フィールドグループ カードを選択すると、右側に詳細パネルが開きます。 パネルには次の内容が表示されます。

  • 説明: XDM個人プロファイルスキーマに、レコードの出所と更新タイムスタンプのトラッキングに必要な外部Source System Audit Details フィールドグループが含まれていることを確認します。
  • 影響:監査フィールドがないと、データがExperience Platformに取り込まれたタイミングに関するレコードレベルの可視性がありません。そのため、古いレコードや重複したレコードのトラブルシューティングが困難になります。
  • 一般的な影響エリア:外部データの変更を監査できません。
  • Experience League ドキュメント:外部Source System監査詳細フィールドグループへのリンク。
  • Recommendation:見つからない場合は、外部Source System Audit Details フィールドグループを追加します。
  • 影響を受けるスキーマ: フィールドグループが見つからないスキーマのリスト。 各スキーマの横にあるリンクアイコンを使用して開きます。

説明、影響、推奨事項、影響を受けるスキーマを示す監査フィールドグループの詳細パネルがありません {modal="regular"}

詳細については、外部Source System Audit Details フィールドグループのドキュメント ​を参照してください。

次の手順 next-steps

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