文档Experience PlatformSegmentation Service 指南

使用灵活的批量计划控制批量受众评估

最近更新： 2026年9月23日

创建对象：

  • User
AVAILABILITY
在​ 有限可用性 ​下，当前提供了灵活的批处理计划。 有关更多信息，请联系Adobe客户关怀部门。

批量分段是一种评估方法，允许您一次移动所有用户档案数据以创建相应的受众。 以前，这些批量受众依赖每天运行一次的单个固定分段作业。

通过灵活的批量计划，您可以控制评估受众的时间，从而更灵活地安排评估计时的优先级，以便更好地扩展到更大的受众量。

创建计划 create-schedule

要使用灵活的批处理计划，您首先需要为受众创建计划。 您可以使用Experience Platform UI或API创建计划。

UI

要使用Experience Platform UI创建计划，您首先需要访问分段服务工作区中的​ 评估 ​部分。

在客户部分中选择​受众，然后选择​评估。

受众和评估按钮突出显示，显示如何访问评估页面。

此时会显示​ 评估 ​页面，该页面显示组织中当前可用的所有计划。 选择​ 创建计划 ​以开始创建计划。

“评估”页面中突出显示“创建计划”按钮。

出现​ 创建计划 ​弹出框。 在此弹出窗口中，您可以填写计划的详细信息，包括名称、节奏和您希望计划运行的时间。 输入所有必需详细信息后，选择​ 创建 ​以继续。

将显示“创建计划”弹出框。

API

要使用Experience Platform API创建计划，您需要向/schedules端点发出POST请求。

API格式

code language-http 
POST /schedules

请求

accordion
创建计划的示例请求。
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules \
 -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": "Weekly VIP refresh",
    "type": "batch_segmentation",
    "schedule": "0 0 10 * * ?",
    "properties": {
        "segments": [
            "sample-audience-1",
            "sample-audience-2"
        ]
    },
    "state": "active"
}'

在创建计划时，您需要提供名称、类型、计划、属于计划的受众及其状态。 有关使用API创建计划的详细信息，请参阅计划终结点指南。

响应

accordion
创建计划时的示例响应。
code language-json 
{
  "id": "cd585edf-962d-420d-94ad-3be03e619ac2",
  "name": "Weekly VIP Refresh",
  "type": "batch_segmentation",
  "schedule": "0 0 10 * * ?",
  "frequency": "weekly",
  "state": "active",
  "properties": {
    "segments": ["sample-audience-1", "sample-audience-2"]
  }
}

成功的响应返回HTTP状态200，其中包含有关您新创建的计划的信息。 frequency字段是自动填充的，基于提供的schedule。

将受众分配给计划 assign-audience

创建计划后，您可以为以前的计划分配其他受众。 您可以使用Experience Platform UI或API分配受众。

UI

要使用Experience Platform UI将受众分配给计划，请选择计划旁边的 省略号图标 ，然后选择​计划受众。

计划受众按钮突出显示。

将显示​ 计划受众 ​弹出框。 选择要添加到计划的受众，然后选择​ 计划 ​以确认计划更改。

将显示“计划受众”弹出框。

API

要使用Experience Platform API将受众分配给计划，您需要向/schedules/add-audiences端点发出POST请求。

API格式

code language-http 
POST /schedules/add-audiences

请求

accordion
向计划添加受众的示例请求。
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/add-audiences \
  -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 '{
        "id": "cd585edf-962d-420d-94ad-3be03e619ac2",
        "segments": [
            "sample-audience-3",
            "sample-audience-4"
        ]
      }'

将受众添加到计划时，您需要提供计划ID以及要添加到计划的受众ID。 有关将受众添加到计划的详细信息，请阅读计划终结点指南。

响应

accordion
将受众添加到计划时成功的响应。
code language-json 
{
    "added": ["sample-audience-3", "sample-audience-4"],
    "existing": [],
    "invalid": [],
    "segmentCount": {
        "previous": 2,
        "current": 4,
        "diff": 2
    }
}

成功的响应会返回HTTP状态200，其中包含有关计划中添加的受众的信息。

或者，您可以在受众创建期间向受众分配计划。 在Audience Builder中，保存受众后，转到受众属性部分的​ 计划 ​部分，然后选择 日历图标 。

出现​ 受众计划 ​弹出框。 在此弹出窗口中，您可以分配受众应属于哪些计划。

将显示“分配计划”弹出框，显示受众属于哪个计划。

查看受众的计划 view-audience-schedule

您可以使用Experience Platform UI或API查看受众属于哪些计划。

UI
note
NOTE
您只能查看使用​ 受众生成器 ​创建的受众的计划。

要使用Experience Platform UI查看受众所属的计划，请转到受众门户并选择受众，然后转到​编辑受众。

在受众生成器中，选择 日历图标 。 在​ 受众属性 ​分区的​ 计划 ​分区中，显示​ 受众计划 ​弹出框。 此弹出框显示受众属于哪些计划，并允许您添加或删除受众属于哪些计划。

将显示“分配计划”弹出框，显示受众属于哪个计划。

API

要使用Experience Platform API查看受众所属的计划，请向/schedules/audience-map端点发出POST请求。

API格式

code language-http 
POST /schedules/audience-map

请求

accordion
查看列出的受众属于哪些计划的示例请求。
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/audience-map \
  -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 '{
        "segments": [
            "sample-audience-1",
            "sample-audience-2"
        ]
      }'

要使用此端点，您需要提供要查看其计划的受众的ID。 有关查看受众所属计划的详细信息，请阅读计划终结点指南。

响应

accordion
检索受众的计划时成功的响应。
code language-json 
{
  "audienceMap": {
    "sample-audience-1": ["cd585edf-962d-420d-94ad-3be03e619ac2"],
    "sample-audience-2": []
  },
  "schedules": {
    "cd585edf-962d-420d-94ad-3be03e619ac2": {
      "name": "Weekly VIP Refresh",
      "schedule": "0 0 10 * * ?",
      "frequency": "weekly"
    }
  }
}

成功的响应会返回HTTP状态200，其中包含有关所请求受众所属计划的详细信息。

从计划中删除受众 remove-audience

如果要从已创建的计划中删除受众，可以使用Experience Platform UI或API。

UI

要使用Experience Platform UI从计划中删除受众，请选择计划旁边的 更多图标 ，然后选择​计划受众。

计划受众按钮突出显示。

将显示​ 计划受众 ​弹出框。 选择要从计划中删除的受众，然后选择​ 计划 ​以确认计划更改。

将显示“计划受众”弹出框。

API

要从计划中删除受众，您需要对/schedules/remove-audiences端点发出POST请求。

API格式

code language-http 
POST /schedules/remove-audiences

请求

accordion
从计划中删除受众的示例请求
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/remove-audiences/
 -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}'
 -d '
 {
    "id": "cd585edf-962d-420d-94ad-3be03e619ac2",
    "segments": [
        "sample-audience-1"
    ]
 }
 '

在从计划中删除受众时，您需要提供计划ID以及要从计划中删除的受众ID。 有关将受众删除计划的详细信息，请阅读计划终结点指南。

响应

accordion
从计划中删除受众时的成功响应。
code language-json 
{
    "removed": ["sample-audience-1"],
    "existing": [],
    "invalid": [],
    "segmentCount": {
        "previous"
    }
}

手动运行计划 run-manually

您可以手动触发现有计划，以使用Experience Platform UI或API运行，而不是等待计划运行。

UI

要在Experience Platform UI中手动运行计划，请在​ 评估 ​页面中选择要评估的计划旁边的 更多图标 ，然后选择​运行计划。

已突出显示“运行计划”按钮。

此时会出现确认弹出窗口。 选择​ 启动 ​以立即开始运行计划。

将显示“运行计划”弹出框。

API

要在Experience Platform API中手动运行计划，您需要向/schedules/trigger端点发出POST请求。

API格式

code language-http 
POST /schedules/trigger

请求

accordion
触发计划评估的示例请求。
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/trigger \
  -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 '{
    "id": "cd585edf-962d-420d-94ad-3be03e619ac2"
    }'

触发计划评估时，需要提供要评估的计划的ID。 您一次只能​ 评估 ​一个计划。 有关触发计划评估的更多详细信息，请阅读计划终结点指南。

响应

成功的响应返回不含内容的HTTP状态200。

启用或禁用计划

您可以使用Experience Platform UI或API启用或禁用计划。

UI

要使用Experience Platform UI启用或禁用计划，请选择计划旁边的 更多图标 。 如果要启用当前禁用的计划，请选择​启用。 如果要禁用当前启用的计划，请选择​禁用。

“禁用计划”按钮突出显示。

API

要启用或禁用使用Experience Platform API的计划，您需要向/schedules端点发出PATCH请求，提供要更新的计划的ID。

API格式

code language-http 
PATCH /schedules/{SCHEDULE_ID}

请求

accordion
更新计划的示例请求
code language-shell 
curl -X PATCH https://platform.adobe.io/data/core/ups/config/schedules/cd585edf-962d-420d-94ad-3be03e619ac2 \
  -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 '[
        {
            "op": "replace",
            "path": "/state",
            "value": "inactive"
        }
      ]'

更新计划时，需要提供计划的操作、路径和值。 如果要启用已禁用的计划，您需要将value设置为active。 如果要禁用启用的计划，您需要将value设置为inactive。 有关更新计划的详细信息，请阅读计划终结点指南。

响应

成功的响应返回不含内容的HTTP状态204。

后续步骤

阅读本指南后，您现在知道如何使用Experience Platform API或UI灵活地批量计划。 有关灵活批处理计划UI的更多信息，请阅读分段服务UI概述。 有关计划API的详细信息，请阅读计划终结点指南。 要了解灵活批量计划如何与您的容量和积分配合使用，请阅读许可证使用和容量概述。

视频 video

以下视频介绍如何使用灵活的批处理计划，概述如何在评估选项卡中创建自定义计划、监视分段作业和管理积分。

https://video.tv.adobe.com/v/3497114?captions=chi_hans&learn=on
https://video.tv.adobe.com/vc/3497114/chi_hans.json

附录 appendix

以下附录列出了交叉计划依赖项的工作方式以及有关灵活批处理计划的常见问题。

跨计划依赖关系 cross-schedule-dependencies

如果一个受众将另一个受众称为依赖关系，则该依赖关系会将该受众提取到它不属于的时间表中。

考虑以下四个受众和两个计划：

计划A：受众1，受众4
计划B：受众2，受众3

受众1通过依赖关系引用受众2，因此受众1 需要​受众2的已评估成员资格才能计算其自身的成员资格。

在计划A运行时，受众1和受众4会按预期进行评估。 但是，受众2 还运行，因为它是Audience 1的依赖项。

当计划B运行时，受众2和受众3会按预期进行评估。 在此方案中，受众1将​ 不 ​得到评估，因为受众2不依赖于受众1。

因此，这意味着依赖于其他受众的受众（例如上述场景中的Audience 2）每天可能会进行多次评估 — 一次是作为自身计划评估的一部分，一次是作为依赖其他受众的受众计划的一部分。**

常见问题 faq

我是否需要执行任何操作以继续使用当前拥有的每日评估？

回答
不是。 系统计划将继续自动运行。 除非创建自定义计划，否则不会发生任何更改。

受众是否可以分配给多个自定义计划？

回答
是！ 一个受众可以分配给多个自定义计划。

流式受众或Edge受众能否使用自定义计划？

回答
不是。 流受众和边缘受众始终根据系统计划进行评估。

能否将受众组合分配给自定义计划？

回答
不是。 受众组合将作为系统计划的一部分自动评估。 这包括构成中的任何内部受众。

我可以运行多少个计划？

回答
您每天最多可以运行4个计划。 此​ 包括 ​系统计划。

我是否需要灵活的批处理计划才能拥有超过4,000个批处理受众？

回答
可以。 拥有10,000个批处理受众需要灵活的批处理计划。

创建自定义计划是否有任何成本？

回答
您获得Experience Platform中包含的一个每周自定义计划（52次计划运行）。 此外，系统计划始终是免费的。 如果要创建其他自定义计划，则其他计划运行将冲减积分。 有关详细信息，请阅读许可证使用和容量概述。

如何查看我的计划是否运行？

回答
您可以查看计划是否在分段作业监控视图中运行。 选择​监控，然后选择​仪表板、受众​和​分段作业。 从这里，选择计划运行时间旁边的 过滤器图标 ，以查看计划评估的受众列表。
recommendation-more-help
experience-platform-help-segmentation