ドキュメントExperience Platformセグメント化サービスガイド

Streaming segmentation guide

Last update: Fri Mar 13 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • ユーザー
recommendation-more-help
NOTE
ストリーミングセグメント化の実施要件条件は、2025 年 5 月 20 日（PT）に更新されました。
Eligibility updates
note important
IMPORTANT
ストリーミングセグメント化またはエッジセグメント化を使用して現在評価されている既存のセグメント定義は、編集または更新されない限り、引き続きそのまま機能します。

ルールセット ruleset

次のルールセットに一致する 新規または編集 セグメント定義は、ストリーミングまたはエッジセグメント化を使用して 評価されなくなります。 代わりに、バッチセグメント化を使用して評価されます。

  • 24 時間を超える時間枠を持つ単一イベント
    • 過去 3 日間に Web ページを表示したすべてのプロファイルでオーディエンスをアクティブ化します。
  • 時間枠のない単一イベント
    • Web ページを表示したすべてのプロファイルでオーディエンスをアクティブ化します。

時間枠 time-window

ストリーミングセグメント化を使用してオーディエンスを評価するには、24 時間の時間枠内にオーディエンスを制限する 必要 があります。

ストリーミングオーディエンスへのバッチデータの組み込み include-batch-data

note note
NOTE
バッチデータを使用する際にストリーミングセグメント化の正確性を維持するには、バッチデータがバッチオーディエンス内 のみ に保持され、ストリーミングオーディエンス内で参照されていることを確認します。

Prior to this update, you could create a streaming audience definition that combined both batch and streaming data sources. However, with the latest update, creating an audience with both batch and streaming data sources will be evaluated using batch segmentation.

更新されたルールセットに一致するストリーミングまたはエッジセグメント化を使用してセグメント定義を評価する必要がある場合は、バッチおよびストリーミングルールセットを明示的に作成し、セグメントのセグメントを使用してそれらを組み合わせる必要があります。 このバッチルールセット 必須 は、プロファイルスキーマに基づいている必要があります。

例えば、プロファイルスキーマデータを格納するオーディエンスと、エクスペリエンスイベントスキーマデータを格納する他のオーディエンスの 2 つのオーディエンスがあるとします。

table 0-row-5 1-row-5 2-row-5
オーディエンス スキーマ ソースタイプ クエリ定義 オーディエンス ID
カリフォルニア住民 プロファイル バッチ 住所はカリフォルニア州です e3be6d7f-1727-401f-a41e-c296b45f607a
最近のチェックアウト エクスペリエンスイベント ストリーミング 過去 24 時間以内に少なくとも 1 つのチェックアウトがある 9e1646bb-57ff-4309-ba59-17d6c5bab6a1

ストリーミングオーディエンスでバッチコンポーネントを使用する場合は、セグメントのセグメントを使用してバッチオーディエンスを参照する必要があります。

したがって、2 つのオーディエンスを組み合わせるルールセットの例を次に示します。

code language-none 
inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and
CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false))
WHEN(<= 24 hours before now)])

結果のオーディエンス は、バッチオーディエンスコンポーネントを参照することでバッチオーディエンスのメンバーシップを活用するので、ストリーミングセグメント化を使用して評価されます。

ただし、2 つのオーディエンスをイベントデータと組み合わせる場合は、2 つのイベントのみを組み合わせる はできません。 両方のオーディエンスを作成し、inSegment を使用して両方のオーディエンスを参照する別のオーディエンスを作成します。

例えば、2 つのオーディエンスがあり、両方のオーディエンスにエクスペリエンスイベントスキーマデータが格納されているとします。

table 0-row-5 1-row-5 2-row-5
オーディエンス スキーマ ソースタイプ クエリ定義 オーディエンス ID
最近の中断 エクスペリエンスイベント バッチ Has at least one abandon event in the last 24 hours e3be6d7f-1727-401f-a41e-c296b45f607a
最近のチェックアウト エクスペリエンスイベント ストリーミング 過去 24 時間以内に少なくとも 1 つのチェックアウトがある 9e1646bb-57ff-4309-ba59-17d6c5bab6a1

この場合は、次のように 3 つ目のオーディエンスを作成する必要があります。

code language-none 
inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and inSegment("9e1646bb-57ff-4309-ba59-17d6c5bab6a1")
note important
IMPORTANT
ルールセットに一致する既存のセグメント定義はすべて、編集されるまでストリーミングまたはエッジセグメント化を使用して評価されます。
さらに、他のストリーミングセグメント化評価条件またはエッジセグメント化評価条件を現在満たしている既存のセグメント定義はすべて、ストリーミングセグメント化またはエッジセグメント化で引き続き評価されます。

結合ポリシー merge-policy

ストリーミングまたはエッジセグメント化の対象となる 新規または編集 セグメント定義は 必ず、「Edgeでアクティブ」結合ポリシー上にある必要があります。

アクティブな結合ポリシーが設定されていない場合は、​ 結合ポリシーを設定 ​ し、エッジでアクティブに設定する必要があります。

style
shade-box

ストリーミングセグメント化は、データの豊富さを重視しながら、ほぼリアルタイムでAdobe Experience Platformのオーディエンスを評価する機能です。

ストリーミングセグメント化を使用すると、ストリーミングデータがExperience Platformに到着する際にオーディエンスの選定が行われるので、セグメント化ジョブをスケジュールして実行する必要がなくなります。 これにより、データをExperience Platformに渡す際に評価し、オーディエンスメンバーシップを自動的に最新の状態に保つことができます。

適格なルールセット rulesets

IMPORTANT
ストリーミングセグメント化を使用するには、「Edgeでアクティブ な結合ポリシーを使用する 必要があります。 結合ポリシーについて詳しくは、結合ポリシーの概要を参照してください。

A ruleset will be eligible for streaming segmentation if it meets any of the criteria outlined in the following table.

NOTE
ストリーミングセグメント化を機能させるには、スケジュールされたセグメント化を組織で有効にする必要があります。 スケジュールに沿ったセグメント化を有効にする方法について詳しくは、Audience Portal の概要 ​ を参照してください。
クエリタイプ
詳細
クエリ
例
24 時間未満の時間枠内での単一イベント
24 時間未満の時間枠内に 1 つの受信イベントを参照する任意のセグメント定義。
CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])
相対時間枠内の単一イベントの例
プロファイルのみ
プロファイル属性のみを参照するセグメント定義。
homeAddress.country.equals("Canada", false)
表示されるプロファイル属性の例
24 時間未満の相対時間枠内でのプロファイル属性を持つ単一のイベント
Any segment definition that refers to a single incoming event, with one or more profile attributes, and occurs within a relative time window of less than 24 hours.
workAddress.country.equals("Canada", false) and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])
相対時間枠内にプロファイル属性を持つ単一イベントの例
Multiple events within a relative time window of 24 hours
過去 24 時間以内に​複数のイベントを参照し、（オプションで）1 つ以上のプロファイル属性を持つ任意のセグメント定義。
workAddress.country.equals("US", false) and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("directMarketing.emailClicked", false)) WHEN(today), C1: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])
プロファイル属性を持つ複数イベントの例

次のシナリオでは、セグメント定義はストリーミングセグメント化の対象 なります 対象外）。

  • セグメント定義には、Adobe Audience Manager（AAM）のセグメントまたは特性が含まれます。
  • セグメント定義には複数のエンティティ（複数エンティティクエリ）が含まれます。
  • セグメント定義には、単一のイベントと inSegment イベントの組み合わせが含まれます。
    • 例えば、1 つのルールセットで次の要素を連結します。inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(<= 24 hours before now)])
  • セグメント定義では、時間制約の一部として「年を無視」を使用します。

ストリーミングセグメント化クエリに適用される次のガイドラインに注意してください。

クエリタイプ
ガイドライン
単一のイベントルールセット
ルックバックウィンドウは 1 日​に制限されています。
イベント履歴を含むクエリ
  • ルックバックウィンドウは 1 日​に制限されています。
  • イベント間に厳密な時間順序条件が存在する​必要があります。
  • 少なくとも 1 つの否定イベントを含むクエリがサポートされています。 ただし、イベント全体を否定することは​できません。

セグメント定義を変更して、ストリーミングセグメント化の条件を満たさなくなった場合、セグメント定義は自動的に「ストリーミング」から「バッチ」に切り替わります。

また、セグメントの選定解除は、セグメントの選定と同様に、リアルタイムで発生します。その結果、オーディエンスがセグメントの選定対象ではなくなった場合、そのオーディエンスはただちに選定解除となります。例えば、セグメント定義で「過去 3 時間で赤い靴を購入したすべてのユーザー」という要求があった場合、3 時間後に、最初にセグメント定義で選定されたすべてのプロファイルが無効になります。

オーディエンスの組み合わせ combine-audiences

バッチソースとストリーミングソースの両方のデータを組み合わせるには、バッチコンポーネントとストリーミングコンポーネントを別々のオーディエンスに分離する必要があります。

プロファイル属性とエクスペリエンスイベント profile-and-event

例えば、次の 2 つのサンプルオーディエンスを考慮します。

オーディエンス
スキーマ
ソースタイプ
クエリ定義
オーディエンス ID
カリフォルニア住民
プロファイル
バッチ
住所はカリフォルニア州です
e3be6d7f-1727-401f-a41e-c296b45f607a
最近のチェックアウト
エクスペリエンスイベント
ストリーミング
過去 24 時間以内に少なくとも 1 つのチェックアウトがある
9e1646bb-57ff-4309-ba59-17d6c5bab6a1

ストリーミングオーディエンスでバッチコンポーネントを使用する場合は、セグメントのセグメントを使用してバッチオーディエンスを参照する必要があります。

したがって、2 つのオーディエンスを組み合わせるルールセットの例を次に示します。

inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and
CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false))
WHEN(<= 24 hours before now)])

結果のオーディエンス は、バッチオーディエンスコンポーネントを参照することでバッチオーディエンスのメンバーシップを活用するので、ストリーミングセグメント化を使用して評価されます。

複数のエクスペリエンスイベント two-events

複数のオーディエンスをイベントデータと組み合わせる場合は、イベントを組み合わせるだけ できません。 各イベントのオーディエンスを作成したあと、すべてのオーディエンスを参照する inSegment を使用する別のオーディエンスを作成する必要があります。

例えば、2 つのオーディエンスがあり、両方のオーディエンスにエクスペリエンスイベントスキーマデータが格納されているとします。

オーディエンス
スキーマ
ソースタイプ
クエリ定義
オーディエンス ID
最近の中断
エクスペリエンスイベント
バッチ
過去 48 時間に 1 つ以上の中断イベントがある
7deb246a-49b4-4687-95f9-6316df049948
最近のチェックアウト
エクスペリエンスイベント
ストリーミング
過去 24 時間以内に少なくとも 1 つのチェックアウトがある
9e1646bb-57ff-4309-ba59-17d6c5bab6a1

この場合は、次のように 3 つ目のオーディエンスを作成する必要があります。

inSegment("7deb246a-49b4-4687-95f9-6316df049948) and inSegment("9e1646bb-57ff-4309-ba59-17d6c5bab6a1")

オーディエンスを作成 create-audience

Segmentation Service API または UI のオーディエンスポータルを使用して、ストリーミングセグメント化を使用して評価されるオーディエンスを作成できます。

セグメント定義が ​ 適格なルールセット ​ のいずれかと一致する場合、ストリーミングを有効にすることができます。

Segmentation Service API

API 形式

code language-http 
POST /segment/definitions

リクエスト

accordion
ストリーミングセグメント化が有効なセグメント定義を作成するリクエストの例
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/segment/definitions
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '{
        "name": "People in the USA",
        "description: "An audience that looks for people who live in the USA",
        "expression": {
            "type": "PQL",
            "format": "pql/text",
            "value": "homeAddress.country = \"US\""
        },
        "evaluationInfo": {
            "batch": {
                "enabled": false
            },
            "continuous": {
                "enabled": true
            },
            "synchronous": {
                "enabled": false
            }
        },
        "schema": {
            "name": "_xdm.context.profile"
        }
     }'

応答

リクエストが成功した場合は、新しく作成したセグメント定義の詳細と HTTP ステータス 200 が返されます。

accordion
セグメント定義を作成する際のサンプルレスポンス。
code language-json 
{
    "id": "4afe34ae-8c98-4513-8a1d-67ccaa54bc05",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "profileInstanceId": "ups",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "28e74200-e3de-11e9-8f5d-7f27416c5f0d",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "name": "People in the USA",
    "description": "An audience that looks for people who live in the USA",
    "expression": {
        "type": "PQL",
        "format": "pql/text",
        "value": "homeAddress.country = \"US\""
    },
    "evaluationInfo": {
        "batch": {
            "enabled": false
        },
        "continuous": {
            "enabled": true
        },
        "synchronous": {
            "enabled": false
        }
    },
    "dataGovernancePolicy": {
        "excludeOptOut": true
    },
    "creationTime": 0,
    "updateEpoch": 1579292094,
    "updateTime": 1579292094000
}

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

オーディエンスポータル

Audience Portal で、「Create audience」を選択します。

オーディエンスを作成ボタンは、オーディエンスポータルでハイライト表示されます。

ポップオーバーが表示されます。 「Build rules」を選択して、セグメントビルダーに入ります。

オーディエンスを作成ポップオーバーで「ルールを作成」ボタンがハイライト表示されます。

セグメントビルダー内で、​ 適格なルールセット ​ の 1 つに一致するセグメント定義を作成します。 セグメント定義がストリーミングセグメント化の対象になると、Streaming を Evaluation method として選択できるようになります。

The segment definition is displayed. 評価タイプがハイライト表示され、ストリーミングセグメント化を使用してセグメント定義を評価できることが示されています。

セグメント定義の作成について詳しくは、セグメントビルダーガイドを参照してください。

オーディエンスの取得 retrieve-audiences

Segmentation Service API または UI のオーディエンスポータルを使用して、ストリーミングセグメント化を使用して評価されるすべてのオーディエンスを取得できます。

Segmentation Service API

/segment/definitions エンドポイントに対してGET リクエストを行い、組織内でストリーミングセグメント化を使用して評価されるすべてのセグメント定義のリストを取得します。

API 形式

ストリーミングセグメント化を使用して評価されたセグメント定義を取得するには、リクエストパスにクエリパラメーター evaluationInfo.synchronous.enabled=true を含める必要があります。

code language-http 
GET /segment/definitions?evaluationInfo.continuous.enabled=true

リクエスト

accordion
ストリーミングが有効なすべてのセグメント定義を一覧表示するサンプルリクエスト
code language-shell 
curl -X GET 'https://platform.adobe.io/data/core/ups/segment/definitions?evaluationInfo.continuous.enabled=true' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

応答

応答に成功すると、HTTP ステータス 200 が、ストリーミングセグメント化が有効になっている組織内のセグメント定義の配列と共に返されます。

accordion
組織内のストリーミングセグメント化が有効なすべてのセグメント定義のリストを含むサンプル応答
code language-json 
{
    "segments": [
        {
            "id": "15063cb-2da8-4851-a2e2-bf59ddd2f004",
            "schema": {
                "name": "_xdm.context.profile"
            },
            "ttlInDays": 30,
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxId": "",
                "sandboxName": "",
                "type": "production",
                "default": true
            },
            "name": " People who are NOT on their homepage ",
            "expression": {
                "type": "PQL",
                "format": "pql/text",
                "value": "select var1 from xEvent where var1._experience.analytics.endUser.firstWeb.webPageDetails.isHomePage = false"
            },
            "evaluationInfo": {
                "batch": {
                    "enabled": false
                },
                "continuous": {
                    "enabled": true
                },
                "synchronous": {
                    "enabled": false
                }
            },
            "creationTime": 1572029711000,
            "updateEpoch": 1572029712000,
            "updateTime": 1572029712000
        },
        {
            "id": "f15063cb-2da8-4851-a2e2-bf59ddd2f004",
            "schema": {
                "name": "_xdm.context.profile"
            },
            "ttlInDays": 30,
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxId": "",
                "sandboxName": "",
                "type": "production",
                "default": true
            },
            "name": "Homepage_continuous",
            "description": "People who are on their homepage - continuous",
            "expression": {
                "type": "PQL",
                "format": "pql/text",
                "value": "select var1 from xEvent where var1._experience.analytics.endUser.firstWeb.webPageDetails.isHomePage = true"
            },
            "evaluationInfo": {
                "batch": {
                    "enabled": true
                },
                "continuous": {
                    "enabled": true
                },
                "synchronous": {
                    "enabled": false
                }
            },
            "creationTime": 1572021085000,
            "updateEpoch": 1572021086000,
            "updateTime": 1572021086000
        }
    ],
    "page": {
        "totalCount": 2,
        "totalPages": 1,
        "sortField": "creationTime",
        "sort": "desc",
        "pageSize": 2,
        "limit": 100
    },
    "link": {}
}

返されるセグメント定義について詳しくは、セグメント定義エンドポイントガイドを参照してください。
オーディエンスポータル

オーディエンスポータルのフィルターを使用すると、組織内でストリーミングセグメント化が有効になっているすべてのオーディエンスを取得できます。 フィルターアイコン アイコンを選択して、フィルターのリストを表示します。

Audience Portal でフィルターアイコンがハイライト表示されています。

使用可能なフィルター内で、Update frequency に移動し、「Streaming」を選択します。 このフィルターを使用すると、ストリーミングセグメント化を使用して評価された、組織内のすべてのオーディエンスが表示されます。

ストリーミングの更新頻度が選択され、ストリーミングセグメント化を使用して評価される組織内のすべてのオーディエンスが表示されます。

Experience Platformでのオーディエンスの表示について詳しくは、​ オーディエンスポータルガイド ​ を参照してください。

オーディエンスの詳細 audience-details

ストリーミングセグメント化を使用して評価された特定のオーディエンスの詳細を、オーディエンスポータル内で選択して表示できます。

オーディエンスポータルでオーディエンスを選択すると、オーディエンスの詳細ページが表示されます。 オーディエンスの詳細の概要、選定されたプロファイルの量の推移、オーディエンスがアクティブ化されている宛先など、オーディエンスに関する情報が表示されます。

ストリーミングセグメント化を使用して評価されたオーディエンスに関するオーディエンスの詳細ページが表示されます。

ストリーミングが有効なオーディエンスの場合は、Profiles over time カードが表示され、合計選定オーディエンス数と新しいオーディエンス更新済み指標が表示されます。

Total qualified 指標は、このオーディエンスのバッチおよびストリーミングの評価に基づいた、選定オーディエンスの合計数を表します。

New audience updated 指標は、ストリーミングセグメント化によるオーディエンスサイズの変化を示す折れ線グラフで表されます。 ドロップダウンを調整して、過去 24 時間、先週または過去 30 日間を表示できます。

プロファイルの推移カードがハイライト表示されています。

オーディエンスの詳細については、​ オーディエンスポータルの概要 ​ を参照してください。

次の手順

このガイドでは、ストリーミングが有効なセグメント定義がAdobe Experience Platformでどのように機能するか、およびストリーミングが有効なセグメント定義をどのように監視するかについて説明します。

Adobe Experience Platform ユーザーインターフェイスの使用について詳しくは、セグメント化ユーザーガイドを参照してください。

ストリーミングセグメント化に関するよくある質問については、FAQ のストリーミングセグメント化の節 ​ を参照してください。

770bc05d-534a-48a7-9f07-017ec1e14871