データ準備 UI ガイド

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

はじめに

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

計算フィールド calculated-fields

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

accordion
選択すると、書き出されたマッピングファイルの例が表示されます
ダウンロードしたマッピングテンプレートの CSV ファイル。

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

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

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

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

次の手順

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

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