ドキュメント Experience Platform エクスペリエンスデータモデル（XDM）ガイド

Schema Editor を使用した 2 つのスキーマ間における 1 対 1 の関係を定義 relationship-ui

Last update: Tue Sep 24 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者

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

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

NOTE

ソースおよび宛先スキーマの両方が同じクラスに属する場合は、専用の関係フィールドを 使用しない でください。この場合は、和集合スキーマ UI を使用して関係を確認します。これを行う方法については、結合スキーマ UI ガイドの関係を表示の節を参照してください。

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

NOTE

Adobe Real-time Customer Data Platform B2B Edition で多対 1 の関係を作成する手順については、B2B の関係の作成に関するガイドを参照してください。

はじめに

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

Experience Platformにおける XDM システム:XDM と Experience Platform での実装の概要です。
スキーマ構成の基本：XDM スキーマの構築ブロックの紹介。
を使用したスキーマの作成 Schema Editor：ス Schema Editor ーマの操作の基本を説明するチュートリアル。

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

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

IMPORTANT

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

スキーマ関係は、参照スキーマ 内の別のフィールドを指す ソーススキーマ 内の専用フィールドで表されます。以下の手順では、「Loyalty Members」がソーススキーマになり、「Hotels」が参照スキーマとして機能します。

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

Loyalty Members スキーマ

ソーススキーマ「Loyalty Members」は、XDM Individual Profile クラスに基づいており、これには、ロイヤルティプログラムのメンバーを記述するフィールドが含まれています。これらのフィールドの 1 つである personalEmail.addess は、メール名前空間の下でスキーマのプライマリ ID として機能します。 スキーマプロパティ に示すように、このスキーマは Real-Time Customer Profile での使用が有効になっています。

Hotels スキーマ

参照スキーマ「Hotels」は、カスタム「Hotels」クラスに基づいており、ホテルを説明するフィールドを含んでいます。関係に参加するには、参照スキーマにプライマリ ID も定義され、プロファイルに対して有効になっている必要があります。この場合、は _tenantId.hotelId カスタムの「Hotel ID」 ID 名前空間を使用して、スキーマのプライマリ ID として機能します。

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

NOTE

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

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

NOTE

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

2 つのスキーマ間の関係を定義するには、ソーススキーマに、参照スキーマのプライマリ ID を示す専用フィールドが必要です。このフィールドをソーススキーマに追加するには、新しいスキーマフィールドグループを作成するか、既存のスキーマフィールドグループを拡張します。

Loyalty Members スキーマの場合、新しい preferredHotel フィールドが追加され、企業訪問に対するロイヤルティメンバーの優先ホテルを示します。まず、ソーススキーマ名の横にあるプラスアイコン（+）を選択します。

新規フィールドプレースホルダーがキャンバスに表示されます。「フィールドプロパティ」で、フィールド名とフィールドの表示名を指定し、タイプを「文字列」に設定します。「割り当て先」で、拡張する既存のフィールドグループを選択するか、一意の名前を入力して新しいフィールドグループを作成します。この場合、新しい「Preferred Hotel」フィールドグループが作成されます。