Adobe Experience Platform へのデータの取得

Adobe Experience Platformでは、データをバッチファイルとして Platform に簡単にインポートできます。 取り込まれるデータの例としては、CRM システム内のフラットファイル（Parquet ファイルなど）のプロファイルデータや、スキーマレジストリ内の既知の 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 のデータセットを有効にする

データセットは、データを Experience Platform に取り込むために使用され、そのデータは、最終的に個人を識別し、複数のソースからの情報を結び付けるために使用されます。 結び付けられた情報は Real-Time Customer Profile と呼ばれます。 Real-Time Profile ージに含める必要がある情報を Platform ーザーが把握できるように、プロファイル 切り替えスイッチを使用して、データセットを含めるようにマークできます。

デフォルトでは、この切り替えはオフになっています。Profile をオンに切り替えた場合、データセットに取り込まれたすべてのデータは、個人を識別して Real-Time Profile ータを結び付けるのに役立つように使用されます。

ID の Real-Time Customer Profile 用と操作について詳しくは、ID サービスドキュメントを参照してください。

データセットの Real-Time Customer Profile を有効にするには、「情報」タブの プロファイル 切り替えスイッチをクリックします。

Real-Time Customer Profile のデータセットを有効にするかどうかを確認するダイアログが表示されます。

「有効」をクリックすると、切り替えが青に変わり、オンになっていることを示します。

データセットへのデータの追加

データは様々な方法でデータセットに追加できます。Data Ingestion API を使用するか、Unifi や Informatica などの ETL パートナーを使用するかを選択できます。 このチュートリアルでは、UI 内の「データの追加」タブを使用してデータセットにデータを追加します。

データセットへのデータの追加を開始するには、「データの追加」タブをクリックします 。ファイルをドラッグ&ドロップしたり、追加するファイルをコンピューターで参照したりできるようになりました。

ファイルのアップロード upload-file

アップロードする Parquet または JSON ファイルをドラッグ&ドロップ（または参照して選択）す Platform と、ファイルの処理がすぐに開始され、ファイルのアップロードの進行状況を示す データを追加 タブに アップロード ダイアログが表示されます。

データセット指標

ファイルのアップロードが完了すると、「データセットのアクティビティ 」タブに「バッチが追加されていません」と表示されることはなくなります。代わりに、「データセットアクティビティ」タブにデータセット指標が表示されるようになりました。 バッチがまだ読み込まれていないので、すべての指標はこの段階で「0」と表示されます。

タブの下部には、「データセットへのデータ追加」処理で取得されたデータの​ バッチ ID を示す追加リストが表示されます。取り込まれた日付、取り込まれたレコード数、現在のバッチステータスなど、バッチに関連する情報も含まれます。

バッチの詳細

バッチの概要 ​でバッチに関する追加の詳細を表示するには「バッチ ID」をクリックします。バッチの読み込みが完了すると、バッチに関する情報が更新され、取り込まれたレコード数とファイルサイズが表示されます。 ステータスも「成功」または「失敗」に変わります。 バッチが失敗した場合は、取得中に「エラーコード」セクションに、エラーに関する詳細が含まれます。

バッチ取得に関する詳細とよくある質問については、『バッチ取得のトラブルシューティングガイド』を参照してください。

データセットアクティビティ ​画面に戻るには 、階層リンクでデータセットの名前（Loyalty Details）をクリックします。

データセットのプレビュー

データセットの準備が整うと、「データセットアクティビティ」タブの上部に「データセットのプレビュー」オプションが表示されます。

「プレビューデータセット」をクリックすると、データセット内のサンプルデータを示すダイアログが開きます。データセットがスキーマを使用して作成された場合は、データセットスキーマの詳細がプレビューの左側に表示されます。矢印を使用してスキーマを展開し、構造を確認できます。データセット内の各列見出しは、プレビューセット内の 1 つのフィールドを表します。

次の手順とその他のリソース

データセットを作成し、データを Experience Platform に正常に取り込んだので、これらの手順を繰り返して、新しいデータセットを作成したり、既存のデータセットにさらにデータを取り込んだりできます。

バッチ取り込みについて詳しくは、 バッチ取り込みの概要を参照し、以下のビデオを視聴して知識を補ってください。