文件Experience Platform分段服務指南

受眾端點

Last update: Thu Feb 29 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • Developer

對象是具有相同類似行為和/或特徵的人集合。 這些人員集合可透過使用Adobe Experience Platform或外部來源產生。 您可以使用 /audiences 區段API中的端點，可讓您以程式設計方式擷取、建立、更新和刪除對象。

快速入門

本指南中使用的端點屬於 Adobe Experience Platform Segmentation Service API。 在繼續之前，請檢閱 快速入門手冊 如需成功呼叫API所需的重要資訊，包括必要的標題以及如何讀取範例API呼叫。

擷取對象清單 list

您可以透過向以下網站發出GET請求，擷取貴組織的所有對象清單： /audiences 端點。

API格式

此 /audiences 端點支援數個查詢引數，以協助篩選結果。 雖然這些引數是選用的，但強烈建議使用這些引數，以幫助在列出資源時減少昂貴的額外負荷。 如果您不使用引數呼叫此端點，則會擷取貴組織可用的所有對象。 可包含多個引數，以&符號(&)。

GET /audiences
GET /audiences?{QUERY_PARAMETERS}

擷取對象清單時，可以使用以下查詢引數：

查詢引數
說明
範例
start
指定傳回對象的開始位移。
start=5
limit
指定每頁傳回的最大對象數。
limit=10
sort
指定排序結果的順序。 這會以格式撰寫 attributeName:[desc/asc].
sort=updateTime:desc
property
可讓您指定受眾的篩選器 完全符合 符合屬性的值。 這會以格式撰寫 property=
property=audienceId==test-audience-id
name
可讓您指定名稱為的對象的篩選器 contain 提供的值。 此值不區分大小寫。
name=Sample
description
可讓您指定其說明的對象的篩選器 contain 提供的值。 此值不區分大小寫。
description=Test Description

要求

以下請求會擷取貴組織中建立的最後兩個對象。

擷取對象清單的範例要求。
code language-shell 
curl -X GET https: //platform.adobe.io/data/core/ups/audiences?limit=2 \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

成功的回應會傳回HTTP狀態200，其中包含貴組織中建立為JSON的對象清單。

此範例回應包含屬於您組織的最後兩個已建立對象
code language-json 
{
    "children": [
        {
            "id": "60ccea95-1435-4180-97a5-58af4aa285ab",
            "audienceId": "60ccea95-1435-4180-97a5-58af4aa285ab",
            "schema": {
                "name": "_xdm.context.profile"
            },
            "ttlInDays": 60,
            "profileInstanceId": "ups",
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxId": "6ed34f6f-fe21-4a30-934f-6ffe21fa3075",
                "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\""
            },
            "mergePolicyId": "ef006bbe-750e-4e81-85f0-0c6902192dcc",
            "evaluationInfo": {
                "batch": {
                    "enabled": false
                },
                "continuous": {
                    "enabled": true
                },
                "synchronous": {
                    "enabled": false
                }
            },
            "dataGovernancePolicy": {
                "excludeOptOut": true
            },
            "isSystem": false,
            "creationTime": 1650374572000,
            "updateEpoch": 1650374573,
            "updateTime": 1650374573000,
            "createEpoch": 1650374572,
            "_etag": "\"33120d7c-0000-0200-0000-625eb7ad0000\"",
            "dependents": [],
            "definedOn": [
                {
                    "meta: resourceType": "unions",
                    "meta: containerId": "tenant",
                    "$ref": "https: //ns.adobe.com/xdm/context/profile__union"
                }
            ],
            "dependencies": [],
            "type": "SegmentDefinition",
            "originName": "REAL_TIME_CUSTOMER_PROFILE",
            "overridePerformanceWarnings": false,
            "createdBy": "{CREATED_BY_ID}",
            "lifecycleState": "published",
            "labels": [
                "core/C1"
            ],
            "namespace": "AEPSegments"
        },
        {
            "id": "32a83b5d-a118-4bd6-b3cb-3aee2f4c30a1",
            "audienceId": "test-external-audience-id",
            "name": "externalSegment1",
            "namespace": "aam",
            "imsOrgId": "{ORG_ID}",
            "sandbox":{
                "sandboxId": "6ed34f6f-fe21-4a30-934f-6ffe21fa3075",
                "sandboxName": "prod",
                "type": "production",
                "default": true
            },
            "isSystem": false,
            "description": "Last 30 days",
            "type": "ExternalSegment",
            "originName": "CUSTOM_UPLOAD",
            "lifecycleState": "published",
            "createdBy": "{CREATED_BY_ID}",
            "datasetId": "6254cf3c97f8e31b639fb14d",
            "labels":[
                "core/C1"
            ],
            "linkedAudienceRef": {
                "flowId": "4685ea90-d2b6-11ec-9d64-0242ac120002"
            },
            "creationTime": 1642745034000000,
            "updateEpoch": 1649926314,
            "updateTime": 1649926314000,
            "createEpoch": 1642745034
        }
    ],
    "_page":{
      "totalCount": 111,
      "pageSize": 2,
      "next": "1"
   },
   "_links":{
      "next":{
         "href":"@/audiences?start=1&limit=2&totalCount=111"
      }
   }
}
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 18-row-3
屬性 對象型別 說明
id 兩者 適用於對象的系統產生唯讀識別碼。
audienceId 兩者 如果對象是平台產生的對象，此值與 id. 如果對象是外部產生的，此值由使用者端提供。
schema 兩者 對象的Experience Data Model (XDM)結構。
imsOrgId 兩者 對象所屬組織的ID。
sandbox 兩者 有關受眾所屬沙箱的資訊。 有關沙箱的更多資訊可在以下連結中找到： 沙箱總覽.
name 兩者 對象名稱。
description 兩者 對象說明。
expression 平台產生 對象的設定檔查詢語言(PQL)運算式。 如需PQL運算式的詳細資訊，請參閱 PQL運算式指南.
mergePolicyId 平台產生 與對象相關聯的合併原則ID。 有關合併原則的更多資訊可在以下網址找到： 合併原則指南.
evaluationInfo 平台產生 顯示評估對象的方式。 可能的評估方法包括批次、同步（串流）或連續（邊緣）。 有關評估方法的詳細資訊，請參閱 分段總覽
dependents 兩者 相依於目前受眾的受眾ID陣列。 如果您建立的對象是區段的區段，就會使用此屬性。
dependencies 兩者 對象所依賴的對象ID陣列。 如果您建立的對象是區段的區段，就會使用此屬性。
type 兩者 系統產生的欄位，顯示對象是平台產生的還是外部產生的對象。 可能的值包括 SegmentDefinition 和 ExternalSegment. A SegmentDefinition 是指在Platform中產生的對象，而 ExternalSegment 是指不是在Platform中產生的對象。
originName 兩者 參照對象來源名稱的欄位。 對於平台產生的對象，此值將為 REAL_TIME_CUSTOMER_PROFILE. 若為Audience Orchestration中產生的對象，此值將為 AUDIENCE_ORCHESTRATION. 若為在Adobe Audience Manager中產生的對象，此值會是 AUDIENCE_MANAGER. 對於其他外部產生的對象，此值將為 CUSTOM_UPLOAD.
createdBy 兩者 建立對象的使用者ID。
labels 兩者 與對象相關的物件層級資料使用情況和屬性型存取控制標籤。
namespace 兩者 對象所屬的名稱空間。 可能的值包括 AAM， AAMSegments， AAMTraits、和 AEPSegments.
linkedAudienceRef 兩者 包含其他受眾相關系統識別碼的物件。

建立新對象 create

您可以透過向以下傳送POST請求來建立新對象： /audiences 端點。

API格式

POST /audiences

要求

平台產生的對象
accordion
用於建立平台產生對象的範例請求
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/audiences
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -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",
        "type": "SegmentDefinition",
        "expression": {
            "type": "PQL",
            "format": "pql/text",
            "value": "workAddress.country = \"US\""
        },
        "schema": {
            "name": "_xdm.context.profile"
        },
        "labels": [
          "core/C1"
        ],
        "ttlInDays": 60
    }'
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
屬性 說明
name 對象名稱。
description 對象說明。
type 顯示對象是平台產生還是外部產生對象的欄位。 可能的值包括 SegmentDefinition 和 ExternalSegment. A SegmentDefinition 是指在Platform中產生的對象，而 ExternalSegment 是指不是在Platform中產生的對象。
expression 對象的設定檔查詢語言(PQL)運算式。 如需PQL運算式的詳細資訊，請參閱 PQL運算式指南.
schema 對象的Experience Data Model (XDM)結構。
labels 與對象相關的物件層級資料使用情況和屬性型存取控制標籤。
ttlInDays 代表對象的資料到期值（以天為單位）。
外部產生的對象
accordion
建立外部產生對象的範例要求
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/audiences
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '{
        "audienceId":"test-external-audience-id",
        "name":"externalAudience",
        "namespace":"aam",
        "description":"Last 30 days",
        "type":"ExternalSegment",
        "originName":"CUSTOM_UPLOAD",
        "lifecycleState":"published",
        "datasetId":"6254cf3c97f8e31b639fb14d",
        "labels":[
            "core/C1"
        ],
        "linkedAudienceRef":{
            "flowId": "4685ea90-d2b6-11ec-9d64-0242ac120002"
        }
    }'
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 10-row-2 11-row-2
屬性 說明
audienceId 使用者提供給對象的ID。
name 對象名稱。
namespace 對象的名稱空間。
description 對象說明。
type 顯示對象是平台產生還是外部產生對象的欄位。 可能的值包括 SegmentDefinition 和 ExternalSegment. A SegmentDefinition 是指在Platform中產生的對象，而 ExternalSegment 是指不是在Platform中產生的對象。
originName 對象來源的名稱。 對於外部產生的對象，其預設值為 CUSTOM_UPLOAD. 其他支援的值包括 REAL_TIME_CUSTOMER_PROFILE， CUSTOM_UPLOAD， AUDIENCE_ORCHESTRATION、和 AUDIENCE_MATCH.
lifecycleState 此選用欄位會決定您嘗試建立的對象初始狀態。 支援的值包括 draft， published、和 inactive.
datasetId 可以找到包含對象之資料的資料集ID。
labels 與對象相關的物件層級資料使用情況和屬性型存取控制標籤。
audienceMeta 屬於外部產生對象的中繼資料。
linkedAudienceRef

包含其他對象相關系統識別碼的物件。 這可能包括下列專案：

  • flowId：此ID可用來將受眾連線至用來匯入受眾資料的資料流。 如需關於所需ID的詳細資訊，請參閱 建立資料流指南.
  • aoWorkflowId：此ID可用來將受眾連結至相關的Audience Orchestration構成。</li/>
  • payloadFieldGroupRef：此ID是用來參照描述對象結構的XDM欄位群組結構描述。 有關此欄位值的詳細資訊，請參閱 XDM欄位群組端點指南.
  • audienceFolderId：此ID是用來參照對象的Adobe Audience Manager資料夾ID。 有關此API的更多資訊，請參閱 Adobe Audience Manager API指南.

回應

成功的回應會傳回HTTP狀態200，其中包含您新建立之對象的相關資訊。

平台產生的對象
accordion
擷取平台產生的對象時的範例回應。
code language-json 
{
    "id": "60ccea95-1435-4180-97a5-58af4aa285ab",
    "audienceId": "60ccea95-1435-4180-97a5-58af4aa285ab",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "ttlInDays": 60,
    "profileInstanceId": "ups",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "6ed34f6f-fe21-4a30-934f-6ffe21fa3075",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "isSystem": false,
    "name": "People who ordered in the last 30 days",
    "description": "Last 30 days",
    "expression": {
        "type": "PQL",
        "format": "pql/text",
        "value": "workAddress.country = \"US\""
    },
    "mergePolicyId": "ef006bbe-750e-4e81-85f0-0c6902192dcc",
    "evaluationInfo": {
        "batch": {
            "enabled": false
        },
        "continuous": {
            "enabled": true
        },
        "synchronous": {
            "enabled": false
        }
    },
    "dataGovernancePolicy": {
        "excludeOptOut": true
    },
    "creationTime": 1650374572000,
    "updateEpoch": 1650374573,
    "updateTime": 1650374573000,
    "createEpoch": 1650374572,
    "_etag": "\"33120d7c-0000-0200-0000-625eb7ad0000\"",
    "dependents": [],
    "definedOn": [
        {
            "meta:resourceType": "unions",
            "meta:containerId": "tenant",
            "$ref": "https://ns.adobe.com/xdm/context/profile__union"
        }
    ],
    "dependencies": [],
    "type": "SegmentDefinition",
    "overridePerformanceWarnings": false,
    "createdBy": "{CREATED_BY_ID}",
    "lifecycleState": "active",
    "labels": [
        "core/C1"
    ],
    "namespace": "AEPSegments"
}
外部產生的對象
accordion
擷取外部產生的對象時的範例回應。
code language-json 
{
    "id": "60ccea95-1435-4180-97a5-58af4aa285ab",
    "audienceId": "test-external-audience-id",
    "name": "externalAudience",
    "namespace": "aam",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "6ed34f6f-fe21-4a30-934f-6ffe21fa3075",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "isSystem": false,
    "description": "Last 30 days",
    "type": "ExternalSegment",
    "lifecycleState": "active",
    "createdBy": "{CREATED_BY_ID}",
    "datasetId": "6254cf3c97f8e31b639fb14d",
    "labels": [
        "core/C1"
    ],
    "_etag": "\"f4102699-0000-0200-0000-625cd61a0000\"",
    "creationTime": 1650251290000,
    "updateEpoch": 1650251290,
    "updateTime": 1650251290000,
    "createEpoch": 1650251290
}

更新對象中的欄位 update-field

您可以透過向以下連結發出PATCH請求，更新特定對象的欄位： /audiences 端點，並提供您要在請求路徑中更新的對象ID。

API格式

PATCH /audiences/{AUDIENCE_ID}
參數
說明
{AUDIENCE_ID}
您要更新的對象ID。 請注意，這是 id 欄位，為 非 此 audienceId 欄位。

要求

更新對象中欄位的範例請求。
code language-shell 
curl -X PATCH https://platform.adobe.io/data/core/ups/audiences/4afe34ae-8c98-4513-8a1d-67ccaa54bc05 \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '
     [
        {
            "op": "add",
            "path": "/expression",
            "value": {
                "type": "PQL",
                "format": "pql/text",
                "value": "workAddress.country = \"CA\""
            }
        }
      ]'
table 0-row-2 1-row-2 2-row-2 3-row-2
屬性 說明
op 若要更新對象，此值一律為 add.
path 您要更新的欄位路徑。
value 您要更新欄位的值。

回應

成功的回應會傳回HTTP狀態200，其中包含您新更新對象的資訊。

更新對象中欄位時的範例回應。
code language-json 
{
    "id": "60ccea95-1435-4180-97a5-58af4aa285ab",
    "audienceId": "60ccea95-1435-4180-97a5-58af4aa285ab",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "ttlInDays": 60,
    "profileInstanceId": "ups",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "6ed34f6f-fe21-4a30-934f-6ffe21fa3075",
        "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 = \"CA\""
    },
    "mergePolicyId": "ef006bbe-750e-4e81-85f0-0c6902192dcc",
    "evaluationInfo": {
        "batch": {
          "enabled": false
        },
        "continuous": {
          "enabled": true
        },
        "synchronous": {
          "enabled": false
        }
    },
    "dataGovernancePolicy": {
      "excludeOptOut": true
    },
    "creationTime": 1650374572000,
    "updateEpoch": 1650374573,
    "updateTime": 1650374573000,
    "createEpoch": 1650374572,
    "_etag": "\"33120d7c-0000-0200-0000-625eb7ad0000\"",
    "dependents": [],
    "definedOn": [
        {
          "meta:resourceType": "unions",
          "meta:containerId": "tenant",
          "$ref": "https://ns.adobe.com/xdm/context/profile__union"
        }
    ],
    "dependencies": [],
    "type": "SegmentDefinition",
    "overridePerformanceWarnings": false,
    "createdBy": "{CREATED_BY_ID}",
    "lifecycleState": "active",
    "labels": [
      "core/C1"
    ],
    "namespace": "AEPSegments"
}

更新對象 put

您可以向發出PUT請求，更新（覆寫）特定對象。 /audiences 端點，並提供您要在請求路徑中更新的對象ID。

API格式

PUT /audiences/{AUDIENCE_ID}
參數
說明
{AUDIENCE_ID}
您要更新的對象ID。 請注意，這是 id 欄位，為 非 此 audienceId 欄位。

要求

更新整個對象的範例要求。
code language-shell 
curl -X PUT https://platform.adobe.io/data/core/ups/audiences/4afe34ae-8c98-4513-8a1d-67ccaa54bc05 \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '{
    "audienceId": "test-external-audience-id",
    "name": "New external audience",
    "namespace": "aam",
    "description": "Last 30 days",
    "type": "ExternalSegment",
    "lifecycleState": "published",
    "datasetId": "6254cf3c97f8e31b639fb14d",
    "labels": [
        "core/C1"
    ]
}'
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
屬性 說明
audienceId 對象的ID。 對於外部產生的對象，此值可由使用者提供。
name 對象名稱。
namespace 對象的名稱空間。
description 對象說明。
type 系統產生的欄位，顯示對象是平台產生的還是外部產生的對象。 可能的值包括 SegmentDefinition 和 ExternalSegment. A SegmentDefinition 是指在Platform中產生的對象，而 ExternalSegment 是指不是在Platform中產生的對象。
lifecycleState 對象的狀態。 可能的值包括 draft， published、和 inactive. draft 代表建立對象的時間， published 發佈對象時，以及 inactive 對象不再作用中時。
datasetId 可找到對象資料的資料集ID。
labels 與對象相關的物件層級資料使用情況和屬性型存取控制標籤。

回應

成功的回應會傳回HTTP狀態200以及您新更新對象的詳細資料。 請注意，您的對象詳細資訊會因平台產生的對象或外部產生的對象而有所不同。

更新整個對象時的範例回應。
code language-json 
{
    "id": "4afe34ae-8c98-4513-8a1d-67ccaa54bc05",
    "audienceId": "test-external-audience-id",
    "name": "New external audience",
    "namespace": "aam",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "6ed34f6f-fe21-4a30-934f-6ffe21fa3075",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "description": "Last 30 days",
    "type": "ExternalSegment",
    "lifecycleState": "published",
    "createdBy": "{CREATED_BY_ID}",
    "datasetId": "6254cf3c97f8e31b639fb14d",
    "_etag": "\"f4102699-0000-0200-0000-625cd61a0000\"",
    "creationTime": 1650251290000,
    "updateEpoch": 1650251290,
    "updateTime": 1650251290000,
    "createEpoch": 1650251290
}

刪除對象 delete

您可以向以下網站發出DELETE請求，刪除特定對象： /audiences 端點，並在請求路徑中提供您要刪除之對象的ID。

API格式

DELETE /audiences/{AUDIENCE_ID}
參數
說明
{AUDIENCE_ID}
您要刪除的對象的ID。 請注意，這是 id 欄位，為 非 此 audienceId 欄位。

要求

刪除對象的範例要求。
code language-shell 
curl -X DELETE https://platform.adobe.io/data/core/ups/audiences/60ccea95-1435-4180-97a5-58af4aa285ab5 \
 -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狀態204且沒有訊息。

擷取多個對象 bulk-get

您可以向以下網站發出POST請求，擷取多個對象： /audiences/bulk-get 端點，並提供您要擷取之對象的ID。

API格式

POST /audiences/bulk-get

要求

擷取多個對象的範例要求。
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/audiences/bulk-get
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d ' {
    "ids": [
        {
            "id": "72c393ea-caed-441a-9eb6-5f66bb1bd6cd"
        },
        {
            "id": "QU9fLTEzOTgzNTE0MzY0NzY0NDg5NzkyOTkx_6ed34f6f-fe21-4a30-934f-6ffe21fa3075"
        }
    ]
 }

回應

成功的回應會傳回HTTP狀態207，其中包含您要求對象的資訊。

擷取多個對象時的範例回應。
code language-json 
{
   "results":{
      "72c393ea-caed-441a-9eb6-5f66bb1bd6cd":{
         "id": "72c393ea-caed-441a-9eb6-5f66bb1bd6cd",
         "audienceId": "72c393ea-caed-441a-9eb6-5f66bb1bd6cd",
         "schema": {
            "name": "_xdm.context.profile"
         },
         "ttlInDays": 30,
         "imsOrgId": "{ORG_ID}",
         "sandbox": {
            "sandboxId": "6ed34f6f-fe21-4a30-934f-6ffe21fa3075",
            "sandboxName": "prod",
            "type": "production",
            "default": true
         },
         "name": "Sample audience",
         "expression": {
            "type": "pql",
            "format": "pql/text",
            "value": "_id = \"abc\""
        },
         "mergePolicyId": "87c94d51-239c-4391-932c-29c2412100e5",
         "evaluationInfo": {
            "batch": {
               "enabled": false
            },
            "continuous": {
               "enabled": true
            },
            "synchronous": {
               "enabled": false
            }
         },
         "ansibleUiEnabled": false,
         "dataGovernancePolicy": {
            "excludeOptOut": true
         },
         "creationTime": 1623889553000000,
         "updateEpoch": 1674646369,
         "updateTime": 1674646369000,
         "createEpoch": 1623889552,
         "_etag": "\"61030ec7-0000-0200-0000-63d113610000\"",
         "dependents": [],
         "definedOn": [
            {
               "meta:resourceType": "unions",
               "meta:containerId": "tenant",
               "$ref": "https://ns.adobe.com/xdm/context/profile__union"
            }
         ],
         "dependencies": [],
         "type": "SegmentDefinition",
         "state": "enabled",
         "overridePerformanceWarnings": false,
         "lastModifiedBy": "{CREATED_ID}",
         "lifecycleState": "published",
         "namespace": "AEPSegments",
         "isSystem": false,
         "saveSegmentMembership": true,
         "originName": "REAL_TIME_CUSTOMER_PROFILE"
      },
      "QU9fLTEzOTgzNTE0MzY0NzY0NDg5NzkyOTkx_6ed34f6f-fe21-4a30-934f-6ffe21fa3075":{
         "id": "QU9fLTEzOTgzNTE0MzY0NzY0NDg5NzkyOTkx_6ed34f6f-fe21-4a30-934f-6ffe21fa3075",
         "name": "label test24764489707692",
         "namespace": "AO",
         "imsOrgId": "{ORG_ID}",
         "sandbox":{
            "sandboxId": "6ed34f6f-fe21-4a30-934f-6ffe21fa3075",
            "sandboxName": "prod",
            "type": "production",
            "default": true
         },
         "type": "ExternalSegment",
         "lifecycleState": "published",
         "sourceId": "source-id",
         "createdBy": "{USER_ID}",
         "datasetId": "62bf31a105e9891b63525c92",
         "_etag": "\"3100da6d-0000-0200-0000-62bf31a10000\"",
         "creationTime": 1656697249000,
         "updateEpoch": 1656697249,
         "updateTime": 1656697249000,
         "createEpoch": 1656697249,
         "audienceId": "test-audience-id",
         "isSystem": false,
         "saveSegmentMembership": true,
         "linkedAudienceRef": {
            "aoWorkflowId": "62bf31858e87e34c8364befa"
         },
         "originName": "AUDIENCE_ORCHESTRATION"
      }
   }
}

後續步驟

閱讀本指南後，您現在已更能瞭解如何使用Adobe Experience Platform API建立、管理和刪除對象。 如需使用UI進行對象管理的詳細資訊，請參閱 分段UI指南.

recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871