串流分段指南

最後更新： 2025年2月21日

主題：

建立對象：

使用者

串流細分是近乎即時評估Adobe Experience Platform中的受眾，同時專注於資料豐富度的能力。

有了串流區隔，現在當串流資料登陸至Platform時，就能進行對象資格，減少排程及執行區隔工作的需求。這可讓您在資料傳入Platform時評估資料，讓對象成員資格自動保持在最新狀態。

合格的查詢型別

如果查詢符合下表所列的任何條件，將有資格進行串流分段。

NOTE

為了讓串流細分發揮作用，您需要為組織啟用已排程的分段。如需啟用排程細分的詳細資訊，請參閱對象入口網站概觀。

查詢型別	詳細資料	查詢
少於24小時時間範圍內的單一事件	任何會參照少於24小時之時間範圍內的單一傳入事件的區段定義。	`CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])`
僅限設定檔	僅參考設定檔屬性的任何區段定義。	`homeAddress.country.equals("US", false)`
在少於24小時的相對時間範圍內，具有設定檔屬性的單一事件	任何區段定義，會參照具有一或多個設定檔屬性的單一傳入事件，且會在少於24小時的相對時間範圍內發生。	`workAddress.country.equals("US", false) and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])`
區段區段	包含一或多個批次或串流區段的任何區段定義。注意：如果使用區段區段，則設定檔取消資格將每24小時發生一次。	`inSegment("a730ed3f-119c-415b-a4ac-27c396ae2dff") and inSegment("8fbbe169-2da6-4c9d-a332-b6a6ecf559b9")`
具有設定檔屬性的多個事件	任何在過去24小時內參考多個事件且（選擇性）具有一或多個設定檔屬性的區段定義。	`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事件的組合。
- 但是，如果inSegment事件中包含的區段定義僅為設定檔，則區段定義將啟用串流分段。
區段定義會使用「忽略年份」作為其時間限制的一部分。

請注意下列適用於串流細分查詢的准則：

查詢型別	方針
單一事件查詢	回顧期間沒有限制。
使用事件歷史記錄進行查詢	回顧期間限製為一天。事件之間必須有嚴格的時間排序條件且。支援至少具有一個否定事件的查詢。不過，整個事件不可為否定。

如果區段定義經過修改，使其不再符合串流區段的條件，則區段定義會自動從「串流」切換為「批次」。

此外，區段取消資格（類似於區段資格）會即時發生。因此，如果對象不再符合區段的資格，則會立即取消資格。例如，如果區段定義要求「過去三小時內購買紅鞋子的所有使用者」，三小時後，所有最初符合區段定義資格的設定檔都將不合格。

建立客群

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

如果區段定義符合合格的查詢型別之一，則可以啟用串流功能。

分段服務API

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": false
            },
            "continuous": {
                "enabled": true
            },
            "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": false
        },
        "continuous": {
            "enabled": true
        },
        "synchronous": {
            "enabled": false
        }
    },
    "dataGovernancePolicy": {
        "excludeOptOut": true
    },
    "creationTime": 0,
    "updateEpoch": 1579292094,
    "updateTime": 1579292094000
}

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

Audience Portal

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

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

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

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

在區段產生器中，建立符合合格查詢型別之一的區段定義。如果區段定義符合串流區段的資格，您就可以選取串流作為 評估方法。

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

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

擷取對象

您可以使用Segmentation Service API或透過UI中的對象入口網站，擷取使用串流細分評估的所有對象。

分段服務API

向/segment/definitions端點發出GET要求，以擷取使用組織內串流細分評估的所有區段定義清單。

API格式

您必須在要求路徑中包含查詢引數evaluationInfo.synchronous.enabled=true，以擷取使用串流細分評估的區段定義。

GET /segment/definitions?evaluationInfo.continuous.enabled=true

要求

列出所有已啟用串流之區段定義的範例請求

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，其中包含貴組織中已啟用串流細分的區段定義陣列。

此範例回應包含貴組織中所有已啟用串流區段定義的清單

{
    "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

您可以使用Audience Portal中的篩選條件，擷取貴組織內針對串流細分啟用的所有對象。選取圖示以顯示篩選器清單。