文档 Experience Platform Segmentation Service 指南

流式分段指南

Last update: Tue May 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

用户

recommendation-more-help

NOTE

流式分段资格标准已于2025年5月20日更新。

资格更新

note important
IMPORTANT
除非进行编辑或更新，否则当前使用流分段或边缘分段评估的所有现有区段定义将继续按原样工作。

规则集 ruleset

任何与以下规则集匹配的 新区段或编辑的 区段定义都将 不再使用流式或边缘分段来评估。相反，将使用批次分段来评估这些指标。

时间范围超过24小时的单个事件
- 使用过去3天内查看过网页的所有配置文件激活受众。
没有时间范围的单个事件
- 使用查看过网页的所有配置文件激活受众。

时间窗口 time-window

为了使用流式分段评估受众，必须将其 限制在24小时时间范围内。

在流受众中包含批量数据 include-batch-data

在此更新之前，您可以创建将批处理数据源和流式数据源结合在一起的流式受众定义。但是，通过最新更新，将使用批处理分段来评估使用批处理数据源和流式数据源创建受众。

如果您需要使用与更新后的规则集匹配的流区段或边缘区段来评估区段定义，则需要明确创建批次和流规则集，并使用区段组合它们。此批次规则集必须基于配置文件架构。

例如，假设您有两个受众，其中一个受众住房配置文件架构数据，另一个受众住房体验事件架构数据：

table 0-row-5 1-row-5 2-row-5
受众	架构	Source类型	查询定义	受众 ID
加利福尼亚居民	轮廓	批次	家庭地址在加利福尼亚州	`e3be6d7f-1727-401f-a41e-c296b45f607a`
最近结帐	体验事件	流式处理	在过去24小时内至少有一个结帐	`9e1646bb-57ff-4309-ba59-17d6c5bab6a1`

如果要在流受众中使用批次组件，则需要使用区段引用批次受众。

因此，将两个受众合并在一起的示例规则集如下所示：

code language-none
`inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(<= 24 hours before now)])`

将使用流式分段评估生成的受众**，因为它通过引用批处理受众组件来利用批处理受众的成员资格。

但是，如果要将两个受众与事件数据合并，则不能只合并这两个事件。您需要创建两个受众，然后创建另一个使用inSegment引用这两个受众的受众。

例如，假设您有两个受众，这两个受众都存放体验事件架构数据：

table 0-row-5 1-row-5 2-row-5
受众	架构	Source类型	查询定义	受众 ID
最近放弃	体验事件	批次	在过去24小时内至少具有一个放弃事件	`e3be6d7f-1727-401f-a41e-c296b45f607a`
最近结帐	体验事件	流式处理	在过去24小时内至少有一个结帐	`9e1646bb-57ff-4309-ba59-17d6c5bab6a1`

在这种情况下，您需要创建第三个受众，如下所示：

code language-none
`inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and inSegment("9e1646bb-57ff-4309-ba59-17d6c5bab6a1")`

note important
IMPORTANT
与规则集匹配的所有现有区段定义都将继续使用流区段或边缘区段进行评估，直到编辑它们为止。
此外，当前满足其他流分段或边缘分段评估标准的所有现有区段定义都将保留使用流分段或边缘分段进行评估。

合并策略 merge-policy

任何符合流或边缘分段 资格的 新区段定义或已编辑 区段定义都必须 位于“在Edge上激活”合并策略中。

如果没有活动的合并策略集，您需要配置合并策略并将它设置为在边缘上处于活动状态。

style

shade-box

流式分段是在关注数据丰富性的同时，近乎实时地评估Adobe Experience Platform中的受众的能力。

借助流式分段，现在可以在流式数据进入Experience Platform时进行受众鉴别，从而消除计划和运行分段作业的需求。这样，您就可以在数据传递到Experience Platform时对其进行评估，从而使受众成员资格自动保持最新。

符合条件的规则集 rulesets

IMPORTANT

要使用流式分段，您必须使用“在Edge上处于活动状态”的合并策略。有关合并策略的更多信息，请阅读合并策略概述。

如果规则集符合下表所列的任何标准，则它有资格进行流式分段。

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小时相对时间范围内的多个事件

任何在过去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("e3be6d7f-1727-401f-a41e-c296b45f607a") and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(<= 24 hours before now)])。
区段定义使用“忽略年份”作为其时间限制的一部分。

请注意以下适用于流式分段查询的准则：

查询类型

指南

单事件规则集

回看窗口限制为一天。

使用事件历史记录进行查询

回看窗口限制为一天。
事件之间存在严格的时间排序条件必须。
支持至少具有一个否定事件的查询。但是，整个事件不能是否定。

如果修改了区段定义以使其不再满足流式分段标准，则区段定义将自动从“流式处理”切换到“批处理”。

此外，区段取消资格（与区段资格类似）是实时发生的。因此，如果受众不再符合区段的条件，则将被立即取消资格。例如，如果区段定义要求“过去三小时内购买红鞋的所有用户”，则在三小时后，最初符合区段定义条件的所有用户档案都将被取消资格。

合并受众 combine-audiences

要合并来自批处理源和流式源的数据，您需要将批处理组件和流式组件分离到单独的受众中。

例如，我们考虑以下两个示例受众：

受众

架构

Source类型

查询定义

受众 ID

加利福尼亚居民

轮廓

批次

家庭地址在加利福尼亚州

e3be6d7f-1727-401f-a41e-c296b45f607a

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

有关使用此端点的详细信息，请参阅区段定义端点指南。

受众门户

在受众门户中，选择 创建受众。

受众门户中突出显示“创建受众”按钮。

此时会出现弹出窗口。选择 生成规则 以进入区段生成器。

在“创建受众”弹出框中突出显示“生成规则”按钮。

在区段生成器中，创建一个与个符合条件的规则集之一匹配的区段定义。如果区段定义符合流式分段条件，您将能够选择 流式处理 作为 评估方法。

将显示区段定义。评估类型已突出显示，显示可以使用流式分段评估区段定义。

要了解有关创建区段定义的更多信息，请参阅区段生成器指南

检索受众 retrieve-audiences

您可以使用分段服务API或通过UI中的受众门户检索使用流式分段评估的所有受众。

分段服务API

通过向/segment/definitions端点发出GET请求，检索使用组织内的流式分段评估的所有区段定义的列表。

API格式

您必须在请求路径中包含查询参数evaluationInfo.synchronous.enabled=true，以检索使用流式分段评估的区段定义。

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

请求

accordion

列出所有支持流的区段定义的请求示例

code language-shell

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，其中包含组织中启用流式分段的一系列区段定义。

accordion

一个示例响应，其中包含贵组织中所有支持流式客户细分的区段定义的列表

code language-json

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

有关返回的区段定义的更多详细信息可在区段定义终结点指南中找到。

受众门户

您可以使用受众门户中的过滤器，检索组织中支持流式分段的所有受众。选择图标以显示筛选器列表。