UI でのスキーマの作成と編集

このガイドでは、Adobe Experience Platform UI で組織の Experience Data Model(XDM) スキーマを作成、編集、管理する方法の概要を説明します。

前提条件

このガイドでは、XDM システムに関する十分な知識が必要です。 詳しくは、 XDM の概要 Experience Platformエコシステム内での XDM の役割、および スキーマ構成の基本 スキーマの構築方法の概要を示します。

新しいスキーマの作成

Adobe Analytics の スキーマ ワークスペース、選択 スキーマを作成 をクリックします。

The スキーマを作成 ワークフローが表示されます。 次のいずれかを選択して、スキーマの基本クラスを選択できます。 個々のプロファイル, エクスペリエンスイベント​または その他​に続いて 次へ をクリックして選択を確定します。 詳しくは、 XDM 個人プロファイル および XDM ExperienceEvent これらのクラスの詳細については、ドキュメントを参照してください。

クラスを選択すると、 名前とレビュー セクションが表示されます。 この節では、スキーマを識別する名前と説明を指定します。​キャンバスには、選択したクラスとスキーマ構造を確認できるように、スキーマの基本構造（クラスで提供）が表示されます。

人に優しいを入力 スキーマの表示名 」と入力します。 次に、スキーマを識別するのに役立つ適切な説明を入力します。 スキーマの構造を確認し、設定に満足したら、「 」を選択します。 完了 をクリックしてスキーマを作成します。

The スキーマ 参照 」タブが表示されます。 これで、最近作成したスキーマがスキーマライブラリに表示され、で編集できるようになります。 Schema Editor.

既存のスキーマの編集

既存のスキーマを編集するには、 参照 」タブをクリックし、編集するスキーマの名前を選択します。 検索バーを使用して、使用可能なオプションのリストを絞り込むこともできます。

スキーマを選択すると、 Schema Editor が表示され、スキーマの構造がキャンバスに表示されます。 次の操作を実行できます。 フィールドグループを追加 スキーマ ( または 個々のフィールドを追加 これらのグループから ) フィールドの表示名を編集または 既存のカスタムフィールドグループの編集 スキーマが適用する場合。

その他のアクション

スキーマエディター内で、スキーマの JSON 構造をコピーしたり、スキーマがリアルタイム顧客プロファイルに対して有効になっていない場合や関連するデータセットがある場合に、スキーマを削除したりするクイックアクションを実行できます。 選択 その他 をクイックアクション付きのドロップダウンを表示するには、ビューの上部に表示します。

「 JSON 構造をコピー」機能を使用すると、スキーマとデータパイプラインの構築中に、サンプルペイロードがどのように表示されるかを確認できます。 特に、ID マップなど、スキーマに複雑なオブジェクトマップ構造がある場合に役立ちます。

表示名の切り替え

スキーマエディターでは、利便性を考慮して、元のフィールド名と、人間が読み取り可能な表示名を切り替えることができます。 この柔軟性により、フィールドの検出性が向上し、スキーマを編集できます。切り替えは、スキーマエディタービューの右上にあります。

標準フィールドグループの表示名はシステムで生成されますが、カスタマイズは可能です ( 名前を表示 」セクションに入力します。 表示名は、マッピングやデータセットプレビューを含む複数の UI ビューに反映されます。 デフォルト設定はオフで、フィールド名が元の値で表示されます。

スキーマにフィールドグループを追加する

以下に示すように、 Schema Editorに値を入力する場合は、フィールドグループを使用してスキーマにフィールドを追加できます。 開始するには、「 追加 次の フィールドグループ をクリックします。

ダイアログが開き、スキーマ用に選択できるフィールドグループのリストが表示されます。 フィールドグループは 1 つのクラスとのみ互換性があるので、スキーマの選択されたクラスに関連付けられているフィールドグループのみが表示されます。 デフォルトでは、リストに表示されるフィールドグループは、組織内での使用頻度に基づいて並べ替えられます。

追加するフィールドの一般的なアクティビティまたはビジネス領域がわかっている場合は、左側のレールから業種別のカテゴリを 1 つ以上選択して、表示されるフィールドグループのリストをフィルタリングします。

また、検索バーを使用して、目的のフィールドグループを見つけることもできます。 クエリと名前が一致するフィールドグループがリストの上部に表示されます。 の下 標準フィールド、目的のデータ属性を記述するフィールドを含むフィールドグループが表示されます。

スキーマに追加するフィールドグループの名前の横にあるチェックボックスを選択します。 リストから複数のフィールドグループを選択できます。選択した各フィールドグループが右側のパネルに表示されます。

フィールドグループを選択したら、「 」を選択します。 フィールドグループを追加 をクリックして、スキーマに追加します。

The Schema Editor フィールドグループが指定したフィールドがキャンバスに表示された状態で再表示されます。

スキーマにフィールドグループを追加した後、オプションで 既存のフィールドを削除 または 新しいカスタムフィールドを追加 必要に応じて、これらのグループに追加します。

フィールドグループから追加されたフィールドを削除

スキーマにフィールドグループを追加した後、不要なフィールドを削除できます。

次の例では、標準フィールドグループ 人口統計の詳細 がスキーマに追加されました。 次のような単一のフィールドを削除するには taxIdをクリックし、キャンバスのフィールドを選択して、「 」を選択します。 削除 をクリックします。

削除するフィールドが複数ある場合は、フィールドグループ全体を管理できます。 キャンバスでグループに属するフィールドを選択し、「 」を選択します。 関連するフィールドの管理 をクリックします。

該当するフィールドグループの構造を示すダイアログが表示されます。 ここから、提供されたチェックボックスを使用して、必要なフィールドを選択または選択解除できます。 満足したら、「 」を選択します。 確認.

キャンバスが再び表示され、選択したフィールドのみがスキーマ構造に存在します。

フィールドグループにカスタムフィールドを追加する

スキーマにフィールドグループを追加した後、そのグループの追加フィールドを定義できます。 ただし、あるスキーマ内のフィールドグループに追加されたフィールドは、同じフィールドグループを使用する他のすべてのスキーマにも表示されます。

また、標準フィールドグループにカスタムフィールドを追加すると、そのフィールドグループはカスタムフィールドグループに変換され、元の標準フィールドグループは使用できなくなります。

標準フィールドグループにカスタムフィールドを追加する場合は、 以下の節 を参照してください。 カスタムフィールドグループにフィールドを追加する場合は、 カスタムフィールドグループの編集 」を参照してください。

既存のフィールドグループを変更しない場合は、 新しいカスタムフィールドグループを作成する を使用して、追加のフィールドを定義します。

スキーマへの個々のフィールドの追加

スキーマエディターを使用すると、特定の使用例に対してフィールドグループ全体が追加されるのを避けたい場合に、個々のフィールドを直接スキーマに追加できます。 以下が可能です。 標準フィールドグループから個々のフィールドを追加する または 独自のカスタムフィールドの追加 代わりに、

標準フィールドを追加

事前に対応するフィールドグループを把握しておく必要なく、標準フィールドグループのフィールドを直接スキーマに追加できます。 標準フィールドをスキーマに追加するには、プラス (+) アイコンをクリックします。 An 名称未設定フィールド プレースホルダーがスキーマ構造に表示され、右側のレールが更新されて、フィールドを設定するコントロールが表示されます。

の下 フィールド名​をクリックし、追加するフィールドの名前を入力します。 クエリに一致する標準フィールドが自動的に検索され、以下にリストされます。 推奨される標準フィールド（所属するフィールドグループを含む）

一部の標準フィールドは同じ名前を共有しますが、構造は、その標準フィールドの元のフィールドグループによって異なる場合があります。 標準フィールドがフィールドグループ構造内の親オブジェクト内にネストされている場合、子フィールドが追加されると、親フィールドもスキーマに含まれます。

プレビューアイコン () をクリックし、標準フィールドの横に表示されます。 標準フィールドをスキーマに追加するには、プラスアイコン () をクリックします。

キャンバスが更新され、フィールドグループ構造内でネストされている親フィールドを含む、スキーマに追加された標準フィールドが表示されます。 フィールドグループの名前も、以下に表示されます。 フィールドグループ をクリックします。 同じフィールドグループからさらにフィールドを追加する場合は、 関連するフィールドの管理 をクリックします。

カスタムフィールドの追加

標準フィールドのワークフローと同様に、独自のカスタムフィールドを直接スキーマに追加することもできます。

スキーマのルートレベルにフィールドを追加するには、プラス (+) アイコンをクリックします。 An 名称未設定フィールド プレースホルダーがスキーマ構造に表示され、右側のレールが更新されて、フィールドを設定するコントロールが表示されます。

追加するフィールドの名前を入力すると、一致する標準フィールドの検索が自動的に開始されます。 代わりに新しいカスタムフィールドを作成するには、 (新しいフィールド).

フィールドに表示名とデータ型を指定した後、次の手順では、フィールドを親 XDM リソースに割り当てます。 スキーマでカスタムクラスを使用する場合は、 割り当てられたクラスにフィールドを追加 または フィールドグループ 代わりに、 ただし、スキーマで標準クラスを使用する場合、カスタムフィールドをフィールドグループに割り当てることのみ可能です。

フィールドをカスタムフィールドグループに割り当てる

の下 割り当て先​を選択します。 フィールドグループ. スキーマで標準のクラスを使用する場合、これは唯一の使用可能なオプションで、デフォルトで選択されます。

次に、新しいフィールドを関連付けるフィールドグループを選択する必要があります。 指定したテキスト入力でフィールドグループの名前を入力します。 入力に一致する既存のカスタムフィールドグループがある場合は、それらはドロップダウンリストに表示されます。 または、一意の名前を入力して新しいフィールドグループを作成することもできます。

リストからフィールドグループを選択した後、「 」を選択します。 適用.

新しいフィールドがキャンバスに追加され、ユーザーの下に名前空間が付けられます テナント ID 標準 XDM フィールドとの競合を避けるために使用します。 新しいフィールドを関連付けたフィールドグループも、の下に表示されます。 フィールドグループ をクリックします。

フィールドをカスタムクラスに割り当てる

の下 割り当て先​を選択します。 クラス. 以下の入力フィールドは、現在のスキーマのカスタムクラスの名前に置き換えられ、新しいフィールドがこのクラスに割り当てられることを示します。

必要に応じてフィールドの設定を続行し、「 」を選択します。 適用 終了したとき。

新しいフィールドがキャンバスに追加され、ユーザーの下に名前空間が付けられます テナント ID 標準 XDM フィールドとの競合を避けるために使用します。 左側のレールでクラス名を選択すると、新しいフィールドがクラスの構造の一部として表示されます。

標準フィールドグループの構造にカスタムフィールドを追加する

作業中のスキーマに、標準フィールドグループによって提供されるオブジェクトタイプのフィールドがある場合、独自のカスタムフィールドをその標準オブジェクトに追加できます。

開始するには、プラス (+) アイコンをクリックし、標準フィールドグループで提供されるオブジェクトのルートの横に表示されます。

標準フィールドグループを変換するかどうかを確認する警告メッセージが表示されます。 選択 引き続きフィールドグループを作成します をクリックして続行します。

キャンバスが再び表示され、新しいフィールド用の名称未設定のプレースホルダーが表示されます。 標準フィールドグループの名前には、拡張)」という名前に変更され、元のバージョンから変更されたことを示します。 ここから、右側のレールのコントロールを使用して、フィールドのプロパティを定義します。

変更を適用すると、新しいフィールドが標準オブジェクト内のテナント ID 名前空間の下に表示されます。 このネストされた名前空間は、同じフィールドグループを使用する他のスキーマでの変更が壊れるのを防ぐために、フィールドグループ内のフィールド名の競合を防ぎます。

リアルタイム顧客プロファイルのスキーマを有効にする

リアルタイム顧客プロファイル 異なるソースのデータを結合して、各顧客の完全なビューを構築します。 スキーマによって取得されたデータをこのプロセスに参加させる場合は、で使用するスキーマを有効にする必要があります。 Profile.

スキーマを有効にするには、まず左側のパネルでスキーマの名前を選択してから、 プロファイル 右側のパネルを切り替えます。

スキーマを有効にして保存すると、無効にできなくなることを警告するポップオーバーが表示されます。 選択 有効にする をクリックして続行します。

キャンバスが再び表示され、 プロファイル オン/オフを切り替えます。

処理を終了するには、「 」を選択します。 保存 スキーマを保存します。

これで、スキーマがリアルタイム顧客プロファイルで使用できるようになります。 Platform がこのスキーマに基づいてデータをデータセットに取り込むと、そのデータは統合プロファイルデータに取り込まれます。

スキーマフィールドの表示名を編集

クラスを割り当て、フィールドグループをスキーマに追加したら、標準の XDM リソースで提供されているかカスタム XDM リソースで提供されているかに関係なく、スキーマのフィールドの表示名を編集できます。

スキーマフィールドの表示名を編集するには、キャンバスでフィールドを選択します。 右側のレールで、の下に新しい名前を入力します。 表示名.

選択 適用 右側のレールで、キャンバスが更新されて、フィールドの新しい表示名が表示されます。 選択 保存 をクリックして、変更をスキーマに適用します。

スキーマのクラスの変更

スキーマが保存される前の初期作成プロセス中の任意の時点で、スキーマのクラスを変更できます。

クラスを再割り当てするには、 割り当て をクリックします。

組織で定義されたクラス（所有者は「 」）を含む、使用可能なすべてのクラスのリストを表示するダイアログが表示されます顧客") と、Adobeで定義された標準クラス。

リストからクラスを選択し、ダイアログの右側に説明を表示します。 また、 クラス構造をプレビュー をクリックして、クラスに関連付けられているフィールドとメタデータを確認します。 選択 クラスを割り当て をクリックして続行します。

新しいクラスを割り当てるかどうかを確認する新しいダイアログが開きます。 選択 割り当て をクリックして確定します。

クラスの変更を確認した後、キャンバスがリセットされ、構成の進行状況がすべて失われます。

次の手順

このドキュメントでは、Platform UI でのスキーマの作成と編集の基本について説明します。 次の項目を確認することを強くお勧めします。 スキーマ作成チュートリアル :UI で完全なスキーマを構築するための包括的なワークフロー。一意の使用例のカスタムフィールドグループとデータタイプの作成を含みます。

の機能の詳細については、 スキーマ ワークスペースについては、 スキーマ workspace の概要.

でスキーマを管理する方法については、以下を参照してください。 Schema Registry API( スキーマエンドポイントガイド.