Adobe Experience Platform へのデータの取得
Adobe Experience Platformでは、データをExperience Platformにバッチファイルとして簡単にインポートできます。 取り込むデータの例として、CRM システムのフラットファイル(Parquet ファイルなど)からのプロファイルデータ、またはSchema Registryの既知のExperience Data Model (XDM) スキーマに準拠するデータが含まれます。
はじめに
このチュートリアルを完了するには、Experience Platformへのアクセス権が必要です。 Experience Platformの組織にアクセスできない場合は、続行する前にシステム管理者にお問い合わせください。
データ取得 API を使用してデータを取得する場合は、まず『バッチ取得開発者ガイド』をお読みください。
データセットワークスペース
Experience Platform内のデータセット ワークスペースでは、組織が作成したすべてのデータセットを表示および管理したり、新しいデータセットを作成したりできます。
左側のナビゲーションで「データセット」をクリックして、データセットワークスペースを表示します。 データセットワークスペースには、名前、作成日(日時)、ソース、スキーマ、最後のバッチステータスを示す列と、データセットが最後に更新された日時を含むデータセットのリストが含まれます。
データセットの作成
データセットを作成するには、データセットワークスペースの右上隅にある「データセットを作成」をクリックします。
データセットを作成画面で、「 スキーマからデータセットを作成」または「CSV ファイルからデータセットを作成」のいずれかを選択します。
このチュートリアルでは、スキーマを使用してデータセットを作成します。 「スキーマからデータセットを作成」をクリックして続行します。
データセットスキーマの選択
スキーマを選択画面で、使用するスキーマの横にあるラジオボタンをクリックして、スキーマを選択します。 このチュートリアルでは、データセットは Loyalty Members スキーマを使用して作成します。 検索バーを使用してスキーマをフィルターすると、探している正確なスキーマを見つけられます。
使用するスキーマの横にあるラジオボタンを選択したら、次へをクリックします。
データセットの設定
データセットを設定画面では、データセットに名前を付ける必要があり、データセットの説明も提供する場合があります。
データセット名に関する注意事項:
- 後でライブラリ内で簡単に見つけられるように、データセット名は短く、わかりやすい名前にする必要があります。
- データセット名は一意である必要があります。つまり、今後再利用されないように十分な固有の名前を付ける必要があります。
- ベストプラクティスは、説明フィールドを使用して、データセットに関する追加情報を提供することです。これは、今後、他のユーザーがデータセットを区別する際に役立つ可能性があるためです。
データセットに名前と説明が付いたら、終了をクリックします。
データセットアクティビティ
空のデータセットが作成され、データセットワークスペースの「データセットアクティビティ」タブに戻りました。 ワークスペースの左上隅にデータセットの名前と、「バッチが追加されていません」という通知が表示されます。 このデータセットにバッチをまだ追加していないので、これは期待通りです。
データセットワークスペースの右側に、情報 タブがあり、新しいデータセットに関連する情報(データセット ID、名前、説明、テーブル名、スキーマ、ストリーミング、ソースなど)が表示されます。 「情報」タブには、データセットの作成日時と最終変更日に関する情報も含まれます。
また、「情報」タブには、Real-Time Customer Profileで使用するデータセットを有効にするために使用される プロファイル の切り替えスイッチもあります。 このトグルとReal-Time Customer Profileの使用については、次の節で詳しく説明します。
Real-Time Customer Profileのデータセットを有効にする enable-for-profile
データセットはExperience Platformにデータを取り込むために使用され、そのデータは最終的に個人を特定し、複数のソースからの情報をつなぎ合わせるために使用されます。 この情報をつなぎ合わせたものがReal-Time Customer Profileと呼ばれます。 Experience PlatformさんがReal-Time Profileに含める情報を把握するには、プロファイル切り替えスイッチを使用して、データセットに含めるマークを付けることができます。
デフォルトでは、この切り替えはオフになっています。 Profileの切り替えを選択した場合、データセットに取り込まれたすべてのデータは、個人の識別とReal-Time Profileの結合に役立てるために使用されます。
Real-Time Customer ProfileとIDの操作について詳しくは、ID サービス のドキュメントを参照してください。
Real-Time Customer Profileのデータセットを有効にするには、「情報」タブの「プロファイル」トグルをクリックします。
Real-Time Customer Profileのデータセットを有効にするかどうかを確認するダイアログが表示されます。
「有効にする」をクリックすると、トグルが青に変わり、オンになっていることが示されます。
データセットへのデータの追加
データは様々な方法でデータセットに追加できます。 Data Ingestion個のAPIまたはUnifiやInformaticaなどのETL パートナーを使用できます。 このチュートリアルでは、UI内の「データを追加」タブを使用して、データセットにデータが追加されます。
データセットへのデータの追加を開始するには、「データを追加」タブをクリックします。 ファイルをドラッグ&ドロップしたり、追加するファイルをコンピューターで参照したりできるようになりました。
ファイルのアップロード upload-file
アップロードするParquetまたはJSON ファイルをドラッグ&ドロップ(または参照して選択)すると、Experience Platformは直ちにファイルの処理を開始し、データを追加 タブにアップロード ダイアログが表示され、ファイルのアップロードの進行状況が表示されます。
データセット指標
ファイルのアップロードが完了すると、「データセットのアクティビティ」タブに「バッチが追加されていません」という表示が表示されなくなります。 代わりに、「データセットアクティビティ」タブにデータセット指標が表示されるようになりました。 バッチがまだ読み込まれていないので、すべての指標はこの段階で「0」と表示されます。
タブの下部には、 「データセットにデータを追加」 プロセスを通じて取り込まれたデータの バッチ ID を示すリストがあります。 また、取り込まれた日付、取り込まれたレコード数、現在のバッチステータスなど、バッチに関連する情報も含まれます。
バッチの詳細
バッチ IDをクリックすると、バッチの概要が表示され、バッチに関する追加の詳細が表示されます。 バッチの読み込みが完了すると、バッチに関する情報が更新され、取り込まれたレコード数とファイルサイズが表示されます。 ステータスも「成功」または「失敗」に変わります。 バッチが失敗した場合、エラーコード セクションには、取り込み中のエラーに関する詳細が含まれます。
バッチ取り込みに関する詳細とよくある質問については、バッチ取り込みのトラブルシューティングガイドを参照してください。
データセットアクティビティ画面に戻るには、パンくずリストのデータセット名(ロイヤルティの詳細)をクリックします。
データセットのプレビュー
データセットの準備が整うと、「データセットのアクティビティ」タブの上部に「データセットをプレビュー」オプションが表示されます。
「データセットのプレビュー」をクリックして、データセット内のサンプルデータを表示するダイアログを開きます。 データセットがスキーマを使用して作成された場合は、データセットスキーマの詳細がプレビューの左側に表示されます。 矢印を使用してスキーマを展開し、構造を確認できます。 データセット内の各列見出しは、プレビューセット内の 1 つのフィールドを表します。
次の手順とその他のリソース
データセットを作成し、Experience Platformにデータを正常に取り込んだので、次の手順を繰り返して新しいデータセットを作成するか、既存のデータセットにさらにデータを取り込むことができます。
バッチ取り込みについて詳しくは、 バッチ取り込みの概要を参照し、以下のビデオを見て学習を補足してください。