Paramètres de modèle d'élément de campagne

Format des paramètres de modèle d'élément de campagne

Le format d'un paramètre de modèle d'élément de campagne dépend de la provenance des données. Vous disposez de deux options :

1. Les données émanent de l'interface utilisateur.
   Si les données requises par la commande de tâche sont saisies par un utilisateur lors la configuration du déclencheur, de la cible ou de l'action, leur format sera similaire à ceci :

   <Argument name="paramName" value="MARKETING_paramName" />

   Toutes les valeurs de paramètre provenant de l'interface utilisateur sont précédées du préfixe : MARKETING_. Un exemple figure ci-après. En l'occurrence, il s'agit d'une cible qui évalue le niveau de support auquel l'utilisateur a souscrit, à savoir Or, Argent ou Bronze.

   <Argument name="supportLevel" value="MARKETING_supportLevel" />

   Lorsque l'utilisateur entre des données sur un déclencheur, une cible ou une action utilisé dans une activité marketing, les paires nom-valeur de chaque définition de modèle d'élément de campagne sont mémorisées dans la table DMELEMENTNVP. Ci-dessous figure un exemple de ligne dans la table correspondant à une cible DMELEMENT_ID portant la valeur 1000 :

   Exemple de contenu de table DMELEMENTNVP

   DMELEMENT_ID	NAME	VALUE
   1000	"supportLevel"	"Gold" (Or)

   Lors de l'activation de l'activité marketing :

   • Les services marketing recherchent l'entrée paramName dans la table DMELEMENTNVP et remplacent la valeur MARKETING_paramName dans la définition d'implémentation par la valeur correspondante.
   • Si paramName est introuvable dans la table DMELEMENTNVP, sa valeur est définie comme une chaîne vide, auquel cas ce paramètre est ignoré.
2. Les données sont spécifiées directement dans la définition du modèle.

   Dans le cas de certains déclencheurs, cibles et actions, la commande de tâche requiert des données qui ne sont pas saisies par l'utilisateur professionnel. Dans ce cas, le paramètre value n'est pas précédé du préfixe MARKETING_.

   Par exemple, si une commande de tâche doit vérifier le comportement de l'utilisateur sur la page en cours, le paramètre suivant peut transmettre les données de la page actuelle à la commande de tâche :

   <Argument name="matchLocations" value="request" />

Paramètres des listes capturées dans les objets de grille

Pour certains éléments de campagne, l'utilisateur professionnel peut spécifier des listes d'éléments, comme des catégories, des entrées de catalogue ou des segments de clientèle. Par exemple, l'utilisateur pourrait spécifier plusieurs catégories pour l'action Recommander une catégorie. Dans la vue Propriétés de l'élément de campagne, les listes sont capturées à l'aide d'un objet grille. Lorsque la liste est rendue persistante dans la table DMELEMENTNVP, chaque ligne de la grille correspond à une ligne de la table DMELEMENTNVP et chaque ligne se réfère au même nom de propriété. Par exemple :

Lorsque ce type de paramètre est inclus dans une définition de modèle d'élément de campagne, le paramètre ne doit spécifier qu'un seul élément. Par exemple, le paramètre dans l'exemple précédent est similaire à ceci :

<Argument name="categoryIdList" value="MARKETING_categoryIdList"/>

Pour extraire la liste depuis l'interface utilisateur, la commande de tâche de l'élément de campagne correspondant doit appeler la méthode getElementParameters. Cette méthode renvoie une liste de toutes les valeurs, séparées par des virgules, de la table DMELEMENTNVP. Pour l'exemple précédent, le code getElementParameters().get("categoryIdList") renvoie 10101,10102,10103. Pour fournir les valeurs dans un objet Liste, utilisez la méthode MarketingUtil.parseList. Dans le cas de l'exemple précédent, la ligne de code est similaire à ceci :

List categoryIdList = MarketingUtil.parseList(getElementParameters().get("categoryIdList"));

Paramètres communs utilisés dans les éléments de campagne

De nombreux paramètres sont déjà définis pour les déclencheurs, les cibles et actions livrées avec le Centre de gestion. Si vous créez un déclencheur, une cible ou une action, vous pouvez utiliser les paramètres définis ici afin d'envoyer des données depuis l'interface utilisateur à la commande de tâche, ou bien créer les vôtres.