Segmentation Service API ガイド

Adobe Experience Platform Segmentation Service を使用すると、Adobe Experience Platformのセグメント定義またはその他のソースを使用して、Real-Time Customer Profile データからオーディエンスを作成できます。

Segmentation Service API は複数のエンドポイントを提供し、Experience Platform でセグメント化操作をプログラム的に管理できるようにします。 この概要ドキュメントでは、これらの各エンドポイントの概要を説明し、詳しくは、関連するエンドポイントガイドへのリンクを示します。 個々のエンドポイントガイドを読む前に、 はじめる前にを参照して、必要なヘッダー、サンプル API 呼び出しの読み取りなどに関する重要な情報を確認してください。

使用可能なすべてのエンドポイントと CRUD 操作を表示するには、Segmentation Service API リファレンスを参照してください。

オーディエンス

オーディエンスは、類似の行動や特性を共有する人々の集まりです。 これらは、Platform を使用するか、外部ソースから生成できます。 /audiences エンドポイントを使用して、すべてのオーディエンスを取得したり、新しいオーディエンスを作成したり、特定のオーディエンスの詳細を取得したり、特定のオーディエンスを更新したり、特定のオーディエンスを削除したりできます。

このエンドポイントの使用について詳しくは、 オーディエンスエンドポイントガイドを参照してください。

ジョブの書き出し

書き出しジョブは、オーディエンスセグメントメンバーをデータセットに保持するために使用される非同期プロセスです。 /export/jobs エンドポイントを使用して、すべてのエクスポートジョブを取得したり、新しいエクスポートジョブを作成したり、特定のエクスポートジョブの詳細を取得したり、特定のエクスポートジョブをキャンセルしたりできます。

このエンドポイントの使用について詳しくは、 書き出しジョブエンドポイントガイドを参照してください。

プレビューと見積もり

プレビューでは、セグメント定義の選定中のプロファイルのページ分割されたリストが提供され、結果を期待するものと比較できます。 /preview エンドポイントを使用して、新しいプレビュージョブを作成したり、特定のプレビュージョブの結果を検索したりできます。

予測値は、推定オーディエンスサイズ、信頼区間、エラー標準偏差など、セグメント定義の統計情報を提供します。 /estimate エンドポイントを使用して、セグメント定義の推定を表示できます。

これらのエンドポイントの使用について詳しくは、 プレビューと予測エンドポイントガイドを参照してください。

スケジュール

スケジュールは、バッチセグメント化ジョブを 1 日に 1 回自動的に実行するためのツールです。 /config/schedules エンドポイントを使用して、スケジュールのリストの取得、新しいスケジュールの作成、特定のスケジュールの詳細の取得、特定のスケジュールの更新、特定のスケジュールの削除を行うことができます。

このエンドポイントの使用について詳しくは、 スケジュールエンドポイントガイドを参照してください。

セグメント定義

セグメント定義は、オーディエンスに含めるプロファイルを定義します。 /segment/definitions エンドポイントを使用して、セグメント定義を管理できます。

このエンドポイントの使用について詳しくは、 セグメント定義エンドポイントガイドを参照してください。

セグメントジョブ

セグメントジョブは、オーディエンスを生成するために、以前に確立されたセグメント定義を処理します。 /segment/jobs エンドポイントを使用して、セグメントジョブを管理できます。

このエンドポイントの使用について詳しくは、 セグメントジョブエンドポイントガイドを参照してください。

セグメント検索

セグメント検索は、様々なデータソースに含まれるフィールドを検索し、ほぼリアルタイムで返すために使用されます。 セグメント検索の使用を開始するには、 検索エンドポイントガイドを参照してください

次の手順

Segmentation Service API の使用を開始するには、様々なエンドポイントガイドを参照して、サービスの様々なエンドポイントを呼び出す手順を確認してください。 Platform UI を使用したセグメントの操作について詳しくは、 セグメント化ユーザーガイドを参照してください。