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

エッジセグメント化ガイド

最終更新日： 2026年5月24日

作成対象：

  • User

Edgeのセグメント化は、エッジ 🔗上のAdobe Experience Platformでセグメント定義を即座に評価し、同じページと次のページのパーソナライズのユースケースを可能にします。

IMPORTANT
エッジデータは、収集された場所に最も近いエッジサーバーの場所に保存されます。 このデータは、ハブ（またはプリンシパル）Adobe Experience Platformデータセンターとして指定された場所以外の場所に保存することもできます。
エッジセグメンテーションエンジンは、エッジベース以外のプライマリ IDと一致するプライマリマーク IDが​ one ​あるエッジ上のリクエストのみを受け付けます。
さらに、エッジセグメンテーションはリクエストを大規模に処理するように設計されているため、エッジサーバーは必要なメタデータを動的に読み込みます。 その結果、最初の呼び出しでは、サンドボックスのタイプに関係なく「コールドスタート」待ち時間が発生する場合があります。 このウィンドウでは、最初のいくつかの評価呼び出しでタイムアウトが発生する場合があります。 簡単な事前ウォームバーストまたは現実的な負荷は、偽陽性のテスト失敗を排除するのに役立ちます。

エッジセグメント化のクエリタイプ query-types

次の表に示す条件のいずれかを満たす場合、クエリはエッジセグメント化で評価できます。

NOTE
クエリが次の表のいずれかのクエリタイプと一致する場合、エッジセグメント化を使用して自動的に評価されます。 クエリ式に基づいて、システムがこの機能を自動的に判断します。
さらに、オーディエンス only​にプロファイル属性が含まれている場合は、毎日評価されます。 オーディエンスをリアルタイムで評価するには、イベントデータをオーディエンスに追加する必要があります。
クエリタイプ
詳細
クエリ
例
24時間未満の時間枠内での単一イベント
24時間未満の時間枠内で、単一の受信イベントを参照するセグメント定義。
CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])
相対時間枠内の単一イベントの例 {modal="regular"}
プロファイルのみ
プロファイル属性のみを参照するセグメント定義。
homeAddress.country.equals("US", false)
表示されているプロファイル属性の例。 {modal="regular"}
プロファイル属性が24時間未満の相対時間枠内に存在する単一のイベント
1つ以上のプロファイル属性を持つ単一の受信イベントを参照し、24時間未満の相対時間時間枠内で発生するセグメント定義。
workAddress.country.equals("US", false) and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])
相対時間枠内にプロファイル属性を持つ単一イベントの例 {modal="regular"}
セグメントのセグメント
1つ以上のバッチ セグメントまたはエッジ セグメントを含むセグメント定義。 メモ：​セグメントのセグメントが使用される場合、24 時間ごとに​プロファイルの不選定が発生します。
inSegment("a730ed3f-119c-415b-a4ac-27c396ae2dff") and inSegment("8fbbe169-2da6-4c9d-a332-b6a6ecf559b9")
セグメントのセグメントの例 {modal="regular"}

さらに、セグメント定義​ は ​をエッジ上でアクティブな結合ポリシーに関連付ける必要があります。 結合ポリシーの詳細については、結合ポリシーガイドを参照してください。

セグメント定義は、次のシナリオでは​ not ​でエッジセグメント化の対象となります。

  • セグメント定義には、単一のイベントと inSegment イベントの組み合わせが含まれています。
    • ただし、inSegment イベントに含まれるセグメント定義がプロファイルのみの場合、セグメント定義はエッジセグメント化に対して有効に​なります。
  • セグメント定義では、時間制約の一部として「年を無視」を使用します。

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

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

セグメント定義は、適格なクエリタイプ ​のいずれかに一致する場合、エッジを有効にすることができます。

セグメント サービス 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": false
            },
            "synchronous": {
                "enabled": true
            }
        },
        "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": false
        },
        "synchronous": {
            "enabled": true
        }
    },
    "dataGovernancePolicy": {
        "excludeOptOut": true
    },
    "creationTime": 0,
    "updateEpoch": 1579292094,
    "updateTime": 1579292094000
}

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

オーディエンスポータル

オーディエンスポータルで、Create audience​を選択します。

​ オーディエンスポータルで「オーディエンスを作成」ボタンが強調表示されます。 {modal="regular"}

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

​ オーディエンスを作成ポップオーバーで「ルールを作成」ボタンが強調表示されます。 {modal="regular"}

セグメントビルダー内で、適格なクエリタイプ ​のいずれかに一致するセグメント定義を作成します。 セグメント定義がエッジ セグメント化に適格である場合は、Edge​を​ Evaluation method ​として選択できます。

​ セグメント定義が表示されます。 評価タイプがハイライト表示され、エッジ セグメント化を使用してセグメント定義を評価できることを示しています。 {modal="regular"}

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

エッジセグメント化を使用して評価されたオーディエンスを取得する retrieve-audiences

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

セグメント サービス API

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

API 形式

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

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

リクエスト

accordion
エッジが有効なすべてのセグメント定義を一覧表示するサンプルリクエスト
code language-shell 
curl -X GET \
  'https://platform.adobe.io/data/core/ups/segment/definitions?evaluationInfo.synchronous.enabled=true' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -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"
            },
            "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": false
                },
                "synchronous": {
                    "enabled": true
                }
            },
            "creationTime": 1572029711000,
            "updateEpoch": 1572029712000,
            "updateTime": 1572029712000
        },
        {
            "id": "f15063cb-2da8-4851-a2e2-bf59ddd2f004",
            "schema": {
                "name": "_xdm.context.profile"
            },
            "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": false
                },
                "continuous": {
                    "enabled": false
                },
                "synchronous": {
                    "enabled": true
                }
            },
            "creationTime": 1572021085000,
            "updateEpoch": 1572021086000,
            "updateTime": 1572021086000
        }
    ],
    "page": {
        "totalCount": 2,
        "totalPages": 1,
        "sortField": "creationTime",
        "sort": "desc",
        "pageSize": 2,
        "limit": 100
    },
    "link": {}
}

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

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

​ フィルターアイコンがオーディエンスポータルで強調表示されます。 {modal="regular"}

使用可能なフィルター内で、更新頻度​に移動し、「Edge」を選択します。 このフィルターを使用すると、エッジセグメント化を使用して評価された組織内のすべてのオーディエンスが表示されます。

Edgeの更新頻度が選択され、エッジセグメント化を使用して評価された組織内のすべてのオーディエンスが表示されます。 {modal="regular"}

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

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

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

オーディエンスポータルでオーディエンスを選択すると、オーディエンスの詳細ページが表示されます。 これにより、オーディエンスの詳細の要約、時間の経過に伴う適格プロファイルの量、オーディエンスがアクティブ化された宛先など、オーディエンスに関する情報が表示されます。

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

エッジ対応オーディエンスの場合は、Profiles over time カードが表示され、合計適格オーディエンス数と新しいオーディエンス更新指標が表示されます。

Total qualified​指標は、このオーディエンスのエッジ評価に基づいて、選定されたオーディエンスの合計数を表します。

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

時間の経過に伴うプロファイル カードがハイライト表示されます。 {modal="regular"}

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

次の手順

このガイドでは、エッジセグメント化とは何かを説明します。また、Adobe Experience Platformでエッジセグメント化を使用して評価できるセグメント定義を作成する方法についても説明します。

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

エッジセグメント化に関するよくある質問については、FAQ🔗の「 エッジセグメント化」の節を参照してください。

recommendation-more-help
experience-platform-help-segmentation