Show Menu
トピック×

Adobe Experience Platform へのデータの取得

Adobe Experience Platform allows you to easily import data into Platform as batch files. Examples of data to be ingested may include profile data from a flat file in a CRM system (such as a parquet file) or data that conforms to a known Experience Data Model (XDM) schema in the Schema Registry.

はじめに

In order to complete this tutorial, you must have access to Experience Platform. If you do not have access to an IMS Organization in Experience Platform, please speak to your system administrator before proceeding.
データ取得 API を使用してデータを取得する場合は、まず『 バッチ取得開発者ガイド 』をお読みください。

データセットワークスペース

The Datasets workspace within Experience Platform allows you to view and manage all of the datasets that your IMS organization has made, as well as create new ones.
左側のナビゲーションで「 データセット 」をクリックして、「データセット」ワークスペースを表示します。「データセット」ワークスペースには、 名前 作成日時 ソース スキーマ 最終バッチステータス ​を示す列、および​ 最終更新日時 ​を含むデータセットのリストが含まれています。
Click on the filter icon next to the Search bar to use filtering capabilities to view only those datasets enabled for Profile.

データセットの作成

データセットを作成するには、「データセット」ワークスペースの右上隅にある「 データセットを作成 」をクリックします。
On the Create Dataset screen, select whether you would like to "Create Dataset from Schema" or "Create Dataset from CSV File".
このチュートリアルでは、スキーマを使用してデータセットを作成します。続行するには、「 スキーマからデータセットを作成 」をクリックします。

データセットスキーマの選択

スキーマを選択 ​画面で、使用するスキーマの横にあるラジオボタンをクリックしてスキーマを選択します。このチュートリアルでは、データセットは Loyalty Members スキーマを使用して作成します。検索バーを使用してスキーマをフィルターすると、探している正確なスキーマを見つけられます。
使用するスキーマの横のラジオボタンを選択したら、「 次へ 」をクリックします。

データセットの設定

データセットの設定 ​画面で、データセットの​ 名前 ​を指定し、データセットの​ 説明 ​も入力できます。
データセット名に関する注意事項:
  • 後でライブラリ内で簡単に見つけられるように、データセット名は短く、わかりやすい名前にする必要があります。
  • データセット名は一意である必要があります。つまり、今後再利用されないように十分な固有の名前を付ける必要があります。
  • ベストプラクティスは、説明フィールドを使用して、データセットに関する追加情報を提供することです。これは、今後、他のユーザーがデータセットを区別する際に役立つ可能性があるためです。
データセットに名前と説明が付いたら、「 完了 」をクリックします。

データセットアクティビティ

空のデータセットが作成され、データセットワークスペースの「 データセットアクティビティ 」タブに戻りました。ワークスペースの左上隅にデータセットの名前と、「バッチが追加されていません」という通知が表示されます。このデータセットにバッチをまだ追加していないので、これは期待通りです。
「データセット」ワークスペースの右側に「 情報 」タブがあり、新しいデータセットに関した「 データセット ID 」、「 名前 」、「 説明 」、「 テーブル名 」、「 スキーマ 」、「 ストリーミング 」「 ソース 」などの情報が含まれます。また、「情報」タブには、データセットの​ 作成日 ​と​ 最終変更日 ​に関する情報も含まれます。
Also in the Info tab is a Profile toggle that is used for enabling your dataset for use with Real-time Customer Profile. Use of this toggle, and Real-time Customer Profile, will be explained in more detail in the section that follows.

データセットの有効化 Real-time Customer Profile

Datasets are used for ingesting data into Experience Platform, and that data is ultimately used to identify individuals and stitch together information coming from multiple sources. 情報を繋ぎ合わせたものを「」と呼び Real-Time Customer Profileます In order for Platform to know which information should be included in the Real-Time Profile, datasets can be marked for inclusion using the Profile toggle.
デフォルトでは、この切り替えはオフになっています。If you choose to toggle on Profile, all data ingested into the dataset will be used to help identify an individual and stitch together their Real-Time Profile.
To learn more about Real-time Customer Profile and working with identities, please review the Identity Service documentation.
To enable the dataset for Real-time Customer Profile, click the Profile toggle in the Info tab.
A dialog will appear asking you to confirm that you want to enable the dataset for Real-time Customer Profile.
有効 」をクリックすると、切り替えが青に変わり、オンになっていることを示します。

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

データは様々な方法でデータセットに追加できます。You could choose to use Data Ingestion APIs or an ETL partner such as Unifi or Informatica. このチュートリアルでは、UI 内の「 データの追加 」タブを使用してデータセットにデータを追加します。
データセットへのデータの追加を開始するには、「 データの追加 」タブをクリックします 。ファイルをドラッグ&ドロップしたり、追加するファイルをコンピューターで参照したりできるようになりました。
Platform では、データ取得用に 2 種類のファイル(parquet、JSON)がサポートされています。一度に 5 個までのファイルを追加でき、各ファイルの最大ファイルサイズは 10GB です。

ファイルのアップロード

Once you drag and drop (or browse and select) a parquet or JSON file that you wish to upload, Platform will immediately begin to process the file and an Uploading dialog will appear on the Add Data tab showing the progress of your file upload.

データセット指標

ファイルのアップロードが完了すると、「 データセットのアクティビティ 」タブに「バッチが追加されていません」と表示されることはなくなります。Instead, the Dataset Activity tab now shows dataset metrics. バッチがまだ読み込まれていないので、すべての指標はこの段階で「0」と表示されます。
タブの下部には、「 データセットへのデータ追加 」処理で取得されたデータの​ バッチ ID を示す追加リストが表示されます。また、 取得 ​された日付、取得された​ レコード数 、現在のバッチ​ 状態 ​など、バッチに関する情報も含まれます 。

バッチの詳細

バッチの概要 ​でバッチに関する追加の詳細を表示するには「 バッチ ID 」をクリックします。バッチの読み込みが完了すると、バッチに関する情報が更新され、 取得されたレコード数 ​と​ ファイルサイズ ​が表示されます。「 ステータス 」も「成功」または「失敗」に変更されます。バッチが失敗した場合は、取得中に「 エラーコード 」セクションに、エラーに関する詳細が含まれます。
バッチ取得に関する詳細とよくある質問については、『 バッチ取得のトラブルシューティングガイド 』を参照してください。
データセットアクティビティ ​画面に戻るには 、階層リンクでデータセットの名前( Loyalty Details )をクリックします。

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

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

次の手順 およびその他のリソース

Now that you have created a dataset and successfully ingested data into Experience Platform, you can repeat these steps to create a new dataset or ingest more data into the existing dataset.
バッチ取り込みの詳細については、 バッチ取り込みの概要を読み 、次のビデオを参照して学習を補ってください。
次のビデオに示す Platform UIは古いです。 最新のUIのスクリーンショットと機能については、上記のドキュメントを参照してください。