[B2B edition]{class="badge informative"}

Real-time Customer Data Platform B2B エディションでの 2 つのスキーマ間における多対 1 の関係を定義 relationship-b2b

Adobe Real-Time Customer Data Platform B2B editionには、accounts、opportunities、​ キャンペーン ​など、基本的なB2B データエンティティをキャプチャするExperience Data Model （XDM）クラスがいくつか用意されています。 これらのクラスに基づいてスキーマを構築し、Real-Time Customer Profileで使用できるようにすることで、異なるソースからのデータを結合スキーマと呼ばれる統合表現に結合できます。

ただし、結合スキーマには、同じクラスを共有するスキーマによってキャプチャされたフィールドのみを含めることができます。 そこで、スキーマ関係の出番です。 B2B スキーマに関係を実装することで、これらのビジネスエンティティの相互関係を記述でき、下流のセグメンテーションのユースケースに複数のクラスの属性を含めることができます。

次の図は、基本的な実装において、異なるB2B クラスが互いにどのように関連付けられるかを示す例です。

このチュートリアルでは、Real-Time CDP B2B editionで2つのスキーマ間の多対一のリレーションシップを定義する手順について説明します。

はじめに

このチュートリアルでは、XDM SystemとExperience Platform UIのスキーマエディターに関する実務的な理解が必要です。 このチュートリアルを始める前に、次のドキュメントを確認してください。

ソースと参照スキーマの定義

この関係で定義される 2 つのスキーマが既に作成されていると想定されます。 デモ用に、ビジネスオポチュニティ（「Opportunities」スキーマで定義）と関連するビジネスアカウント（「Accounts」スキーマで定義）の関係を作成します。

スキーマ関係は、参照スキーマ​のプライマリ ID フィールドを参照する​ ソーススキーマ ​内の専用フィールドで表されます。 次の手順では、「Opportunities」がソーススキーマとして機能し、「Accounts」が参照スキーマとして機能します。

B2B の関係での ID について

関係を確立するには、参照スキーマに定義されたプライマリ IDが必要です。 B2B エンティティのプライマリ IDを設定する場合、文字列ベースのエンティティ IDは、異なるシステムまたは場所で収集している場合に重複する可能性があることに注意してください。これにより、Experience Platformでデータが競合する可能性があります。

このため、すべての標準B2B クラスには、B2B Source データ型に準拠する「キー」フィールドが含まれています。 このデータタイプは、B2B エンティティの文字列識別子のフィールドと、識別子のソースに関するその他のコンテキスト情報を提供します。 これらのフィールドの1つであるsourceKeyは、データ型の他のフィールドの値を連結して、エンティティの完全に一意の識別子を生成します。 このフィールドは、常にB2B エンティティスキーマのプライマリ IDとして使用する必要があります。

参照目的で、次の節では、関係が定義される前に、このチュートリアルで使用する各スキーマの構造について説明します。 スキーマ構造でプライマリ IDが定義されている場所と、それらが使用するカスタム名前空間に注意してください。

商談スキーマ

ソーススキーマ「Opportunities」は、XDM Business Opportunity クラスに基づいています。 クラスによって提供されるフィールドの1つであるopportunityKeyは、スキーマの識別子として機能します。 具体的には、opportunityKey オブジェクトの下のsourceKey フィールドは、B2B Opportunityというカスタム名前空間の下のスキーマのプライマリ IDとして設定されます。

フィールドのプロパティ​で見られるように、このスキーマはReal-Time Customer Profileで使用できるように有効になっています。

Accounts スキーマ

参照スキーマ「Accounts」は、XDM アカウント ​ クラスに基づいています。 ルートレベル accountKey フィールドには、B2B Accountというカスタム名前空間の下でプライマリ IDとして機能するsourceKeyが含まれています。 このスキーマは、プロファイルでの使用にも有効になっています。

ソーススキーマで関係フィールドを定義 relationship-field

2つのスキーマ間の関係を定義するには、ソーススキーマに、参照スキーマのプライマリ IDを示す専用フィールドが必要です。 標準のB2B クラスには、一般的に関連するビジネスエンティティの専用のソースキーフィールドが含まれています。 例えば、XDM Business Opportunity クラスには、関連アカウント （accountKey）および関連キャンペーン （campaignKey）のソースキーフィールドが含まれています。 ただし、デフォルトのコンポーネントを超える必要がある場合は、カスタムフィールドグループを使用して、他のB2B Source フィールドをスキーマに追加することもできます。

関係フィールドを設定するには、キャンバス内で問題のフィールドを選択し、​ スキーマプロパティ ​ サイドバーで​ 関係を追加 ​します。 Opportunities スキーマの場合、アカウントとの多対一の関係を確立することが目標であるため、これはaccountKey.sourceKey フィールドです。

関係を追加 ダイアログが表示されます。 このダイアログを使用して、関係の詳細を指定します。 関係タイプは、デフォルトで​ Many-to-one ​に設定されています。

参照スキーマ​で、検索バーまたはドロップダウンメニューを使用して、参照スキーマの名前を検索します。 参照スキーマの名前を強調表示すると、参照ID名前空間 フィールドが、参照スキーマのプライマリ IDの名前空間に自動的に更新されます。

現在のスキーマからのリレーションシップ名​および​ 参照スキーマからのリレーションシップ名 ​の下で、ソーススキーマと参照スキーマのコンテキストでのわかりやすいリレーションシップ名をそれぞれ指定します。 完了したら、適用​を選択して変更を確認し、関係を保存します。

キャンバスが再び表示され、先ほど指定したわかりやすい名前がリレーションシップフィールドにマークされるようになりました。 リレーションシップ名は、簡単に参照できるように、左側のレールにも表示されます。

参照スキーマの構造を表示すると、関係マーカーはスキーマのプライマリ ID フィールドの横および左側のパネルに表示されます。

B2B スキーマ関係の編集 edit-schema-relationship

スキーマ関係が確立されたら、ソーススキーマの関係フィールドを選択し、続いて​ 関係を編集 ​します。

関係を編集 ダイアログが表示されます。 このダイアログから、参照スキーマとリレーションシップ名を変更したり、リレーションシップを削除したりできます。 多対一の関係タイプは変更できません。

データの整合性を維持し、セグメンテーションやその他のプロセスの中断を回避するには、リンクされたデータセットとのスキーマ関係を管理する際に、次のガイドラインを検討してください。

関係のフィルターと検索 filter-and-search

​ スキーマ ​ ワークスペースの「関係」タブから、スキーマ内の特定の関係をフィルタリングして検索できます。 このビューを使用すると、関係をすばやく検索して管理できます。 フィルターオプションの詳細な手順については、​ スキーマリソースの探索に関するドキュメントを参照してください。

次の手順

このチュートリアルに従うことで、Schema Editorを使用して2つのスキーマ間の多対一の関係を正常に作成しました。 これらのスキーマに基づくデータセットを使用してデータが取り込まれ、そのデータがプロファイルデータストアでアクティベートされると、両方のスキーマの属性を​ マルチクラスのセグメンテーションユースケース ​に使用できます。