批次分段指南

最後更新： 2025年5月5日
  • 主題：

建立對象：

  • 使用者

批次細分是一種細分評估方法，可讓您一次移動所有設定檔資料，以建立對應的對象。

透過批次分段，您可以建立詳細而豐富的對象，並執行分段工作以決定何時將此資料傳播到下游服務。

合格的查詢型別

所有查詢都符合批次細分的資格。

建立客群

您可以使用Segmentation Service API或透過UI中的對象入口網站，建立使用批次細分來評估的對象。

API格式

POST /segment/definitions

要求

建立已啟用批次細分之區段定義的範例請求
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": true
            },
            "continuous": {
                "enabled": false
            },
            "synchronous": {
                "enabled": false
            }
        },
        "schema": {
            "name": "_xdm.context.profile"
        }
     }'

回應

成功的回應會傳回HTTP狀態200以及您新建立區段定義的詳細資料。

建立區段定義時的範例回應。
{
    "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": true
        },
        "continuous": {
            "enabled": false
        },
        "synchronous": {
            "enabled": false
        }
    },
    "dataGovernancePolicy": {
        "excludeOptOut": true
    },
    "creationTime": 0,
    "updateEpoch": 1579292094,
    "updateTime": 1579292094000
}

在區段定義端點指南中找到有關使用此端點的詳細資訊。

在對象入口網站中，選取​ 建立對象。

對象入口網站中會醒目顯示[建立對象]按鈕。

彈出視窗隨即顯示。 選取​ 建置規則 ​以輸入區段產生器。

「建立對象」彈出視窗中會醒目顯示「建置規則」按鈕。

建立區段定義後，選取​ 批次 ​作為​ 評估方法。

會顯示區段定義。 評估型別已反白顯示，顯示可以使用串流區段來評估區段定義。

若要深入瞭解如何建立區段定義，請參閱區段產生器指南