Schema Editor

メモ

Real-time Customer Data Platform B2B Edition を使用している場合は、代わりに B2B の関係の作成 に関するガイドを参照してください。

様々なチャネルでの顧客とブランドとの関係を理解する能力は、Adobe Experience Platform の重要な部分です。Experience Data Model (XDM) スキーマの構造内でこれらの関係を定義すると、顧客データに関する複雑なインサイトを得ることができます。

和集合スキーマと Real-time Customer Profile を使用してスキーマの関係を推論することはできますが、これは同じクラスを共有するスキーマにのみ当てはまります。 異なるクラスに属する 2 つのスキーマ間の関係を確立するには、宛先スキーマの ID を参照するソーススキーマに、専用の関係フィールドを追加する必要があります。

このドキュメントでは、Experience Platform ユーザーインターフェイスのスキーマエディターを使用して、2 つのスキーマ間の関係を定義するためのチュートリアルを提供します。 API を使用してスキーマ関係を定義する手順については、スキーマレジストリ API を使用した関係の定義についてのチュートリアルを参照してください。

はじめに

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

ソースと宛先のスキーマの定義

この関係で定義される 2 つのスキーマが既に作成されていると想定されます。このチュートリアルでは、デモ目的で、組織のロイヤルティプログラム(「Loyalty Members」スキーマで定義)のメンバーと、お気に入りのホテル(「Hotels」スキーマで定義)との間に関係を作成します。

重要

関係を確立するには、両方のスキーマでプライマリ ID が定義され、Real-time Customer Profile に対して有効になっている必要があります。 スキーマを適切に設定する方法に関するガイダンスが必要な場合は、『スキーマ作成チュートリアル』の「プロファイル 🔗 でのスキーマの使用の有効化 」の節を参照してください。

スキーマの関係は、ソーススキーマ 内の専用のフィールドで表され、宛先スキーマ 内の別のフィールドを参照します。 次の手順では、「Loyalty Members」がソーススキーマで、「Hotels」が宛先スキーマです。

以下の節では、関係が定義される前に、このチュートリアルで使用する各スキーマの構造について説明します。

Loyalty Members schema

ソーススキーマ「Loyalty Members」は XDM Individual Profile クラスに基づいており、UI でのスキーマの作成 に関するチュートリアルで構築されたスキーマです。 _tenantId 名前空間の下に loyalty オブジェクトが含まれ、この中に複数のロイヤルティ固有のフィールドが含まれます。 これらのフィールドの 1 つ loyaltyId は、Email 名前空間の下のスキーマのプライマリ ID として機能します。 スキーマのプロパティ で見たように、このスキーマは Real-time Customer Profile で使用できるようになっています。

Hotels スキーマ

宛先スキーマ「Hotels」は、カスタムの「Hotels」クラスに基づいており、ホテルを説明するフィールドが含まれています。

関係に参加するには、宛先スキーマにプライマリ ID が必要です。 この例では、 hotelId フィールドは、カスタムの「Hotel ID」ID 名前空間を使用して、プライマリ ID として使用されます。

ホテルの主要 ID

メモ

カスタム ID 名前空間の作成方法については、ID サービスのドキュメント を参照してください。

プライマリ ID が設定されたら、宛先スキーマを Real-time Customer Profile に対して有効にする必要があります。

プロファイルに対して有効

関係スキーマフィールドグループの作成

メモ

この手順は、ソーススキーマに、宛先スキーマへの参照として使用する専用の文字列型フィールドがない場合にのみ必要です。 このフィールドがソーススキーマで既に定義されている場合は、次の関係フィールドを定義する手順に進んでください。

2 つのスキーマ間の関係を定義するには、ソーススキーマに、ターゲットスキーマへの参照として使用する専用のフィールドが必要です。新しいスキーマフィールドグループを作成して、このフィールドをソーススキーマに追加できます。

まず、「フィールドグループ」セクションで「追加」を選択します。

フィールドグループを追加 ダイアログが表示されます。 ここから、「新しいフィールドグループを作成」を選択します。 表示されるテキストフィールドに、新しいフィールドグループの表示名と説明を入力します。 終了したら「フィールドグループを追加」を選択します。

キャンバスが再び表示され、 フィールドグループ セクションに「Favorite Hotel」が表示されます。 フィールドグループ名を選択し、ルートレベルの Loyalty Members フィールドの横にある「フィールドを追加」を選択します。

キャンバスの _tenantId 名前空間の下に新しいフィールドが表示されます。 フィールドのプロパティ で、フィールドの名前と表示名を指定し、型を「String」に設定します。

終了したら、「適用」を選択します。

更新された favoriteHotel フィールドがキャンバスに表示されます。 「保存」を選択して、変更をスキーマに確定します。

ソーススキーマでの関係フィールドの定義

ソーススキーマに専用の参照フィールドが定義されたら、それを関係フィールドとして指定できます。

キャンバスで favoriteHotel フィールドを選択し、「フィールドのプロパティ」の下で「関係」チェックボックスが表示されるまで下にスクロールします。 このチェックボックスを選択すると、関係フィールドを設定するために必要なパラメーターが表示されます。

参照スキーマ」のドロップダウンを選択し、関係の宛先スキーマを選択します(この例では「Hotels」)。 宛先スキーマが Profile に対して有効になっている場合、「参照 ID 名前空間」フィールドは、宛先スキーマのプライマリ ID の名前空間に自動的に設定されます。 スキーマにプライマリ ID が定義されていない場合は、使用する名前空間をドロップダウンメニューから手動で選択する必要があります。終了したら「適用」を選択します。

favoriteHotel 」フィールドがキャンバス内で関係としてハイライトされ、宛先スキーマの名前と参照 ID 名前空間が表示されます。 「保存」を選択して変更を保存し、ワークフローを完了します。

次の手順

このチュートリアルでは、Schema Editor を使用して 2 つのスキーマ間に 1 対 1 の関係を作成しました。 API を使用して関係を定義する手順については、スキーマレジストリ API を使用した関係の定義についてのチュートリアルを参照してください。

このページ