`subscribeRulesetItems`

Last update: Thu Aug 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

開發人員

subscribeRulesetItems命令可讓您訂閱滿足規則集的結果的建議。您可以指定作為篩選依據的曲面和結構描述，並提供回呼函式來完成此操作。

無論何時評估規則集，回呼函式都會接收內含主張陣列的result物件。

IMPORTANT

subscribeRulesetItems命令是取得來自規則集之主張的唯一方法，因為這些主張不會與sendEvent個結果一併傳回。

命令選項 command-options

這個命令接受具有下列屬性的options物件：

屬性

類型

說明

surfaces

字串陣列

曲面的清單。只有在建議符合此處提供的其中一個介面時，回呼函式才會收到建議。

schemas

字串陣列

方案清單。只有在建議符合此處提供的其中一個結構描述時，回呼函式才會收到建議。

callback

函數

當主張是滿意的規則集結果時會叫用的回呼函式。呼叫時，回呼函式會收到兩個引數： result和collectEvent。如需詳細資訊，請參閱回呼引數。

回呼引數 callback-parameters

呼叫時，回呼函式會收到下表所述的兩個引數。

參數

類型

說明

result

物件

此物件包含propositions陣列。這些主張是令人滿意的規則集的直接結果。 result物件的結構與使用then子句的sendEvent傳回的結果物件相同。

collectEvent

函數

方便使用的功能，可用來傳送Edge Network事件以追蹤互動、顯示和其他事件。

`collectEvent`函式 collectevent-function

collectEvent函式是方便使用的函式，可用來傳送Edge Network事件以追蹤互動、顯示和其他事件。它接受下表所述的兩個引數。

參數

類型

說明

事件型別

字串

字串，指明要發出的主張事件型別。支援的事件型別為display、interact或dismiss。

propositions

陣列

與事件對應的主張陣列。

使用Web SDK標籤擴充功能訂閱內容卡 tag-extension

請依照下列步驟，透過Tags使用者介面訂閱內容卡。

使用您的Adobe ID憑證登入experience.adobe.com。
導覽至 資料彙集 > 標籤。
選取所需的標籤屬性。
導覽至規則，然後選取所要的規則。
在事件下，選取現有事件或建立新事件。
將擴充功能下拉式清單欄位設定為 Adobe Experience Platform Web SDK，並將 事件型別 設定為 訂閱規則集專案。
在畫面右側選取您要訂閱內容卡的結構描述和介面。
選取 保留變更，然後執行您的發佈工作流程。

使用Web SDK JavaScript資料庫訂閱內容卡 library

下列範常式式碼訂閱內容卡的web://mywebsite.com/#welcome表面，並使用collectEvent便利方法為所有主張產生display個事件。

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

recommendation-more-help

ad108910-6329-42f1-aa1d-5920a2b13636

subscribeRulesetItems