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

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 の関係を定義する手順を説明します。

はじめに

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

ソースおよび参照スキーマの定義

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

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

B2B の関係での ID について

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

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

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

商談スキーマ

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

Field Properties に示すように、このスキーマは Real-Time Customer Profile での使用が有効になっています。

Accounts スキーマ

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

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

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

関係フィールドを設定するには、キャンバス内で該当するフィールドを選択し、Add relationship のサイドバーで Schema properties を選択します。 Opportunities スキーマの場合、目標はアカウントとの多対 1 の関係を確立することなので、これは accountKey.sourceKey のフィールドになります。

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

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

「Relationship Name From Current Schema」および「Relationship Name From Reference Schema」で、ソーススキーマおよび参照スキーマのコンテキストで、それぞれ関係のわかりやすい名前を指定します。 終了したら、「Apply」を選択して変更を確定し、関係を保存します。

キャンバスが再び表示され、関係フィールドが、以前に指定したわかりやすい名前でマークされます。 関係名も左側のパネルに表示され、簡単に参照できます。

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

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

スキーマの関係が確立されたら、ソーススキーマの関係フィールドを選択してから、Edit relationship を選択します。

NOTE

関連するすべての関係を表示するには、参照スキーマのプライマリ ID フィールドを選択してから View relationships を選択します。
{width="100" modal="regular"}

Edit relationship ダイアログが表示されます。 このダイアログから、参照スキーマと関係名を変更したり、関係を削除したりできます。 多対 1 関係タイプは変更できません。

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

関係のフィルタリングと検索 filter-and-search

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

次の手順

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