ドキュメントExperience PlatformData Prep ガイド

データ準備 UI ガイド data-prep-ui-guide

Last update: Sat Mar 07 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 開発者

このガイドでは、Adobe Experience Platform ユーザーインターフェイスの ​ データ準備 ​ マッピング機能を使用して、CSV ファイルを ​ エクスペリエンスデータモデル（XDM）スキーマ ​ にマッピングする方法について説明します。

基本を学ぶ

このチュートリアルでは、次のExperience Platform コンポーネントに関する十分な知識が必要です。

  • Experience Data Model (XDM) システム：Experience Platform が顧客体験データの整理に使用する標準化されたフレームワーク。

  • ID サービス：デバイスやシステム間で ID を関連付けることで、個々の顧客とその行動への理解を深めることができます。

  • Real-Time Customer Profile：複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。

  • ​ ソース ​:Experience Platformを使用すると、データを様々なソースから取得しながら、Experience Platform サービスを使用して受信データの構造化、ラベル付け、拡張を行うことができます。

UI でマッピングインターフェイスにアクセスする

UI では、2 つの異なるパスからマッピングインターフェイスにアクセスできます。

  1. Experience Platform UI で、左側のナビゲーションから「Workflows」を選択し、「Map CSV to XDM schema」を選択します。 次に、データフローの詳細を入力し、取り込むデータを選択します。 完了すると、マッピングインターフェイスに移動し、ソースデータと XDM スキーマ間のマッピングを設定できます。
  2. ソースワークスペースからマッピングインターフェイスにアクセスすることもできます。

CSV ファイルを XDM スキーマにマッピングする

マッピングインターフェイスと、それが提供する包括的なツールセットを使用して、ソーススキーマのデータフィールドを、ターゲットスキーマ内の適切なターゲット XDM フィールドに正常にマッピングします。

Experience Platform UI のマッピングインターフェイス

マッピングインターフェイスについて mapping-interface

取り込みワークフローのコンテキスト内のマッピングフィールドの正常性については、インターフェイスの上部にあるダッシュボードを参照してください。 ダッシュボードには、マッピングフィールドに関する次の詳細が表示されます。

プロパティ
説明
Mapped fields
エラーに関係なく、ターゲット XDM フィールドにマッピングされたソースフィールドの合計数を表示します。
Required fields
必須マッピングフィールドの数を表示します。
Identity fields
ID として定義されたマッピングフィールドの合計数を表示します。 これらのマッピングフィールドは、フィンガープリントアイコンで表されます。
Errors
エラーが発生したマッピングフィールドの数を表示します。

次に、ヘッダーにリストされたオプションを使用して、マッピングフィールドの操作やフィルタリングを改善できます。

オプション
説明
Search source fields
検索バーを使用して、特定のソースフィールドに移動します。
All fields

「All fields」を選択すると、マッピングをフィルタリングするためのオプションのドロップダウンメニューが表示されます。 使用可能なフィルタリングオプションを次に示します。

  • Required fields：ワークフローの完了に必要なフィールドのみを表示するようにインターフェイスをフィルタリングします。
  • Identity fields:ID としてマークされたフィールドのみを表示するようにインターフェイスをフィルタリングします。
  • Mapped fields：既にマッピングされているフィールドのみを表示するようにインターフェイスをフィルタリングします。
  • Unmapped fields：まだマッピングされていないフィールドのみを表示するようにインターフェイスをフィルタリングします。
  • Fields with errors: インターフェイスをフィルタリングして、エラーのあるフィールドのみを表示します。
New field type
新しいフィールドまたは計算フィールドを追加するには、「New field type」を選択します。 詳しくは、​ 新しいフィールドタイプの追加 ​ の節を参照してください。
Import mappings
既存のファイルまたはデータフローからマッピングをインポートするには、「Import mappings」を選択します。 詳しくは、​ マッピングのインポート ​ の節を参照してください。
Validate
「Validate」を選択すると、マッピングのエラーを確認できます。
Download template
「Download template」を選択して、マッピングの CSV ファイルを書き出し、ダウンロードします。
Preview data
「Preview data」を選択してプレビューパネルを使用し、ソースデータセットの構造と内容を調べます。
Clear all
Clear all を選択すると、インターフェイス内のすべてのマッピングが削除されます。

新しいフィールドタイプを追加 add-a-new-field-type

新しいマッピングフィールドまたは計算フィールドを選択して追加 New field type きます。

新しいマッピングフィールド

新しいマッピングフィールドを追加するには、「New field type」を選択した後、表示されるドロップダウンメニューから「Add new field」を選択します。

「新しいフィールドを追加」ボタンを選択したマッピングインターフェイス

次に、表示されるソーススキーマツリーから追加するソースフィールドをクリックし、「Select」をクリックします。

追加の新しいフィールドとして「国」が選択されているソーススキーマ

マッピングインターフェイスは、選択したソースフィールドと空のターゲットフィールドを使用して更新されます。 「Map target field」を選択して、新しいソースフィールドの適切なターゲット XDM フィールドへのマッピングを開始します。

新しいソースフィールドと、マッピングされていないソースフィールドを持つマッピングインターフェイス。

インタラクティブなターゲットスキーマツリーが表示され、ターゲットスキーマを手動でトラバースして、ソースフィールドに適したターゲット XDM フィールドを見つけることができます。

新しいターゲットフィールドが選択されたインタラクティブターゲットスキームツリー

計算フィールド calculated-fields

計算フィールドでは、入力スキーマの属性に基づいて値を作成できます。 これらの値をターゲットスキーマの属性に割り当て、名前と説明を指定して参照を容易にできます。計算フィールドの最大長は 4096 文字です。

計算フィールドを作成するには、「New field type」を選択してから「Add calculated field」を選択します。

「計算フィールドを追加」ボタンを選択したマッピングインターフェイス

Create calculated field ウィンドウが表示されます。 インターフェイスを使用して計算フィールドを入力し、サポートされるフィールド、関数、演算子については、左側のダイアログボックスを参照してください。

タブ
説明
Function
「関数」タブには、データの変換に使用できる関数が一覧表示されます。計算フィールド内で使用できる関数の詳細については、 データ準備（マッパー）関数の使用 に関するガイドを参照してください。
Field
「フィールド」タブには、ソーススキーマで使用できるフィールドと属性が表示されます。
Operator
「演算子」タブには、データの変換に使用できる演算子が一覧表示されます。

計算フィールドインターフェイス

中央にある式エディターを使用して、フィールド、関数、演算子を手動で追加できます。 式の作成を開始するには、エディターを選択します。完了したら、「Save」を選択して続行します。

マッピングを読み込む import-mapping

データ準備の読み込みマッピング機能を使用すると、データ取り込みプロセスの手動による設定時間を短縮し、ミスを制限できます。 マッピングは、既存のフローまたは書き出されたファイルから読み込むことができます。

フローからマッピングを読み込む

類似のソースファイルとターゲットスキーマに基づく複数のデータフローがある場合は、既存のマッピングを読み込んで、新しいデータフローに再利用できます。

既存のデータフローからマッピングを読み込むには、「Import mappings」を選択してから「Import mapping from flow」を選択します。

「マッピングを読み込み」および「フローからマッピングを読み込み」が選択されているマッピングインターフェイス

次に、ポップアップウィンドウを使用して、マッピングを読み込むデータフローを見つけます。 この手順では、検索機能を使用して特定のデータフローを分離し、そのマッピングを取得することもできます。 終了したら「Select」を選択します。

対応するマッピングをインポートできる既存のデータフローのリスト。

ファイルからマッピングを読み込み

場合によっては、データに対して多数のマッピングを実装する必要があります。 この作業はマッピングインターフェイスを使用して手動で行うことができますが、マッピングテンプレートを書き出してオフラインのスプレッドシートでマッピングを設定することで時間を節約し、Experience Platformでのユーザーのタイムアウトを回避することもできます。

書き出されたファイルからマッピングを読み込むには、「Import mappings」を選択してから「Import mapping from file」を選択します。

「マッピングを読み込み」および「ファイルからマッピングを読み込み」が選択されているマッピングインターフェイス

次に、Upload template のウィンドウを使用して、マッピングの CSV コピーをダウンロードします。 その後、CSV ファイルタイプの編集をサポートするソフトウェアを使用して、デバイス上でローカルにマッピングを設定できます。 この手順では、ソースファイルとターゲットスキーマで提供されるフィールドのみを使用していることを確認する必要があります。

書き出したマッピングの csv ファイルをダウンロードおよびアップロードするためのオプションを表示するアップロードテンプレートウィンドウ。

accordion
エクスポートされたマッピング ファイルの例を表示する場合に選択します
ダウンロードしたマッピングテンプレートの CSV ファイル。

終了したら、「Upload file」を選択し、マッピングの更新された csv ファイルを選択します。 システムが処理するまで少し待ってから、「Done」を選択します。

新しいファイルがアップロードされたアップロードテンプレートウィンドウ。

マッピングが完了したら、「Finish」を選択し、次の手順に進んでデータフローを完了できます。

TIP
マッピングの作成が完了したら、データ取り込みを開始する前に最大 10 分待ちます。 この待機期間により、新しいマッピングが完全に保存され、システムで使用できるようになります。

完全なマッピングセットを使用したマッピングインターフェイス

次の手順

Experience Platform UI のマッピングインターフェイスを使用して、CSV ファイルをターゲット XDM スキーマに正常にマッピングできるようになりました。 詳しくは、次のドキュメントを参照してください。

recommendation-more-help
461cc884-c234-4a0c-ac75-6efbaafc1394