データ収集のためのデータ準備
データ準備は、エクスペリエンスデータモデル(XDM)との間でデータのマッピング、変換、検証を可能にする、Adobe Experience Platform サービスです。Platform 対応のデータストリームを設定する場合、データ準備機能を使用して、Platform Edge Network に送信する際にソースデータを XDM にマッピングできます。
Web ページから送信されるすべてのデータは、XDM としてExperience Platformされる必要があります。 ページ上のデータレイヤーからExperience Platformが受け入れる XDM にデータを変換する方法は 3 つあります。
- Web ページ自体で、データレイヤーを XDM に再フォーマットします。
- タグネイティブデータ要素機能を使用して、web ページの既存のデータレイヤー形式を XDM に再フォーマットします。
- データ収集のための Data Prep を使用して、Edge Networkを介して web ページの既存のデータレイヤー形式を XDM に再フォーマットします。
このガイドでは、3 番目のオプションに焦点を当てています。
データ収集のためにデータ準備を使用するタイミング when-to-use-data-prep
データ収集のためのデータ準備が役立つユースケースは 2 つあります。
- Web サイトには、適切に形成、管理、管理されたデータレイヤーがあり、JavaScript操作を使用してページ上で(タグデータ要素を使用して、または手動のJavaScript操作を使用して) XDM に変換する代わりに、Edge Networkに直接送信する環境設定があります。
- タグ以外のタグ付けシステムがサイトにデプロイされている。
WebSDK を使用したEdge Networkへの既存のデータレイヤーの送信 send-datalayer-via-websdk
既存のデータレイヤーは、sendEvent
コマンド内の data
オブジェクトを使用して送信する必要があります。
タグを使用する場合は、Web SDK タグ拡張機能ドキュメント に記載されているように、 イベントを送信 アクションタイプの [ データ] フィールドを使用する必要があります。
このガイドの残りの部分では、WebSDK によって送信されたデータレイヤーを XDM 標準にマッピングする方法について重点的に説明します。
このガイドでは、UI 内のデータのマッピング方法を説明します。手順に従って、データストリームの作成から基本設定手順までのプロセスを開始します。
データ収集のためのデータ準備プロセスの簡単なデモについては、次のビデオを参照してください。
データの選択 select-data
データストリームの基本設定が完了してから「保存してマッピングを追加」を選択すると、データを選択 手順が表示されます。ここから、Platform に送信する予定のデータの構造を表す、サンプル JSON オブジェクトを指定する必要があります。
データレイヤーから直接プロパティを取得するには、JSON オブジェクが単一のルートプロパティ data
を持つ必要があります。data
オブジェクトのサブプロパティは、取得したいデータレイヤープロパティにマッピングするように構築する必要があります。 次のセクションを選択すると、data
ルートを持つ適切にフォーマットされた JSON オブジェクトの例が表示されます。
data
ルートを持つサンプル JSON ファイルcode language-json |
---|
|
XDM オブジェクトデータ要素からプロパティを取得するには、同じルールを JSON オブジェクトに適用しますが、ルートプロパティは、変わりに xdm
としてキーにする必要があります。次のセクションを選択すると、xdm
ルートを持つ適切にフォーマットされた JSON オブジェクトの例が表示されます。
xdm
ルートを持つサンプル JSON ファイルcode language-json |
---|
|
オブジェクトをファイルとしてアップロードするオプションを選択するか、提供されたテキストボックスに生のオブジェクトを代わりに貼り付けることができます。JSON が有効な場合、右側のパネルにプレビュースキーマが表示されます。「次へ」をクリックして続行します。
マッピング
マッピング 手順が表示され、ソースデータフィールドを Platform のターゲットイベントスキーマのフィールドにマッピングできます。ここから、2 つの方法でマッピングを設定できます。
- 手動のプロセスでこのデータストリームに対して マッピングルールを作成します。
- 既存のデータストリームからマッピングルールを読み込みます。
マッピングルールの作成 create-mapping
マッピングルールを作成するには、「新しいマッピングを追加」を選択します。
ソースアイコン( )を選択して、表示されるダイアログで、提供されたキャンバスにマッピングするソースフィールドを選択します。フィールドを選択したら、「選択」ボタンを使用して続行します。
次に、スキーマアイコン( )を選択して、ターゲットイベントスキーマ用の同様のダイアログを開きます。データをマッピングするフィールドを選択してから、「選択」で確定します。
マッピングページが再表示され、完成したフィールドマッピングが表示されます。「マッピングの進行状況」セクションが更新され、正常にマッピングされたフィールドの合計数が反映されます。
[*]
を追加します。既存のマッピングルールを読み込む import-mapping
以前にデータストリームを作成したことがある場合、その設定されたマッピングルールを新しいデータストリームで再利用できます。
開始するには、「マッピングをインポート」を選択します。
表示されるダイアログで、マッピングルールを読み込むデータストリームを選択します。データストリームを選択したら、「プレビュー」を選択します。
次の画面に、選択したデータストリームの保存されたマッピングルールのプレビューを示します。表示されたマッピングが期待どおりのものであることを確認してから、「インポート」を選択して確定すると、新しいデータストリームにマッピングが追加されます。
マッピングの完了
前述の手順を続行して、残りのフィールドをターゲットスキーマにマッピングします。使用可能なすべてのソースフィールドをマッピングする必要はありませんが、ターゲットスキーマで必須として設定されているフィールドは、この手順を完了するためにマッピングする必要があります。 必須フィールド カウンターは、現在の設定でまだマッピングされていない必須フィールドの数を示します。
必須フィールドのカウントがゼロになって、マッピングに満足したら、「保存」を選択して変更を確定します。
次の手順
このガイドでは、UI でデータストリームを設定する際の、データの XDM へのマッピング方法について説明しました。一般的なデータストリームのチュートリアルを行っていた場合は、データストリームの詳細の表示に関する手順に戻ることができます。