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. 次の条件を満たすため 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 または ETL パートナー(など) Unifi または Informatica. このチュートリアルでは、UI 内の「データの追加」タブを使用してデータセットにデータを追加します。
データセットへのデータの追加を開始するには、「データの追加」タブをクリックします 。ファイルをドラッグ&ドロップしたり、追加するファイルをコンピューターで参照したりできるようになりました。
ファイルのアップロード upload-file
アップロードする Parquet または JSON ファイルをドラッグ&ドロップ(または参照して選択)したら、次の手順を実行します。 Platform が直ちにファイルの処理を開始し、 アップロード中 ダイアログが データを追加 タブに、ファイルのアップロードの進行状況が表示されます。
データセット指標
ファイルのアップロードが完了すると、「データセットのアクティビティ 」タブに「バッチが追加されていません」と表示されることはなくなります。代わりに、 データセットアクティビティ 「 」タブにデータセット指標が表示されるようになりました。 バッチがまだ読み込まれていないので、すべての指標はこの段階で「0」と表示されます。
タブの下部には、「データセットへのデータ追加」処理で取得されたデータの バッチ ID を示す追加リストが表示されます。また、取り込まれた日付、取り込まれたレコード数、現在のバッチの状態など、バッチに関する情報も含まれます。
バッチの詳細
バッチの概要 でバッチに関する追加の詳細を表示するには「バッチ ID」をクリックします。バッチの読み込みが完了すると、バッチに関する情報が更新され、取得されたレコード数とファイルサイズが表示されます。 ステータスも「成功」または「失敗」に変わります。 バッチが失敗した場合は、取得中に「エラーコード」セクションに、エラーに関する詳細が含まれます。
バッチ取得に関する詳細とよくある質問については、『バッチ取得のトラブルシューティングガイド』を参照してください。
データセットアクティビティ 画面に戻るには 、階層リンクでデータセットの名前(Loyalty Details)をクリックします。
データセットのプレビュー
データセットの準備が整うと、「データセットアクティビティ」タブの上部に「データセットのプレビュー」オプションが表示されます。
「プレビューデータセット」をクリックすると、データセット内のサンプルデータを示すダイアログが開きます。データセットがスキーマを使用して作成された場合は、データセットスキーマの詳細がプレビューの左側に表示されます。矢印を使用してスキーマを展開し、構造を確認できます。データセット内の各列見出しは、プレビューセット内の 1 つのフィールドを表します。
次の手順とその他のリソース
これで、データセットが作成され、にデータを取り込みました。 Experience Platformの場合は、これらの手順を繰り返して新しいデータセットを作成したり、既存のデータセットにさらにデータを取り込んだりできます。
バッチ取り込みの詳細については、 バッチ取り込みの概要 以下のビデオを見て、学習を補完します。