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 スキーマ
ソーススキーマ「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 フィールドの横にある左側のパネルに関係マーカーが表示されます。
次の手順
このチュートリアルでは、Schema Editor を使用して 2 つのスキーマ間に多対 1 の関係を正常に作成しました。 これらのスキーマに基づくデータセットを使用してデータが取り込まれ、そのデータがプロファイルデータストアでアクティブ化されると、 複数クラスのセグメント化のユースケースに対して両方のスキーマの属性を使用できます。