セグメント化サービス APIの概要 getting-started
Adobe Experience Platform Segmentation Serviceを使用すると、Real-Time Customer Profile データからAdobe Experience Platformのセグメント定義またはその他のソースを使用して、オーディエンスを作成できます。
開発者ガイドでは、Segmentation Serviceの使用に関する様々なExperience Platform サービスについて理解する必要があります。
- Adobe Experience Platform Segmentation Service: Real-Time Customer Profile データからオーディエンスを構築できます。
- Experience Data Model (XDM) System：Experience Platform が、カスタマーエクスペリエンスデータを整理する際に使用する、標準化されたフレームワーク。 セグメント化を最大限に活用するには、データモデリングのベストプラクティスに従って、データがプロファイルとイベントとして取り込まれていることを確認してください。
- Real-Time Customer Profile：複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
- サンドボックス：Experience Platform は、単一の Experience Platform インスタンスを別々の仮想環境に分割して、デジタルエクスペリエンスアプリケーションの開発と発展を支援する仮想サンドボックスを提供します。
次の節では、Segmentation APIを正常に操作するために知っておく必要がある追加情報を示します。
API 呼び出し例の読み取り
Segmentation Service API ドキュメントには、API 呼び出しの例とリクエストの形式を指定する方法が示されています。 これには、パス、必須ヘッダー、適切な形式のリクエストペイロードが含まれます。 また、API レスポンスで返されるサンプル JSON も示されています。 ドキュメントで使用される API 呼び出し例の表記について詳しくは、 トラブルシューテングガイドのAPI 呼び出し例の読み方に関する節を参照してくださいExperience Platform。
必須ヘッダー
また、API ドキュメントでは、 エンドポイントを正しく呼び出すために、認証に関するチュートリアルを完了している必要があります。Experience Platform 次に示すように、Experience Platform API 呼び出しにおける各必須ヘッダーの値は認証チュートリアルで説明されています。
- Authorization:
Bearer {ACCESS_TOKEN} - x-api-key：
{API_KEY} - x-gw-ims-org-id:
{ORG_ID}
Experience Platform のすべてのリソースは、特定の仮想サンドボックスに分離されています。 Experience Platform API へのすべてのリクエストには、操作が行われるサンドボックスの名前を指定するヘッダーが必要です。
- x-sandbox-name：
{SANDBOX_NAME}
次の手順
Segmentation Service APIを使用して呼び出しを行うには、左側のナビゲーションを使用するか、開発者ガイドの概要内で、使用可能なエンドポイントガイドのいずれかを選択します