データ準備 UI ガイド

このドキュメントでは、Adobe Experience Platform ユーザーインターフェイスのデータ準備関数を使用して CSV ファイルを XDM スキーマにマッピングする方法について説明します。

はじめに

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

データフローの詳細

CSV データを XDM スキーマにマッピングする前に、まずデータフローの詳細を確立する必要があります。

このデータフローの詳細ページでは、CSV データを既存のターゲットデータセットに取り込むか、新しいターゲットデータセットに取り込むかを選択できます。既存のデータセットには、データのマッピング先となる事前定義済みのターゲットスキーマが付属していますが、新しいデータセットでは、データのマッピング先として既存のスキーマを選択するか、新しいスキーマを作成する必要があります。

既存のデータセットを使用する

CSV データを既存のデータセットに取り込むには、「既存のデータセット」を選択します。既存のデータセットは、「詳細検索」オプションを使用するか、ドロップダウンメニュー内の既存のデータセットのリストをスクロールして取得することができます。

データセットを選択し、データフローの名前と説明（オプション）を入力します。

このプロセスの間に、エラー診断および部分取り込みを有効にすることもできます。エラー診断は、データフローで発生するエラーレコードに対して、詳細なエラーメッセージ生成を有効にします。部分取り込みでは、手動で定義した特定のしきい値に到達するまで、エラーを含むデータを取り込むことができます。詳しくは、バッチ取り込みの概要を参照してください。

新しいターゲットデータセットを使用

CSV データを新しいデータセットに取り込むには、「新しいデータセット」を選択します。次に、出力データセット名とオプションの説明を入力します。次に、「詳細検索」オプションを使用するか、ドロップダウンメニュー内の既存のスキーマのリストをスクロールすることで、マッピングするスキーマを選択します。

スキーマを選択し、データフローの名前とオプションの説明を入力して、データフローのエラー診断および部分取り込みの設定を適用します。終了したら、「次へ」を選択します。

データを選択

データの選択手順が表示され、ローカルファイルをアップロードおよび構造と内容をプレビューするためのインターフェイスが表示されます。「ファイルを選択」をクリックして、ローカルシステムから CSV ファイルをアップロードします。または、アップロードする CSV ファイルをファイルをドラッグ＆ドロップパネルにドラッグ＆ドロップすることもできます。

ファイルがアップロードされると、プレビューインターフェイスが更新され、ファイルの内容と構造が表示されます。

ファイルに応じて、ソースデータの列区切り文字（タブ、コンマ、パイプ、カスタム列区切り文字など）を選択できます。区切り文字 ​ドロップダウン矢印をクリックし、メニューから適切な区切り文字を選択します。

終了したら、「次へ」を選択します。

マッピング

この​ マッピング ​インターフェイスには、ソーススキーマのソースフィールドを、ターゲットスキーマ内の適切なターゲット XDM フィールドにマッピングする包括的なツールが用意されています。

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

マッピングインターフェイスには、取り込みワークフローのコンテキスト内のマッピングフィールドの状態に関する情報を提供するダッシュボードが含まれます。ダッシュボードには、マッピングフィールドに関する次の詳細が表示されます。

また、マッピングインターフェイスには、インタラクションを向上したり、マッピングフィールドを通じてフィルタリングしたりするためのオプションのパネルも用意されています。

特定のマッピングセットを検索するには、検索ソースフィールド ​をクリックし、分離するソースデータの名前を入力します。

「すべてのソースフィールド」をクリックして、マッピングインターフェイスの表示をより細かく絞り込むためのフィルタリングオプションのドロップダウンメニューを表示します。

フィルタリングオプションは以下のとおりです。

エラーのあるフィールド ​をクリックすると、エラーが発生したすべてのマッピングフィールドが表示されます。

エラーが発生したマッピングフィールドが分離して表示され、インテリジェントマッピングレコメンデーションまたは手動マッピングツリーを使用してエラーに対処できます。

新しいフィールドタイプを追加

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

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

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

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

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

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

完了したら、スキーマアイコンを選択して、ターゲットスキーマインターフェイスを閉じます。

計算フィールド calculated-fields

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

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

計算フィールドの作成 パネルが表示されます。 左側のダイアログボックスには、計算フィールドでサポートされるフィールド、関数、演算子が含まれています。タブの 1 つを選択して、式エディターに関数、フィールドまたは演算子を追加します。

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

マッピングを読み込む import

既存のデータフローのマッピングを再利用して、データ取り込みの手動設定時間を短縮し、ミスを制限できます。 既存のマッピングを再利用するには、「マッピングを読み込み」を選択します。

​ マッピングをインポート ​ ウィンドウが開き、データフローのリストから選択できます。

プレビューアイコンを選択して、選択したデータフローのマッピングをプレビューします。

プレビューウィンドウでは、データフローに読み込む前に、既存のマッピングを調べることができます。 マッピングを検証したら、「戻る を選択してデータフローのリストに戻り、別のマッピングセットを調べるか、「選択 を選択して続行できます。

または、読み込むマッピングをデータフローウィンドウのリストから選択できます。 読み込むマッピングを含んだデータフローを選択し、「選択」をクリックして続行します。

読み込んだマッピングに応じてインターフェイスが更新されます。

「データをプレビュー」をクリックし、選択したデータセットから最大 100 行のサンプルデータのマッピング結果を確認します。

プレビュー中、ID 列はマッピング結果を検証する際に必要な重要情報なので、最初のフィールドとして優先されます。終了したら「閉じる」をクリックします。

すべてのマッピングフィールドを削除するには、「すべてのマッピングをクリア」を選択します。

マッピングインターフェイスの使用

Platform は、選択したターゲットスキーマまたはデータセットに基づいて、自動マッピングされたフィールドに対してインテリジェントなレコメンデーションを自動的に提供します。 マッピングルールをユースケースに合わせて手動で調整したり、重複したマッピングフィールドを修正してエラーをクリアしたりできます。

調整するターゲットフィールドの電球アイコンを選択します。

マッピングレコメンデーションポップアップパネルが開き、特定のソースフィールドにマッピングできる推奨ターゲットフィールドのリストが表示されます。デフォルトでは、最初のレコメンデーションが自動的に適用されます。

ソーススキーマに複数のレコメンデーションが使用できる場合があります。 これが発生すると、マッピングカードに最も目立つレコメンデーションが表示され、その後に使用可能なレコメンデーションの数を含むアイコンが表示されます。 電球アイコンを選択すると、追加のレコメンデーションのリストが表示されます。代わりに、マッピング先のレコメンデーションの横にあるチェックボックスをオンにして、代替レコメンデーションの 1 つを選択できます。

ここから、選択したターゲットフィールドを変更して、エラーを修正したり、ユースケースに合わせたりできます。

または、「手動で選択」をクリックして、インタラクティブターゲットスキーママッピングツリーを手動で使用できます。

ターゲットスキーママッピングインターフェイスは、マッピングフィールドと同じビューに表示され、同じ画面内でマッピングペアを変更できます。ユースケースに合うターゲットフィールドを選択するか、エラーを修正します。

終了したら、「完了」を選択して続行します。

次の手順

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