流式分段指南

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上激活”合并策略中。

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

流式分段是在关注数据丰富性的同时,近乎实时地评估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
最近结帐
体验事件
流式处理
在过去24小时内至少有一个结帐
9e1646bb-57ff-4309-ba59-17d6c5bab6a1

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

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

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

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

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

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

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

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

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

创建受众 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": {}
}

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

受众门户

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

受众门户中突出显示了过滤器图标。

在可用筛选器内,转到​ 更新频率 ​并选择“流式传输”。 使用此过滤器可显示贵组织中通过流式分段评估的所有受众。

选择了流式更新频率,显示组织中使用流式分段评估的所有受众。

要了解有关在Experience Platform中查看受众的更多信息,请阅读受众门户指南

受众详情 audience-details

您可以在受众门户中选择使用流式分段评估的特定受众,以查看该受众的详细信息。

在Audience Portal中选择受众后,将显示受众详细信息页面。 该屏幕可显示有关受众的信息,包括受众详细信息摘要、一段时间内符合条件的配置文件数量以及受众激活到的目标。

为使用流式分段评估的受众显示受众详细信息页面。

对于启用流处理的受众,将显示​ 随时间变化的配置文件 ​卡,其中显示符合条件的总量度和新受众更新的量度。

合格受众总数 ​指标表示基于此受众的批次和流式评估的合格受众总数。

新受众已更新 ​量度由一个折线图表示,该折线图显示通过流式分段而发生的受众规模变化。 您可以调整下拉菜单以显示过去24小时、上周或过去30天。

已突出显示“随时间变化的配置文件”信息卡。

有关受众详细信息的更多详细信息,请阅读受众门户概述

后续步骤

本指南介绍启用流的区段定义如何在Adobe Experience Platform上工作以及如何监测启用流的区段定义。

要了解有关使用Adobe Experience Platform用户界面的更多信息,请参阅分段用户指南

有关流式客户细分的常见问题,请阅读常见问题解答🔗的流式客户细分部分。

770bc05d-534a-48a7-9f07-017ec1e14871