`subscribeRulesetItems`

Last update: Tue Apr 07 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

开发人员

subscribeRulesetItems命令允许您订阅由满意的规则集产生的建议。为此，可指定要过滤的曲面和方案，并提供回调函数。

每次发送sendEvent命令时都会评估规则集。回调函数接收一个包含建议数组的result对象。

IMPORTANT

subscribeRulesetItems命令是获取来自规则集的建议的唯一方法，因为它们未与sendEvent结果一起返回。在调用sendEvent之前，您必须设置订阅，以确保捕获建议。

alloy("subscribeRulesetItems", {
  surfaces: ["web://example.com/#welcome"],
  schemas: ["https://ns.adobe.com/personalization/message/content-card"],
  callback: (result, collectEvent) => {
    const { propositions = [] } = result;
    renderMyPropositions(propositions);
    collectEvent("display", propositions);
  },
});

上述代码订阅了内容卡的web://example.com/#welcome表面，并使用collectEvent便利方法为所有建议发出display事件。

命令选项 command-options

此命令接受具有以下属性的options对象：

属性

类型

描述

surfaces

字符串数组

曲面列表。仅当建议与此处提供的某个表面匹配时，回调函数才会接收建议。

schemas

字符串数组

架构列表。仅当建议与此处提供的某个架构匹配时，回调函数才会接收建议。

callback

函数

当建议是满足的规则集的结果时调用的回调函数。调用时，回调函数接收两个参数： result和collectEvent。有关详细信息，请参阅回调参数。

TIP

通过将其他值传递给surfaces和schemas数组，您可以在单个命令中订阅多个表面和架构。

Callback参数 callback-parameters

调用时，回调函数会接收下表中描述的两个参数。

参数

类型

描述

result

对象

此对象包含propositions数组。这些建议是令人满意的规则集的直接结果。 result对象的结构与使用子句的返回的sendEvent结果对象then相同。

collectEvent

函数

一个方便使用的功能，可用于发送Edge Network事件以跟踪交互、显示和其他事件。

`collectEvent`函数 collectevent-function

collectEvent函数是一个方便使用的函数，可用于发送Edge Network事件以跟踪交互、显示和其他事件。它接受下表中描述的两个参数。

参数

类型

描述

事件类型

字符串

一个字符串，指明要发出的建议事件类型。支持的事件类型为display、interact或dismiss。

propositions

数组

对应于事件的建议数组。

可以在回调之外独立调用collectEvent函数。在跟踪稍后发生的交互或撤消（例如，响应用户操作）时，调用此函数很有用。

collectEvent("interact", propositions);

使用Web SDK标记扩展订阅内容卡

等效于命令响应的Web SDK标记扩展是订阅 Subscribe ruleset items 事件的规则。事件允许您提供所需的架构和界面。

recommendation-more-help

1ae86b30-e55e-49c1-ab11-9d0356a5f3e1