subscribeRulesetItems

La commande subscribeRulesetItems vous permet de vous abonner à des propositions qui sont le résultat d’ensembles de règles satisfaits. Pour ce faire, spécifiez les surfaces et les schémas en fonction desquels filtrer et fournissez une fonction de rappel.

Chaque fois que des ensembles de règles sont évalués, la fonction de rappel reçoit un objet result contenant un tableau de propositions.

IMPORTANT
La commande subscribeRulesetItems est la seule façon d’obtenir des propositions provenant d’ensembles de règles, puisqu’elles ne sont pas renvoyées avec des résultats 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);
  },
});

Le code ci-dessus s’abonne à la surface web://example.com/#welcome pour les cartes de contenu et utilise la méthode pratique collectEvent pour émettre des événements display pour toutes les propositions.

Options de la commande command-options

Cette commande prend un objet options avec les propriétés suivantes :

Propriété
Type
Description
surfaces
Tableau de chaînes
Une liste de surfaces. Les propositions ne sont reçues par la fonction de rappel que si elles correspondent à l’une des surfaces fournies ici.
schemas
Tableau de chaînes
Une liste de schémas. Les propositions ne sont reçues par la fonction de rappel que si elles correspondent à l’un des schémas fournis ici.
callback
Fonction
Une fonction de rappel qui sera appelée lorsque les propositions sont le résultat de jeux de règles satisfaits. La fonction de rappel reçoit deux paramètres lorsqu’elle est appelée : result et collectEvent. Voir paramètres de rappel pour plus d’informations.

Paramètres de rappel callback-parameters

Lorsqu’elle est appelée, la fonction de rappel reçoit les deux paramètres décrits dans le tableau ci-dessous.

Paramètre
Type
Description
result
Objet
Cet objet contient un tableau propositions. Ces propositions sont le résultat direct d’ensembles de règles satisfaits. L’objet result est structuré de la même manière que l’objet result renvoyé par sendEvent à l’aide d’une clause then.
collectEvent
Fonction
Fonction pratique que vous pouvez utiliser pour envoyer des événements Edge Network afin de suivre les interactions, les affichages et d’autres événements.

Fonction collectEvent collectevent-function

La fonction collectEvent est une fonction pratique que vous pouvez utiliser pour envoyer des événements Edge Network afin de suivre les interactions, les affichages et d’autres événements. Il accepte les deux paramètres décrits dans le tableau ci-dessous.

Paramètre
Type
Description
Type d’événement
Chaîne
Chaîne indiquant le type d’événement de proposition à émettre. Les types d’événements pris en charge sont display, interact ou dismiss.
propositions
Tableau
Tableau de propositions correspondant à l’événement.

Abonnement aux cartes de contenu à l’aide de l’extension de balise Web SDK

L’extension de balise Web SDK équivalente aux réponses de commande est une règle qui s’abonne à l’événement Subscribe ruleset items. L’événement vous permet de fournir les schémas et surfaces souhaités.

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