Segmentation Service API ガイド

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

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

利用可能なすべてのエンドポイントとCRUD操作を表示するには、​ セグメント化サービス API リファレンス ​を参照してください。

オーディエンス

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

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

ジョブの書き出し

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

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

外部オーディエンス

/core/ais/external-audiences エンドポイントを使用して、外部オーディエンスをExperience Platformに読み込み、オーディエンスの作成ステータスを取得、外部オーディエンスを更新、オーディエンス取り込み実行を開始、外部オーディエンス取り込みステータスを取得、オーディエンス取り込み実行を一覧表示、および外部オーディエンスを削除できます。

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

プレビューと見積もり

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

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

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

スケジュール

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

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

セグメント定義

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

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

セグメントジョブ

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

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

セグメント検索

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

次の手順

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