DocumentazioneExperience PlatformRaccolta dati

subscribeRulesetItems

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

Creato per:

  • Sviluppatore

Il comando subscribeRulesetItems consente di sottoscrivere proposte che sono il risultato di set di regole soddisfatti. A tale scopo, è possibile specificare le superfici e gli schemi in base ai quali filtrare e fornire una funzione di callback.

I set di regole vengono valutati ogni volta che viene inviato un comando sendEvent. La funzione di callback riceve un oggetto result con un array di proposte al suo interno.

IMPORTANT
Il comando subscribeRulesetItems è l'unico modo per ottenere proposte provenienti da set di regole, poiché non vengono restituite insieme ai risultati di sendEvent. È necessario configurare la sottoscrizione prima di chiamare sendEvent per assicurarsi che le proposte vengano acquisite.
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);
  },
});

Il codice sopra riportato si abbona alla superficie web://example.com/#welcome per le schede di contenuto e utilizza il metodo di convenienza collectEvent per emettere display eventi per tutte le proposte.

Opzioni di comando command-options

Questo comando accetta un oggetto options con le seguenti proprietà:

Proprietà
Tipo
Descrizione
surfaces
Array di stringhe
Un elenco di superfici. Le proposte verranno ricevute dalla funzione di callback solo se corrispondono a una delle superfici fornite qui.
schemas
Array di stringhe
Elenco di schemi. Le proposte verranno ricevute dalla funzione di callback solo se corrispondono a uno degli schemi forniti qui.
callback
Funzione
Funzione di callback che viene richiamata quando le proposte sono il risultato di set di regole soddisfatti. La funzione di callback riceve due parametri quando richiamata: result e collectEvent. Per ulteriori dettagli, vedere parametri di callback.
TIP
È possibile sottoscrivere più superfici e schemi in un unico comando passando valori aggiuntivi agli array surfaces e schemas.

Parametri di callback callback-parameters

Quando viene richiamata, la funzione di callback riceve i due parametri descritti nella tabella seguente.

Parametro
Tipo
Descrizione
result
Oggetto
Questo oggetto contiene un array propositions. Queste proposte sono il risultato diretto di set di regole soddisfatti. L'oggetto result è strutturato come l'oggetto risultato restituito da sendEvent tramite una clausola then.
collectEvent
Funzione
Funzione di comodità che consente di inviare eventi Edge Network per monitorare interazioni, visualizzazioni e altri eventi.

Funzione collectEvent collectevent-function

La funzione collectEvent è una funzione di comodità che consente di inviare eventi Edge Network per tenere traccia di interazioni, visualizzazioni e altri eventi. Accetta i due parametri descritti nella tabella seguente.

Parametro
Tipo
Descrizione
Tipo di evento
Stringa
Stringa che indica il tipo di evento della proposta da emettere. I tipi di evento supportati sono display, interact o dismiss.
propositions
Array
Un array di proposte corrispondente all’evento.

La funzione collectEvent può essere chiamata indipendentemente all'esterno del callback. La chiamata di questa funzione è utile quando si tiene traccia di un’interazione o di una revoca in un momento successivo, ad esempio in risposta a un’azione dell’utente.

collectEvent("interact", propositions);

Iscriviti alle schede di contenuto tramite l’estensione tag Web SDK

L'estensione tag Web SDK equivalente alle risposte ai comandi è una regola che sottoscrive l'evento Subscribe ruleset items. L’evento ti consente di fornire gli schemi e le superfici desiderati.

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