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

セグメント定義エンドポイント

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

作成対象：

  • Developer
WARNING
Segmentation Service APIを使用したB2B エンティティを使用したオーディエンスの作成は推奨されません。 アカウント、アカウントと人物の関係、キャンペーン、キャンペーンメンバー、マーケティングリスト、マーケティングリストメンバー、商談、商談と人物の関係というB2B エンティティを使用してオーディエンスを作成できなくなりました。 詳しくは、Real-Time CDP B2B edition アーキテクチャのアップグレード ​に関するガイドを参照してください。

Adobe Experience Platformでは、プロファイルのグループから特定の属性や行動のグループを定義するセグメント定義を作成できます。 セグメント定義は、Profile Query Language （PQL）で記述されたクエリをカプセル化するオブジェクトです。 セグメント定義は、オーディエンスを作成するためにプロファイルに適用されます。 このオブジェクト（セグメント定義）は、PQL述語とも呼ばれます。 PQLの述語は、Real-Time Customer Profileに提供する任意のレコードまたは時系列データに関連する条件に基づいて、セグメント定義のルールを定義します。 PQL クエリの記述について詳しくは、PQL ガイドを参照してください。

このガイドでは、セグメント定義をより深く理解するための情報を提供し、APIを使用して基本的なアクションを実行するためのAPI呼び出しの例を紹介します。

はじめに

このガイドで使用されているエンドポイントは、Adobe Experience Platform Segmentation Service APIの一部です。 続行する前に、必須ヘッダーやサンプル API呼び出しの読み取り方法など、APIへの呼び出しを正常に行うために知っておく必要がある重要な情報については、入門ガイド ​を確認してください。

セグメント定義のリストの取得 list

組織のすべてのセグメント定義のリストを取得するには、/segment/definitions エンドポイントにGET リクエストを実行します。

API 形式

/segment/definitions エンドポイントは、結果を絞り込むのに役立つ、複数のクエリパラメーターをサポートしています。 これらのパラメーターはオプションですが、高価なオーバーヘッドを減らすために使用することを強くお勧めします。 パラメーターなしで、このエンドポイントを呼び出すと、組織で使用可能なすべてのセグメント定義が取得されます。 複数のパラメーターを使用する場合は、アンパサンド（&）で区切ります。

GET /segment/definitions
GET /segment/definitions?{QUERY_PARAMETERS}

クエリパラメータ

使用可能なクエリパラメーターのリスト。
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
パラメーター 説明 例
start 返されるセグメント定義の開始オフセットを指定します。 start=4
limit 返される、1 ページあたりのセグメント定義の数を指定します。 limit=20
page どのページからセグメント定義の結果を表示するかを指定します。 page=5
sort 結果を並べ替えるフィールドを指定します。 は次の形式で記述されます：[attributeName]:[desc/asc]。 sort=updateTime:desc
evaluationInfo.continuous.enabled セグメント定義でストリーミングを有効にするかどうかを指定します。 evaluationInfo.continuous.enabled=true

リクエスト

次のリクエストは、組織内に投稿された最後の2つのセグメント定義を取得します。

セグメント定義のリストを取得するためのサンプルリクエスト。
code language-shell 
curl -X GET https://platform.adobe.io/data/core/ups/segment/definitions?limit=2 \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

応答

応答が成功すると、HTTP ステータス 200が返され、指定した組織のセグメント定義のリストがJSONとして返されます。

セグメント定義のリストを取得する際のサンプル応答。
code language-json 
{
    "segments": [
        {
            "id": "3da8bad9-29fb-40e0-b39e-f80322e964de",
            "schema": {
                "name": "_xdm.context.profile"
            },
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxId": "28e74200-e3de-11e9-8f5d-7f27416c5f0d",
                "sandboxName": "prod",
                "type": "production",
                "default": true
            },
            "name": "segment",
            "description": "",
            "expression": {
                "type": "PQL",
                "format": "pql/json",
                "value": "{PQL_EXPRESSION}"
            },
            "mergePolicyId": "b83185bb-0bc6-489c-9363-0075eb30b4c8",
            "evaluationInfo": {
                "batch": {
                    "enabled": true
                },
                "continuous": {
                    "enabled": false
                },
                "synchronous": {
                    "enabled": false
                }
            },
            "dataGovernancePolicy": {
                "excludeOptOut": true
            },
            "creationTime": 1573253640000,
            "baselineTime": 1574327114,
            "updateEpoch": 1575588309,
            "updateTime": 1575588309000
        },
        {
            "id": "ca763983-5572-4ea4-809c-b7dff7e0d79b",
            "schema": {
                "name": "_xdm.context.profile"
            },
            "imsOrgId": "{ORG_ID}",
            "name": "test segment",
            "description": "",
            "expression": {
                "type": "PQL",
                "format": "pql/json",
                "value": "{PQL_EXPRESSION}"
            },
            "mergePolicyId": "b83185bb-0bc6-489c-9363-0075eb30b4c8",
            "evaluationInfo": {
                "batch": {
                    "enabled": true
                },
                "continuous": {
                    "enabled": false
                },
                "synchronous": {
                    "enabled": false
                }
            },
            "dataGovernancePolicy": {
                "excludeOptOut": true
            },
            "creationTime": 1561073779000,
            "baselineTime": 1574327114,
            "updateEpoch": 1574327114,
            "updateTime": 1574327114000
        }
    ],
    "page": {
        "totalCount": 2,
        "totalPages": 1,
        "sortField": "creationTime",
        "sort": "desc",
        "pageSize": 2,
        "limit": 100
    },
    "link": {}
}

新しいセグメント定義の作成 create

新しいセグメント定義を作成するには、/segment/definitions エンドポイントに POST リクエストを実行します。

IMPORTANT
API で作成されたセグメント定義は、 セグメント ビルダーを使用して編集できません。

API 形式

POST /segment/definitions

リクエスト

新しいセグメント定義を作成する場合は、pql/textまたはpql/json形式で作成できます。

pql/textの使用
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 who ordered in the last 30 days",
        "description": "Last 30 days",
        "expression": {
            "type": "PQL",
            "format": "pql/text",
            "value": "workAddress.country = \"US\""
        },
        "evaluationInfo": {
            "batch": {
                "enabled": true
            },
            "continuous": {
                "enabled": false
            },
            "synchronous": {
                "enabled": false
            }
        },
        "schema": {
            "name": "_xdm.context.profile"
        }
    }'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2
プロパティ 説明
name セグメント定義を参照する一意の名前。
description （オプション）作成するセグメント定義の説明。
expression セグメント定義に関するフィールド情報を含むエンティティ。
expression.type 式タイプを指定します。 現時点では、「PQL」のみサポートされています。
expression.format 値内の式の構造を示します。 サポートされている値には、pql/textとpql/jsonが含まれます。
expression.value expression.format に指定されたタイプに適合する式です。
evaluationInfo （オプション）作成するセグメント定義のタイプ。 バッチセグメントを作成する場合は、evaluationInfo.batch.enabledをtrueに設定します。 ストリーミングセグメントを作成する場合は、evaluationInfo.continuous.enabledをtrueに設定します。 エッジ セグメントを作成する場合は、evaluationInfo.synchronous.enabledをtrueに設定します。 空のままにすると、セグメント定義は​バッチ セグメントとして作成されます。
schema セグメント内のエンティティに関連付けられたスキーマ。 id か name のどちらかのフィールドで構成されます。
pql/jsonの使用
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 who ordered in the last 30 days",
        "profileInstanceId": "ups",
        "description": "Last 30 days",
        "expression": {
            "type": "PQL",
            "format": "pql/json",
            "value": "{\"nodeType\":\"fnApply\",\"fnName\":\"=\",\"params\":[{\"nodeType\":\"fieldLookup\",\"fieldName\":\"a\",\"object\":{\"nodeType\":\"parameterReference\",\"position\":1}},{\"nodeType\":\"fieldLookup\",\"fieldName\":\"b\",\"object\":{\"nodeType\":\"parameterReference\",\"position\":1}}]}"
        },
        "evaluationInfo": {
            "batch": {
                "enabled": true
            },
            "continuous": {
                "enabled": false
            },
            "synchronous": {
                "enabled": false
            }
        },
        "schema": {
            "name": "_xdm.context.profile"
        },
        "payloadSchema": "string"
    }'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2
プロパティ 説明
name セグメント定義を参照する一意の名前。
description （オプション）作成するセグメント定義の説明。
evaluationInfo （オプション）作成するセグメント定義のタイプ。 バッチセグメントを作成する場合は、evaluationInfo.batch.enabledをtrueに設定します。 ストリーミングセグメントを作成する場合は、evaluationInfo.continuous.enabledをtrueに設定します。 エッジ セグメントを作成する場合は、evaluationInfo.synchronous.enabledをtrueに設定します。 空のままにすると、セグメント定義は​バッチ セグメントとして作成されます。
schema セグメント内のエンティティに関連付けられたスキーマ。 id か name のどちらかのフィールドで構成されます。
expression セグメント定義に関するフィールド情報を含むエンティティ。
expression.type 式タイプを指定します。 現時点では、「PQL」のみサポートされています。
expression.format 値内の式の構造を示します。
expression.value expression.format に指定されたタイプに適合する式です。

応答

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

セグメント定義を作成する際の応答のサンプル。
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 who ordered in the last 30 days",
    "description": "Last 30 days",
    "expression": {
        "type": "PQL",
        "format": "pql/text",
        "value": "workAddress.country = \"US\""
    },
    "evaluationInfo": {
        "batch": {
            "enabled": true
        },
        "continuous": {
            "enabled": false
        },
        "synchronous": {
            "enabled": false
        }
    },
    "dataGovernancePolicy": {
        "excludeOptOut": true
    },
    "creationTime": 0,
    "updateEpoch": 1579292094,
    "updateTime": 1579292094000
}
table 0-row-2 1-row-2 2-row-2
プロパティ 説明
id 新しく作成したセグメント定義のシステム生成ID。
evaluationInfo セグメント定義が受ける評価の種類を示すオブジェクト。 バッチ、ストリーミング（継続的とも呼ばれます）、エッジ（同期とも呼ばれます）の各セグメンテーションを使用できます。

特定のセグメント定義の取得 get

特定のセグメント定義に関する詳細な情報を取得するには、/segment/definitions エンドポイントにGET リクエストを行い、取得するセグメント定義のIDをリクエストパスに指定します。

API 形式

GET /segment/definitions/{SEGMENT_ID}
パラメーター
説明
{SEGMENT_ID}
取得するセグメント定義のid値。

リクエスト

セグメント定義を取得するためのサンプルリクエスト。
code language-shell 
curl -X GET https://platform.adobe.io/data/core/ups/segment/definitions/4afe34ae-8c98-4513-8a1d-67ccaa54bc05 \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

応答

リクエストが成功した場合は、特定のセグメント定義についての詳細情報と HTTP ステータス 200 が返されます。

セグメント定義を取得する際のサンプル応答。
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 who ordered in the last 30 days",
    "description": "Last 30 days",
    "expression": {
        "type": "PQL",
        "format": "pql/text",
        "value": "workAddress.country = \"US\""
    },
    "evaluationInfo": {
        "batch": {
            "enabled": true
        },
        "continuous": {
            "enabled": false
        },
        "synchronous": {
            "enabled": false
        }
    },
    "dataGovernancePolicy": {
        "excludeOptOut": true
    },
    "creationTime": 0,
    "updateEpoch": 1579292094,
    "updateTime": 1579292094000
}
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2
プロパティ 説明
id セグメント定義のシステム生成の読み取り専用ID。
name セグメント定義を参照する一意の名前。
schema セグメント内のエンティティに関連付けられたスキーマ。 id か name のどちらかのフィールドで構成されます。
expression セグメント定義に関するフィールド情報を含むエンティティ。
expression.type 式タイプを指定します。 現時点では、「PQL」のみサポートされています。
expression.format

値内の式の構造を示します。 現時点では、次の形式がサポートされています。

  • pql/text：セグメント定義のテキスト表現で、公開された PQL 文法に従っている必要があります。 例：workAddress.stateProvince = homeAddress.stateProvince
expression.value expression.format に指定されたタイプに適合する式です。
description 人間にとってわかりやすい、定義の説明。
evaluationInfo 評価、バッチ、ストリーミング（継続的とも呼ばれます）、エッジ（同期とも呼ばれます）のタイプを示すオブジェクトで、セグメント定義が実行されます。

セグメント定義の一括取得 bulk-get

指定された複数のセグメント定義に関する詳細情報を取得するには、/segment/definitions/bulk-get エンドポイントにPOST リクエストを行い、リクエスト本文にセグメント定義のid値を指定します。

API 形式

POST /segment/definitions/bulk-get

リクエスト

一括取得エンドポイントを使用する場合のサンプルリクエスト。
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/segment/definitions/bulk-get \
  -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 '{
        "ids": [
            {
                "id": "54669488-03ab-4e0d-a694-37fe49e32be8"
            },
            {
                "id": "4afe34ae-8c98-4513-8a1d-67ccaa54bc05"
            }
        ]
    }'
table 0-row-2 1-row-2
プロパティ 説明
ids 取得するセグメント定義のIDを示すオブジェクトを含む配列。

応答

応答が成功すると、リクエストされたセグメント定義を含むHTTP ステータス 207が返されます。

一括取得エンドポイントを使用する場合の応答のサンプル。
code language-json 
{
    "results": {
        "54669488-03ab-4e0d-a694-37fe49e32be8": {
            "id": "54669488-03ab-4e0d-a694-37fe49e32be8",
            "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 who ordered in the last 30 days",
            "description": "Last 30 days",
            "expression": {
                "type": "PQL",
                "format": "pql/text",
                "value": "workAddress.country = \"US\""
            },
            "evaluationInfo": {
                "batch": {
                    "enabled": true
                },
                "continuous": {
                    "enabled": false
                },
                "synchronous": {
                    "enabled": false
                }
            },
            "dataGovernancePolicy": {
                "excludeOptOut": true
            },
            "creationTime": 0,
            "updateEpoch": 1579292094,
            "updateTime": 1579292094000
        },
        "4afe34ae-8c98-4513-8a1d-67ccaa54bc05": {
            "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 who ordered in the last 30 days",
            "description": "Last 30 days",
            "expression": {
                "type": "PQL",
                "format": "pql/text",
                "value": "workAddress.country = \"US\""
            },
            "evaluationInfo": {
                "batch": {
                    "enabled": true
                },
                "continuous": {
                    "enabled": false
                },
                "synchronous": {
                    "enabled": false
                }
            },
            "dataGovernancePolicy": {
                "excludeOptOut": true
            },
            "creationTime": 0,
            "updateEpoch": 1579292094,
            "updateTime": 1579292094000
        }

    }
}
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2
プロパティ 説明
id セグメント定義のシステム生成の読み取り専用ID。
name セグメント定義を参照する一意の名前。
schema セグメント内のエンティティに関連付けられたスキーマ。 id か name のどちらかのフィールドで構成されます。
expression セグメント定義に関するフィールド情報を含むエンティティ。
expression.type 式タイプを指定します。 現時点では、「PQL」のみサポートされています。
expression.format

値内の式の構造を示します。 現時点では、次の形式がサポートされています。

  • pql/text：セグメント定義のテキスト表現で、公開された PQL 文法に従っている必要があります。 例：workAddress.stateProvince = homeAddress.stateProvince
expression.value expression.format に指定されたタイプに適合する式です。
description 人間にとってわかりやすい、定義の説明。
evaluationInfo 評価、バッチ、ストリーミング（継続的とも呼ばれます）、エッジ（同期とも呼ばれます）のタイプを示すオブジェクトで、セグメント定義が実行されます。

特定のセグメント定義の削除 delete

/segment/definitions エンドポイントに対してDELETE リクエストを行い、削除するセグメント定義のIDをリクエストパスに指定することで、特定のセグメント定義の削除をリクエストできます。

NOTE
宛先アクティベーション で使用されているセグメント定義を削除できません。

API 形式

DELETE /segment/definitions/{SEGMENT_ID}
パラメーター
説明
{SEGMENT_ID}
削除するセグメント定義のid値。

リクエスト

セグメント定義を削除するためのサンプルリクエスト。
code language-shell 
curl -X DELETE https://platform.adobe.io/data/core/ups/segment/definitions/4afe34ae-8c98-4513-8a1d-67ccaa54bc05 \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

応答

リクエストが成功した場合、HTTP ステータス 200 が返され、メッセージは返されません。

特定のセグメント定義の更新

/segment/definitions エンドポイントに対してPATCH リクエストを行い、更新するセグメント定義のIDをリクエストパスで指定することで、特定のセグメント定義を更新できます。

API 形式

PATCH /segment/definitions/{SEGMENT_ID}
パラメーター
説明
{SEGMENT_ID}
更新するセグメント定義のid値。

リクエスト

次のリクエストは、米国からカナダへの勤務先国を更新します。

NOTE
このAPI呼び出しは​ セグメント定義の内容を ​置き換えるので、all​保持するフィールドがリクエスト本文の一部として含まれていることを確認してください。
セグメント定義を更新するためのサンプルリクエスト。
code language-shell 
curl -X PATCH https://platform.adobe.io/data/core/ups/segment/definitions/4afe34ae-8c98-4513-8a1d-67ccaa54bc05 \
 -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 '
{
    "id": "4afe34ae-8c98-4513-8a1d-67ccaa54bc05",
    "name": "Updated people who ordered in the last 30 days",
    "profileInstanceId": "ups",
    "description": "Last 30 days",
    "expression": {
        "type": "PQL",
        "format": "pql/text",
        "value": "workAddress.country = \"CA\""
    },
    "schema": {
        "name": "_xdm.context.profile"
    },
    "payloadSchema": "string",
    "creationTime": 0,
    "updateTime": 0,
    "updateEpoch": 0
}'

応答

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

セグメント定義を更新する際のサンプル応答。
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": "Updated people who ordered in the last 30 days",
    "description": "Last 30 days",
    "expression": {
        "type": "PQL",
        "format": "pql/text",
        "value": "workAddress.country = \"CA\""
    },
    "evaluationInfo": {
        "batch": {
            "enabled": true
        },
        "continuous": {
            "enabled": false
        },
        "synchronous": {
            "enabled": false
        }
    },
    "dataGovernancePolicy": {
        "excludeOptOut": true
    },
    "creationTime": 0,
    "updateEpoch": 1579295340,
    "updateTime": 1579295340000
}

セグメント定義の変換

/segment/conversion エンドポイントにPOST リクエストを行うことで、pql/textからpql/jsonまたはpql/jsonからpql/textまでのセグメント定義を変換できます。

API 形式

POST /segment/conversion

リクエスト

次のリクエストは、セグメント定義の形式をpql/textからpql/jsonに変更します。

セグメント定義を変換するためのサンプルリクエスト。
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/segment/conversion \
 -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 who ordered in the last 30 days",
        "profileInstanceId": "ups",
        "description": "Last 30 days",
        "expression": {
            "type": "PQL",
            "format": "pql/text",
            "value": "workAddress.country = \"US\""
        },
        "schema": {
            "name": "_xdm.context.profile"
        },
        "payloadSchema": "string"
    }'

応答

応答が成功すると、HTTP ステータス 200が、新しく変換されたセグメント定義の詳細とともに返されます。

セグメント定義を変換する際のサンプル応答。
code language-json 
{
    "imsOrgId": "6A29340459CA8D350A49413A@AdobeOrg",
    "sandbox": {
        "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "description": "Last 30 days",
    "expression": {
        "type": "PQL",
        "format": "pql/json",
        "value": "{\"nodeType\":\"fnApply\",\"fnName\":\"=\",\"params\":[{\"nodeType\":\"fieldLookup\",\"fieldName\":\"country\",\"object\":{\"nodeType\":\"fieldLookup\",\"fieldName\":\"workAddress\",\"object\":{\"nodeType\":\"parameterReference\",\"position\":1}}},{\"nodeType\":\"literal\",\"literalType\":\"String\",\"value\":\"US\"}]}"
    }
}

次の手順

このガイドでは、セグメント定義の仕組みについて解説します。 セグメントの作成について詳しくは、​ セグメントの作成 チュートリアルを参照してください。

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