UIでのマップフィールドの定義

Adobe Experience Platformでは、カスタムエクスペリエンスデータモデル(XDM)クラス、スキーマフィールドグループ、データタイプの構造を完全にカスタマイズできます。

スキーマエディターでマップフィールドを定義して、柔軟で動的なキーを持つキーと値のペアのコレクションを保存することもできます。

Experience Platform ユーザーインターフェイス(UI)で新しいフィールドを定義する場合は、Type ドロップダウンを使用し、リストから「Map」を選択します。

​ タイプ ドロップダウンとマップ値がハイライト表示されたスキーマエディター。

​ マップ値の種類 プロパティが表示されます。 この値は、Mapのデータ型に必要です。 マップで使用できる値は文字列と整数です。 使用可能なオプションのドロップダウンリストから値を選択します。

値タイプ をマップするスキーマエディター ドロップダウンが強調表示されています。

サブフィールドを設定したら、フィールドグループに割り当てる必要があります。 フィールドグループ ドロップダウンメニューまたは検索フィールドを使用して、適用​を選択します。 同じプロセスを使用して引き続きオブジェクトにフィールドを追加するか、保存​を選択して設定を確認します。

​ フィールドグループの選択と設定の記録が適用されています。

使用制限 restrictions

XDMでは、このデータタイプの使用に次の制限を設けています。

  • マップタイプはobject型である必要があります。
  • マップタイプにはプロパティを定義しないでください(つまり、「空」オブジェクトを定義します)。
  • マップタイプには、マップ内に配置される値を説明するadditionalProperties.type フィールド(stringまたはinteger)を含める必要があります。
  • 複数エンティティのセグメンテーションは、マップキーに基づいてのみ定義でき、値は定義できません。
  • アカウントオーディエンスでは、マップはサポートされていません。
  • カスタム XDM オブジェクトで定義されたマップは、1つのレベルに制限されます。 ネストされたマップは作成できません。 この制限は、標準XDM オブジェクトで定義されたマップには適用されません。
  • マップの配列はサポートされていません。

次のパフォーマンス上の問題があるため、絶対に必要な場合にのみマップタイプフィールドを使用してください。

  • Adobe Experience Platform クエリサービス ​からの応答時間は、1億件のレコードに対して3秒から10秒に短縮されます。
  • マップのキー数は16個未満である必要があります。そうでない場合、さらに劣化するリスクがあります。
NOTE
Experience Platform UIには、マップタイプフィールドのキーを抽出する方法に制限があります。 オブジェクトタイプのフィールドは拡張できますが、マップは単一のフィールドとして表示されます。 Schema Registry APIを介して作成された、文字列または整数のデータタイプではないマップフィールドは、「複合」データタイプとして表示されます。

次の手順

このドキュメントでは、Experience Platform UIでマップフィールドを定義できるようになりました。 スキーマにフィールドを追加するには、クラスとフィールドグループのみを使用できます。 UIでこれらのリソースを管理する方法について詳しくは、​ クラス ​および​ フィールドグループ ​の作成と編集に関するガイドを参照してください。

​ スキーマ ​ ワークスペースの機能について詳しくは、​ スキーマ ​ ワークスペースの概要を参照してください。

recommendation-more-help
experience-platform-help-xdm