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