データをReal-Time Customer Profileに追加

このチュートリアルでは、Real-Time Customer Profileにデータを追加するために必要な手順の概要を説明します。

Real-Time Customer Profileのスキーマを有効にする

Real-Time Customer Profileが使用するためにExperience Platformに取り込むデータは、Profileに対して有効になっているExperience Data Model （XDM） スキーマに準拠している必要があります。 プロファイルに対してスキーマを有効にするには、XDM Individual ProfileまたはXDM ExperienceEvent クラスのいずれかを実装する必要があります。

Schema Registry APIまたはSchema Editor ユーザーインターフェイスを使用して、Real-Time Customer Profileで使用するスキーマを有効にできます。 作業を開始するには、API を使用したスキーマの作成またはスキーマエディターの UI を使用したスキーマの作成に関するチュートリアルに従います。

バッチ取り込みを使用してデータを追加する

バッチ取り込みを使用してExperience Platformにアップロードされたすべてのデータは、個々のデータセットにアップロードされます。 このデータをReal-Time Customer Profileで使用する前に、該当するデータセットを具体的に設定する必要があります。 手順について詳しくは、プロファイルと ID サービスのデータセットの設定に関するチュートリアルを参照してください。

データセットを設定したら、データの取り込みを開始できます。 様々な形式のファイルをアップロードする方法について詳しくは、バッチ取り込み開発者ガイドを参照してください。

ストリーミング取り込みを使用してデータを追加する

Profile対応XDM スキーマに準拠しているストリーム取り込みデータは、Real-Time Customer Profileの適切なレコードを自動的に追加または上書きします。 レコードに複数の ID が指定されている場合、または時系列データが使用されている場合は、それらの ID が ID グラフにマッピングされます。追加の設定は必要ありません。 詳しくは、ストリーミング取り込みの開発者ガイドドを参照してください。

アップロードが正常に完了したことを確認する

新しいデータセットに初めてデータをアップロードする場合、または新しい ETL やデータソースに関するプロセスの一部としてデータをアップロードする場合は、データが正しくアップロードされているかどうかを慎重に確認することをお勧めします。

Real-Time Customer Profile Access API を使用すると、データセットに読み込まれるバッチデータを取得できます。 目的のエンティティを取得できない場合は、Profile でデータセットが有効になっていない可能性があります。 データセットが有効になっていることを確認した後、ソースデータの形式と識別子が要件を満たしていることを確認します。

Real-Time Customer Profile APIを使用してエンティティにアクセスする方法の詳細な手順については、「Profile Access API」とも呼ばれる​ エンティティエンドポイントガイド ​を参照してください。

プロファイルストアデータの更新

組織のプロファイルストアのデータを更新する必要が生じる場合があります。 例えば、レコードを修正したり、属性値を変更したりする必要がある場合があります。 これは、バッチの取り込みを通じて行うことができ、upsert タグで構成されたプロファイル対応のデータセットが必要です。 属性更新用にデータセットを構成する方法について詳しくは、プロファイルとアップサートのデータセットの有効化に関するチュートリアルを参照してください。