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

NOTE
このドキュメントでは、既存の XDM スキーマに CSV ファイルをマッピングする方法について説明します。 AI 生成のスキーマレコメンデーションツール(現在はベータ版)の使用方法について詳しくは、機械学習のレコメンデーションを使用した CSV ファイルのマッピングを参照してください。

CSV データを Adobe Experience Platform に取り込むには、データを Experience Data Model(XDM)スキーマにマッピングする必要があります。 このチュートリアルでは、Experience Platform ユーザーインターフェイスを使用して、CSV ファイルを XDM スキーマにマッピングする方法について説明します。

はじめに

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

  • Experience Data Model (XDM System):Experience Platform が、カスタマーエクスペリエンスデータを整理する際に使用する、標準化されたフレームワーク。
  • バッチ取り込み:Experience Platform がユーザー指定のデータファイルからデータを取り込む方法。
  • Adobe Experience Platform データ準備:取り込んだデータを XDM スキーマに準拠するようにマッピングおよび変換できる一連の機能。 データ準備関数に関するドキュメントは、特にスキーママッピングに関連しています。

また、このチュートリアルでは、CSV データの取り込み先のデータセットを既に作成している必要があります。 UI でデータセットを作成する手順については、データ取得のチュートリアルを参照してください。

宛先の選択

Adobe Experience Platformにログインし、左側のナビゲーションバーから​ ワークフロー ​を選択して、ワークフロー ワークスペースにアクセスします。

ワークフロー​画面で、データ取り込み セクションの​ CSVをXDM スキーマにマッピング ​を選択し、起動​を選択します。

宛先 ステップから、CSVをXDM スキーマにマッピング ワークフローが表示されます。 取り込むインバウンドデータのデータセットを選択します。 既存のデータセットを使用することも、新しいデータセットを作成することもできます。

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

CSV データを既存のデータセットに取り込むには、既存のデータセットを使用​を選択します。 検索機能を使用するか、パネル内の既存のデータセットのリストをスクロールすると、既存のデータセットを取得できます。

CSV データを新しいデータセットに取り込むには、新しいデータセットを作成​を選択し、提供されるフィールドにデータセットの名前と説明を入力します。 検索機能を使用するか、提供されたスキーマのリストをスクロールして、スキーマを選択します。 続行するには、次へ​を選択してください。

データの追加

データを追加」ステップが表示されます。 CSV ファイルを指定されたスペースにドラッグ&ドロップするか、ファイルを選択​してCSV ファイルを手動で入力します。

ファイルがアップロードされると、サンプルデータ セクションが表示され、最初の10行のデータが表示されます。 データが期待どおりにアップロードされたことを確認したら、次へ​を選択します。

XDM スキーマフィールドへの CSV フィールドのマッピング

マッピング」ステップが表示されます。 CSV ファイルの列は​ Source フィールド ​に一覧表示され、対応するXDM スキーマフィールドは​ ターゲットフィールド ​に一覧表示されます。

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

すべての自動生成マッピング値を受け入れるには、「すべてのターゲットフィールドを受け入れる」というラベルのチェックボックスを選択します。

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

または、ソーススキーマをターゲットスキーマに手動でマッピングすることもできます。 マッピングするソーススキーマにポインタを合わせて、プラスアイコンを選択します。

ソースをターゲットフィールドにマッピング」ポップオーバーが表示されます。 ここから、マッピングするフィールドを選択し、その後​ 保存 ​して新しいマッピングを追加できます。

マッピングの 1 つを削除する場合は、そのマッピングにポインタを合わせて、マイナスアイコンを選択します。

計算フィールドの追加 add-calculated-field

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

続行するには、「計算フィールドを追加」ボタンを選択します。

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

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

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

保存​を選択して続行します。

マッピング画面が再表示され、新しく作成したソースフィールドが表示されます。 対応する適切なターゲットフィールドを適用し、終了​を選択してマッピングを完了します。

データ取得の監視

CSV ファイルがマッピングされ、作成されたら、CSV ファイルを通じて取り込まれるデータを監視できます。 データ取り込みのモニタリングについて詳しくは、データ取り込みのモニタリングに関するチュートリアルを参照してください。

次の手順

このチュートリアルに従うと、フラットな CSV ファイルを XDM スキーマにマッピングし、Experience Platform に取り込むことができます。 Real-Time Customer Profile などのダウンストリームの Experience Platform サービスで、このデータを使用できるようになりました。 詳しくは、Real-Time Customer Profile の概要を参照してください。

TIP
機械学習(ML)アルゴリズムを使用して、スキーマワークスペースからサンプルデータ からスキーマを​生成することもできます。 このワークフローでは、ファイルの構造と内容に基づいて新しいスキーマが自動的に作成され、スキーマがデータの形式と一致することが確認されます。 これにより、大規模で複雑なデータセットの構造、フィールド、データタイプを定義する際の時間を節約し、精度を高めることができます。 このワークフローについて詳しくは、ML支援スキーマ作成ガイド ​を参照してください。
recommendation-more-help
experience-platform-help-ingestion