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 を使用したスキーマの作成に関するチュートリアルに従います。

バッチインジェストを使用してデータを追加する

バッチ取り込みを使用して 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 タグで構成されたプロファイル対応のデータセットが必要です。属性更新用にデータセットを構成する方法について詳しくは、プロファイルとアップサートのデータセットの有効化に関するチュートリアルを参照してください。