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

このガイドでは、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