セグメント化サービス API を使用してセグメント定義を作成する

このドキュメントでは、 Adobe Experience Platform Segmentation Service API.

ユーザーインターフェイスを使用したセグメント定義の作成方法について詳しくは、 セグメントビルダーガイド.

はじめに

このチュートリアルでは、 Adobe Experience Platform セグメント定義の作成に関連するサービス。 このチュートリアルを開始する前に、次のサービスのドキュメントを確認してください。

  • Real-Time Customer Profile:複数のソースから集計したデータに基づいて、統合されたリアルタイム顧客プロファイルを提供します。
  • Adobe Experience Platform Segmentation Service:リアルタイム顧客プロファイルデータのセグメント定義や他の外部ソースを使用してオーディエンスを構築できます。
  • Experience Data Model (XDM):Platform が、カスタマーエクスペリエンスデータを整理する際に使用する、標準化されたフレームワーク。セグメント化を最大限に活用するには、データモデリングのベストプラクティスに従って、データがプロファイルとイベントとして取り込まれていることを確認してください。

以下の節では、 Platform API

API 呼び出し例の読み取り

このチュートリアルでは、API 呼び出しの例を提供し、リクエストの形式を設定する方法を示します。これには、パス、必須ヘッダー、適切な形式のリクエストペイロードが含まれます。また、API レスポンスで返されるサンプル JSON も示されています。ドキュメントで使用される API 呼び出し例の表記について詳しくは、 トラブルシューテングガイドのAPI 呼び出し例の読み方に関する節を参照してくださいExperience Platform。

必須ヘッダーの値の収集

Platform API を呼び出すには、まず認証チュートリアルを完了する必要があります。次に示すように、すべての Experience Platform API 呼び出しに必要な各ヘッダーの値は認証チュートリアルで説明されています。

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

Experience Platform のすべてのリソースは、特定の仮想サンドボックスに分離されています。Platform API へのすべてのリクエストには、操作がおこなわれるサンドボックスの名前を指定するヘッダーが必要です。

  • x-sandbox-name:{SANDBOX_NAME}
NOTE
Platform のサンドボックスについて詳しくは、サンドボックスの概要に関するドキュメントを参照してください。

ペイロード(POST、PUT、PATCH)を含むすべてのリクエストには、次のような追加ヘッダーが必要です。

  • Content-Type: application/json

セグメント定義の作成

セグメント化の最初の手順は、セグメント定義を定義することです。 セグメント定義は、 Profile Query Language (PQL) を参照してください。 このオブジェクトは PQL 述語とも呼ばれます。PQL 述語は、指定するレコードまたは時系列データに関連する条件に基づいて、セグメント定義のルールを定義します Real-Time Customer Profile. PQL クエリの記述について詳しくは、PQL ガイドを参照してください。

新しいセグメント定義を作成するには、 /segment/definitions エンドポイント Segmentation API. 次の例では、セグメント定義を正しく定義するために必要な情報など、定義リクエストの形式について説明します。

セグメント定義の定義方法の詳細については、 セグメント定義開発者ガイド.

オーディエンスの推定とプレビュー estimate-and-preview-an-audience

セグメント定義を作成する際に、内の推定ツールとプレビューツールを使用できます Real-Time Customer Profile を参照して、期待されるオーディエンスを確実に特定するのに役立つ概要レベルの情報を表示します。 推定を通じて、予想されるオーディエンスサイズや信頼区間など、セグメント定義の統計情報が得られます。プレビューは、セグメント定義に適格なプロファイルのページ分割リストを表示するので、結果を予想と比較できます。

オーディエンスの推定とプレビューにより、望ましい結果が得られるまで PQL 述語をテストし最適化することができます。最終的な PQL 述語は更新したセグメント定義で使用できます。

セグメント定義をプレビューまたは推定するには、次の 2 つの手順が必要です。

  1. プレビュージョブの作成
  2. 推定またはプレビューの表示(プレビュージョブの ID を使用)

推定の生成方法

データサンプルを使用して、セグメント定義を評価し、適格なプロファイルの数を推定します。 毎朝(UTC の午前 7~9 時)新しいデータがメモリに読み込まれ、その日のサンプルデータを使用して、すべてのセグメント化クエリが推定されます。その結果、新しく追加されたフィールドや収集された追加データは、翌日の推定に反映されます。

サンプルサイズは、プロファイルストア内のエンティティの総数によって異なります。これらのサンプルサイズを次の表に示します。

プロファイルストア内のエンティティ数
サンプルサイズ
100 万未満
フルデータセット
100 万~2000 万
100 万
2000 万以上
全体の 5%

推定は通常、10~15 秒間実行されます。最初は大まかな推定ですが、読み取るレコードが増えるにつれて精度が高くなります。

プレビュージョブの作成

新しいプレビュージョブを作成するには、/preview エンドポイントに POST リクエストを送信します。

プレビュージョブの作成に関する詳しい手順については、 プレビューおよび予測エンドポイントガイド.

推定またはプレビューの表示

クエリが異なると完了するまでの時間が異なる可能性があるので、推定プロセスとプレビュープロセスは非同期で実行されます。クエリが開始されたら、API 呼び出しを使用して、推定またはプレビューの現在の状態を進行に応じて取得できます(GET リクエストを使用)。

の使用 Segmentation Service API では、ID でプレビュージョブの現在の状態を検索できます。 状態が「RESULT_READY」の場合は、結果を表示できます。プレビュージョブの現在の状態を検索するには、 プレビュージョブセクションの取得 を参照してください。 見積ジョブの現在の状態を検索するには、 見積ジョブの取得 を参照してください。

次の手順

セグメント定義を開発、テスト、保存したら、セグメントジョブを作成して、 Segmentation Service API. その詳しい手順については、セグメント結果の評価とアクセスに関するチュートリアルを参照してください。

recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871