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

このガイドでは、Adobe Experience Platform ユーザーインターフェイスでdata prep マッピング関数を使用して、CSV ファイルをExperience Data Model (XDM) スキーマ ​にマッピングする方法について説明します。

基本を学ぶ

このチュートリアルでは、次のExperience Platform コンポーネントについて理解する必要があります。

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

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

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

  • ​ ソース ​: Experience Platformを使用すると、様々なソースからデータを取り込むことができますが、Experience Platform サービスを使用して着信データを構造化、ラベル付け、強化することができます。

UIでのマッピングインターフェイスへのアクセス

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

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

XDM スキーマへのCSV ファイルのマッピング

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

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

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

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

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

次に、ヘッダーに記載されているオプションを使用して、マッピングフィールドの相互作用を強化したり、フィルタリングしたりできます。

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

すべてのフィールド」を選択して、マッピングをフィルタリングするオプションのドロップダウンメニューを表示します。 使用可能なフィルターオプションには、次のものがあります。

  • 必須フィールド: ワークフローを完了するために必要なフィールドのみを表示するようにインターフェイスをフィルタリングします。
  • ID フィールド: IDとしてマークされたフィールドのみを表示するように、インターフェイスをフィルタリングします。
  • マッピングされたフィールド: インターフェイスにフィルターを適用して、既にマッピングされたフィールドのみを表示します。
  • マッピングされていないフィールド: インターフェイスにフィルターを適用して、まだマッピングされていないフィールドのみを表示します。
  • エラーのあるフィールド: インターフェイスをフィルタリングして、エラーのあるフィールドのみを表示します。
新しいフィールドタイプ ​
新しいフィールドまたは計算フィールドを追加するには、新しいフィールドタイプ​を選択します。 詳しくは、新しいフィールドタイプの追加に関する節を参照してください。
​ マッピングの読み込み
既存のファイルまたはデータフローからマッピングを読み込むには、マッピングの読み込み​を選択します。 詳しくは、​ マッピングの読み込みの節を参照してください。
検証
検証」を選択して、マッピングのエラーを確認します。
​ テンプレートをダウンロード ​
マッピングのCSV ファイルを書き出してダウンロードするには、テンプレートをダウンロード​を選択します。
​ データのプレビュー
プレビューパネルを使用し、ソースデータセットの構造と内容を調べるには、データのプレビュー​を選択します。
すべてクリア ​
すべてをクリア」を選択して、インターフェイス内のすべてのマッピングを削除します。

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

新しいマッピングフィールドまたは計算フィールドを追加するには、新しいフィールドタイプ​を選択します。

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

新しいマッピングフィールドを追加するには、新しいフィールドタイプ​を選択し、表示されるドロップダウンメニューから​ 新しいフィールドを追加 ​を選択します。

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

次に、表示されるソーススキーマツリーから追加するソースフィールドを選択し、選択​を選択します。

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

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

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

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

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

計算フィールド calculated-fields

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

計算フィールドを作成するには、新しいフィールドタイプ​を選択し、計算フィールドを追加​を選択します

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

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

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

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

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

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

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

フローからマッピングをインポート

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

既存のデータフローからマッピングを読み込むには、マッピングの読み込み​を選択し、フローからのマッピングの読み込み​を選択します。

​ 「マッピングのインポート」と「フローからのマッピングのインポート」が選択されたマッピングインターフェイス。

次に、ポップアップウィンドウを使用して、マッピングをインポートするデータフローを見つけます。 この手順では、検索関数を使用して、特定のデータフローを分離し、そのマッピングを取得することもできます。 完了したら、選択​を選択します。

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

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

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

書き出したファイルからマッピングを読み込むには、「マッピングを読み込み」を選択し、「ファイルからマッピングを読み込み」を選択します。

​ 「マッピングをインポート」および「ファイルからマッピングをインポート」を選択したマッピングインターフェイス。

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

​ マッピングの書き出されたcsv ファイルのダウンロードとアップロードの両方を行うためのオプションを表示するアップロードテンプレートウィンドウ。

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

完了したら、ファイルをアップロード​を選択し、マッピングの更新されたcsv ファイルを選択します。 システムが処理する時間を少し待ってから、完了​を選択します。

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

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

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

完全なマッピング セットを含むマッピング インターフェイス。

次の手順

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

recommendation-more-help
experience-platform-help-data-prep