Real-time Customer Data Platform B2B エディションでの 2 つのスキーマ間における多対 1 の関係を定義 relationship-b2b
Adobe Real-time Customer Data Platform B2B Edition には、 アカウント、 商談、 キャンペーンなど、基本的な B2B データエンティティをキャプチャするエクスペリエンスデータモデル （XDM） クラスがいくつか用意されています。 これらのクラスに基づいてスキーマを構築し、それらを リアルタイム顧客プロファイルで使用できるようにすると、異なるソースのデータを結合スキーマと呼ばれる統合表現に統合できます。
ただし、和集合スキーマには、同じクラスを共有するスキーマによってキャプチャされたフィールドのみを含めることができます。 スキーマの関係は、ここに格納されます。 B2B スキーマで関係を実装することで、これらのビジネスエンティティの相互関係を記述し、ダウンストリームセグメント化のユースケースに複数のクラスの属性を含めることができます。
次の図は、基本的な実装において、様々な B2B クラスがどのように相互に関連付けられるかを示す例を示しています。
このチュートリアルでは、Real-Time CDP B2B Edition の 2 つのスキーマ間に多対 1 の関係を定義する手順を説明します。
はじめに
このチュートリアルでは、Experience Platform UI の XDM System とスキーマエディターに関する十分な知識が必要です。 このチュートリアルを始める前に、次のドキュメントを確認してください。
- Experience Platformにおける XDM システム:XDM と Experience Platform での実装の概要です。
- スキーマ構成の基本：XDM スキーマの構築ブロックの紹介。
- 次を使用してスキーマを作成 Schema Editor:UI でスキーマを作成および編集する方法の基本を説明するチュートリアル。
ソースおよび参照スキーマの定義
この関係で定義される 2 つのスキーマが既に作成されていると想定されます。デモ目的で、このチュートリアルは、（「Opportunities」スキーマで定義された）ビジネスオポチュニティと、関連する（「Accounts」スキーマで定義された）ビジネスアカウントとの関係を作成します。
スキーマ関係は、参照スキーマ のプライマリ ID フィールドを参照する ソーススキーマ 内の専用フィールドで表されます。 以降の手順では、「Opportunities」はソーススキーマとして機能し、「Accounts」は参照スキーマとして機能します。
B2B の関係での ID について
関係を確立するには、参照スキーマに定義済みのプライマリ ID が必要です。 B2B エンティティのプライマリ ID を設定する場合は、様々なシステムや場所にわたって文字列ベースのエンティティ ID を収集すると、重複する可能性があり、Platform でデータの競合が発生する可能性があることに注意してください。
これに対処するために、すべての標準 B2B クラスには、B2B Source データタイプに準拠する「キー」フィールドが含まれています。 このデータタイプは、B2B エンティティの文字列識別子のフィールドと、識別子のソースに関するその他のコンテキスト情報を提供します。 これらのフィールドの 1 つ（sourceKey）は、データタイプ内の他のフィールドの値を連結して、エンティティの完全に一意の ID を生成します。 このフィールドは、B2B エンティティスキーマのプライマリ ID として常に使用する必要があります。
参照目的で、次の節では、関係が定義される前に、このチュートリアルで使用する各スキーマの構造について説明します。 プライマリ ID が定義されているスキーマ構造と、それらが使用するカスタム名前空間に注意してください。
商談スキーマ
ソーススキーマ「Opportunities」は、XDM Business Opportunity クラスに基づいています。 クラス opportunityKey が提供するフィールドの 1 つは、スキーマの識別子として機能します。 特に、opportunityKey オブジェクトの sourceKey フィールドは、B2B Opportunity というカスタム名前空間でスキーマのプライマリ ID として設定されます。
フィールドプロパティ の節で示すように、このスキーマは Real-Time Customer Profile で使用できるようになりました。
Accounts スキーマ
参照スキーマ「Accounts」は、XDM Account クラスに基づいています。 ルートレベルの accountKey フィールドには、B2B Account と呼ばれるカスタム名前空間の下でプライマリ ID として機能する sourceKey が含まれています。 このスキーマは、プロファイルでも使用できるようになりました。
ソーススキーマで関係フィールドを定義 relationship-field
2 つのスキーマ間の関係を定義するには、ソーススキーマに、参照スキーマのプライマリ ID を示す専用のフィールドが必要です。 標準 B2B クラスには、一般的に関連するビジネスエンティティ用の専用のソースキーフィールドが含まれています。 例えば、XDM Business Opportunity クラスには、関連するアカウント（accountKey）と関連するキャンペーン（campaignKey）のソースキーフィールドが含まれています。 ただし、デフォルトのコンポーネント以上が必要な場合は、カスタムフィールドグループを使用して、他の B2B Source フィールドをスキーマに追加することもできます。
関係フィールドを設定するには、キャンバス内で該当するフィールドを選択し、スキーマプロパティ サイドバーで 関係を追加 を選択します。 Opportunities スキーマの場合、目標はアカウントとの多対 1 の関係を確立することなので、これは accountKey.sourceKey のフィールドになります。
関係を追加 ダイアログが表示されます。 このダイアログを使用して、関係の詳細を指定します。 関係タイプは、デフォルトで 多対 1 に設定されます。
参照スキーマ の下で、検索バーまたはドロップダウンメニューを使用して、参照スキーマの名前を探します。 参照スキーマの名前をハイライト表示すると、「参照 ID 名前空間 フィールドが、参照スキーマのプライマリ ID の名前空間に自動的に更新されます。
現在のスキーマからの関係名 および 参照スキーマからの関係名 で、それぞれソーススキーマおよび参照スキーマのコンテキストの関係にわかりやすい名前を指定します。 終了したら、「適用」を選択して変更を確定し、関係を保存します。
キャンバスが再び表示され、関係フィールドが、以前に指定したわかりやすい名前でマークされます。 関係名も左側のパネルに表示され、簡単に参照できます。
参照スキーマの構造を表示すると、スキーマのプライマリ ID フィールドの横にある左側のパネルに関係マーカーが表示されます。
B2B スキーマ関係の編集 edit-schema-relationship
スキーマの関係が確立されたら、ソーススキーマの関係フィールドを選択してから、関係を編集 を選択します。
関係を編集 ダイアログが表示されます。 このダイアログから、参照スキーマと関係名を変更したり、関係を削除したりできます。 多対 1 関係タイプは変更できません。
データの整合性を維持し、セグメント化やその他のプロセスの中断を避けるために、リンクされたデータセットとのスキーマ関係を管理する際に、次のガイドラインを考慮してください。
- スキーマがデータセットに関連付けられている場合は、セグメント化に悪影響を及ぼす可能性があるので、関係を直接削除しないでください。 代わりに、関係を削除する前に、関連するデータセットを削除します。
- 最初に既存の関係を削除しないと、参照スキーマを変更できません。 ただし、関連するデータセットとの関係を削除すると、意図しない結果が生じる可能性があるので、慎重に行う必要があります。
- 既存のリンクされたデータセットを使用してスキーマに新しい関係を追加すると、意図したとおりに動作せず、競合が発生する可能性があります。
関係のフィルタリングと検索 filter-and-search
スキーマ ワークスペースの「 関係 」タブから、スキーマ内の特定の関係をフィルタリングして検索できます。 このビューを使用すると、関係をすばやく見つけて管理できます。 フィルタリングオプションの手順について詳しくは、 スキーマリソースの調査に関するドキュメントを参照してください。
次の手順
このチュートリアルでは、Schema Editor を使用して 2 つのスキーマ間に多対 1 の関係を正常に作成しました。 これらのスキーマに基づくデータセットを使用してデータが取り込まれ、そのデータがプロファイルデータストアでアクティブ化されると、 複数クラスのセグメント化のユースケースに対して両方のスキーマの属性を使用できます。