Real-Time Customer Profile API ガイド
Real-Time Customer Profile を使用すると、Adobe Experience Platform内の個々の顧客の全体像を確認できます。 Profile を使用すると、オンライン、オフライン、CRM、サードパーティデータなど、複数のチャネルからの様々な顧客データを統合ビューに統合して、すべての顧客インタラクションのタイムスタンプ付きの実用的なアカウントを提供できます。
この Real-Time Customer Profile API には複数のエンドポイントが含まれます(以下で概要を説明します)。 詳しくは、個々のエンドポイントのガイドを参照し、必要なヘッダー、サンプル API 呼び出しの読み取りなどに関する重要な情報については、はじめにのガイドを参照してください。
使用可能なすべてのエンドポイントと CRUD 操作を表示するには、を参照してください リアルタイム顧客プロファイル API リファレンス swagger.
を使用する際のガイド Real-Time Customer Profile 内のデータ Experience Platform UI です。を参照してください。 プロファイルユーザーガイド.
[ベータ版]{class="badge informative"} 計算属性 computed-attributes
計算済み属性は、イベントレベルのデータをプロファイルレベルの属性に集計するために使用される関数です。これらの関数は自動的に計算され、セグメント化、アクティベーションおよびパーソナライゼーションで使用できます。
各計算属性には、受信データを評価し、結果の値をプロファイル属性に保存する式(「ルール」)が含まれます。 これらの計算により、ライフタイム購入値、購入間隔、アプリケーションを開いた数などに関する質問に簡単に答えることができます。情報が必要になるたびに複雑な計算を手動で実行する必要はありません。これらの計算済み属性値は、プロファイルに表示したり、オーディエンスの作成に使用したり、様々なアクセスパターンを使用してアクセスしたりできます。
を使用して、計算済み属性を作成、表示、編集、削除できます ca/attributes/
エンドポイント。 計算属性の使用方法については、を参照してください 計算属性の概要. API 操作については、を参照してください。 計算属性 API エンドポイントガイド.
エンティティ(Profile アクセス) entities
Adobe Experience Platformから、次にアクセスできます Real-Time Customer Profile restful API またはユーザーインターフェイスを使用したデータ。 API を使用してエンティティ(より一般的には「プロファイル」と呼ばれる)にアクセスする方法については、 エンティティエンドポイントガイド. を使用してプロファイルにアクセスするには Platform UI。を参照してください。 プロファイルユーザーガイド.
書き出しジョブ(Profile 書き出し) profile-export
Real-Time Customer Profile データをデータセットに書き出して、アクティベーション用のオーディエンスやレポート用のプロファイル属性の書き出しなど、さらに処理を行うことができます。 オーディエンスの書き出しジョブは、 Adobe Experience Platform Segmentation Service API。を読み取ってください。 セグメント化書き出しジョブエンドポイントガイド を参照してください。 プロファイル属性の書き出しジョブを作成および管理する手順については、を参照してください。 書き出しジョブエンドポイントガイド.
結合ポリシー merge-policies
で複数のソースからデータを統合する場合 Experience Platform、結合ポリシーは次のようなルールです Platform を使用して、データの優先順位付け方法と、個々の顧客プロファイルを作成するためにどのデータを組み合わせるかを決定します。 使用, Real-Time Customer Profile API を使用すると、新しい結合ポリシーの作成、既存のポリシーの管理、組織のデフォルトの結合ポリシーの設定をおこなうことができます。 API を使用して結合ポリシーを使用するには、次を参照してください 結合ポリシーエンドポイントガイド.
結合ポリシーとその Platform 内での役割について詳しくは、まず次をお読みください 結合ポリシーの概要.
プレビューサンプルのステータス(Profile プレビュー) profile-preview
データが Platform に取り込まれると、サンプルジョブが実行されて、プロファイル数やその他のリアルタイム顧客プロファイルデータ関連指標が更新されます。 このサンプルジョブの結果は、 /previewsamplestatus
リアルタイム顧客プロファイル API の一部であるエンドポイント。 また、このエンドポイントを使用して、データセットと ID 名前空間の両方でプロファイル配布をリスト表示したり、複数のレポートを生成して組織のプロファイルストアの構成を可視化したりできます。 の使用を開始するには /profilepreviewstatus
エンドポイントについては、を参照してください プレビューサンプルステータスエンドポイントガイド.
プロファイルシステムジョブ profile-system-jobs
に取り込まれるプロファイル対応データ Platform は、に保存されます。 Data Lake と Real-Time Customer Profile データストア。 不要になったデータやエラーで追加されたデータを削除するには、プロファイルストアからデータセットに関連付けられたプロファイルデータを削除する必要が生じる場合があります。 これには、API を使用してを作成する必要があります。 Profile System Job(「」とも呼ばれます)delete request「」。必要に応じて、変更、監視、削除できます。 を使用して削除リクエストを操作する方法を説明します。 /system/jobs
のエンドポイント Real-Time Customer Profile API の場合は、で説明されている手順に従います プロファイルシステムジョブエンドポイントガイド.
プロファイル属性の更新 update-profile
場合によっては、組織のプロファイルストアのデータを更新する必要があります。例えば、レコードを修正したり、属性値を変更したりする必要がある場合があります。これは、バッチの取り込みを通じて行うことができ、upsert タグで構成されたプロファイル対応のデータセットが必要です。属性更新用にデータセットを構成する方法について詳しくは、プロファイルとアップサートのデータセットの有効化に関するチュートリアルを参照してください。
次の手順 next-steps
を使用して呼び出しを開始するには Real-Time Customer Profile API、読み取り はじめる前に 次に、エンドポイントガイドの 1 つを選択して、特定の使用方法を学習します Profile – 関連のエンドポイント。 を操作するには Profile を使用したデータ Experience Platform UI です。を参照してください。 リアルタイム顧客プロファイルユーザーガイド.