DokumentationExperience PlatformDatenerfassung

subscribeRulesetItems

Last update: Tue Dec 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Entwickler

Mit dem Befehl subscribeRulesetItems können Sie Vorschläge abonnieren, die das Ergebnis erfüllter Regelsätze sind. Hierzu können Sie angeben, nach welchen Oberflächen und Schemata gefiltert werden soll, und eine Rückruffunktion bereitstellen.

Jedes Mal, wenn Regelsätze ausgewertet werden, empfängt die Callback-Funktion ein result mit einem Array von Vorschlägen darin.

IMPORTANT
Der Befehl subscribeRulesetItems ist die einzige Möglichkeit, Vorschläge aus Regelsätzen abzurufen, da sie nicht zusammen mit sendEvent Ergebnissen zurückgegeben werden.
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);
  },
});

Der obige Code abonniert die web://example.com/#welcome für Inhaltskarten und verwendet die collectEvent Convenience-Methode, um display Ereignisse für alle Vorschläge auszugeben.

Befehlsoptionen command-options

Dieser Befehl akzeptiert ein options mit den folgenden Eigenschaften:

Eigenschaft
Typ
Beschreibung
surfaces
Zeichenfolgen-Array
Eine Liste von Oberflächen. Vorschläge werden von der Callback-Funktion nur dann empfangen, wenn sie mit einer der hier bereitgestellten Oberflächen übereinstimmen.
schemas
Zeichenfolgen-Array
Eine Liste von Schemata. Vorschläge werden nur dann von der Callback-Funktion empfangen, wenn sie mit einem der hier bereitgestellten Schemata übereinstimmen.
callback
Funktion
Eine Callback-Funktion, die aufgerufen wird, wenn Vorschläge das Ergebnis erfüllter Regelsätze sind. Die Rückruffunktion erhält zwei Parameter, wenn sie aufgerufen wird: result und collectEvent. Siehe Callback-Parameter für Details.

Callback-Parameter callback-parameters

Die Rückruffunktion empfängt beim Aufrufen die beiden in der folgenden Tabelle beschriebenen Parameter.

Parameter
Typ
Beschreibung
result
Objekt
Dieses Objekt enthält ein propositions-Array. Diese Vorschläge sind das direkte Ergebnis von zufriedenen Regelsätzen. Das result-Objekt ist genauso strukturiert wie das Ergebnisobjekt das von sendEvent mit einer then -Klausel zurückgegeben wird.
collectEvent
Funktion
Eine praktische Funktion, mit der Sie Edge Network-Ereignisse senden können, um Interaktionen, Anzeigen und andere Ereignisse zu verfolgen.

collectEvent-Funktion collectevent-function

Die Funktion collectEvent ist eine praktische Funktion, mit der Sie Edge Network-Ereignisse senden können, um Interaktionen, Anzeigen und andere Ereignisse zu verfolgen. Sie akzeptiert die beiden in der folgenden Tabelle beschriebenen Parameter.

Parameter
Typ
Beschreibung
Ereignistyp
String
Eine Zeichenfolge, die angibt, welcher Vorschlagsereignistyp ausgegeben werden soll. Unterstützte Ereignistypen sind display, interact oder dismiss.
propositions
Array
Ein Array von Vorschlägen, die dem Ereignis entsprechen.

Abonnieren von Inhaltskarten mit der Tag-Erweiterung Web SDK

Die Web-SDK-Tag-Erweiterung, die Befehlsantworten entspricht, ist eine Regel, die das Subscribe ruleset items abonniert. Mit dem Ereignis können Sie die gewünschten Schemas und Oberflächen bereitstellen.

recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1