Comment utiliser les chaines de substitutions dans les scénarios ?

La plupart des plugins Obsewhere permettent de produire des tags de subtitution. Ceux qui ne le permettent pas sont plutôt de nature "technique" et sont peu utilisés.

Les chaînes (ou tags) de substitution permettent de restituer et d'exploiter des données dynamiques issues d'une séquence précédente, au sein d'un scénario.

Pour prendre un exemple simple, si votre séquence 1 "Observation" porte sur la surveillance de la création des articles, la séquence 2 "Action" va pouvoir restituer le titre ou l'id de l'article, grâce aux tags de substitution (données collectées lors de la séquence 1). Vous pourrez alors exploiter dans un mail cette information dynamique de l'Id et du Titre de l'article qui vient d'être créé, grâce à leurs tags de substitution respectifs : {seq1:id} et {seq1:title}.

Par ailleurs il est fondamental de comprendre que le contenu des tags de substitution dépendent du contexte : par exemple ils seront de nature différente selon que la séquence porte sur des articles ou des utilisateurs.

Enfin, les tags de substitution appellant des données d'une séquence précédente, cela signifie que dans un scénario à 4 séquences :

• les tags de susbtitution de la séquence 1 sont accessibles au sein des séquences 2,3,4
• les tags de susbtitution de la séquence 2 sont accessibles au sein des séquences 3,4
• les tags de susbtitution de la séquence 3 sont accessibles au sein des séquences 4

Nous allons développer dans cet article 2 exemples d'application des tags de substitution.

Exemple 1 : scénario de notification par email de la création d'un article

La création d'un scénario démarre en cliquant sur le bouton  en haut à gauche de l'écran de liste des scénarios.

Pour encore plus de précisions sur la création des scénarios, merci de vous reporter sur notre article : "Première prise en mains - création du premier scénario"

1- Indiquer le titre du scénario : par exemple "Notification par mail de la création d'un nouvel article"

2- Créer la séquence Observation : de type "Articles" (thématique "Contenu")

Dès que vous enregistrez la séquence, l'écran de construction du scénario se présente comme suit :

Cette note signifie que tant que le scénario n'est pas enregistré :

• les informations de la séquences sous la forme d'icones ne sont pas affichées 
• les tags de substitution ne sont pas disponibles.

Donc pour exploiter les tags de susbtitution dans la séquence suivante, il va falloir :

• créer cette 2ème séquence,
• enregistrer le scénario,
• revenir sur la 2ème séquence et sélectionner les tags de susbtitution pertinents.
  
  

3- Créer la séquence Action : de type "Email" (thématique "Message")

Notre objectif est d'indiquer à l'administrateur l'Id et le Titre de l'article nouvellement créé, en s'appuyant sur les tags de substitution. Or ceux-ci ne sont pas connus car le scénario n'est pas enregistré.

Les champs "Titre du message" et "Contenu du message à envoyer" sont associés à l'icône , qui indique leur compatibilité avec l'insertion de tags de substitution.

Ces 2 champs étant obligatoires nous allons procéder comme suit :

• indiquer une valeur par défaut "Provisoire"
• enregistrer la séquence
• enregistrer le scénario, afin que la séquence puisse accéder aux tags de substitution des séquences précédentes
• revenir sur la séquence Action "Email" par le bouton  et remplacer les valeurs par défaut par les contenus souhaités
  
  

4- Mise en place des tags de substitution :

Les tags de substitution sont désormais accessibles via le bouton , ce qui a pour effet d'ouvrir un panneau sur la droite de l'écran.

Il suffit ce copier ou de saisir les tags pertinents à insérer dans le titre et le corps du message. Pour rappel le bouton  permet d'insérer des balises HTML dans ces champs.

Le 1 contenu dans les tags {seq1:id}, {seq1:title} etc... correspond au numéro de la séquence, en l'occurence la séquence Observation.

Un dernier paramètre important est à effectuer : indiquer le ou les destinataires de l'action d'envoi d'email.

5- Tags de substitution et destinataires de l'action :

Les choix possibles pour la boite de sélection du/des destinataires sont :

Dans notre exemple, le destinataire de l'action n'a pas de lien avec les données de la séquence 1, les choix "Tag de substitution d'un ID utilisateur" et "Tag de substitution d'un ID abonné" sont donc inopérants ici. Mais dans le cadre d'une surveillance d'événements liés aux utilisateurs, ces possibilités pourraient s'appliquer.

Les choix pertinents pour notre exemple sont :

• utilisateur => sélection d'un utilisateur
• Tag de substitution d'un email => voir explications et image ci-dessous
• Groupe d'utilisateur => sélection d'un Groupe (ACLs)
• Groupe d'abonnés => sélection d'un Groupe d'abonnés créés avec Obsewhere

Dans notre exemple, le destinataire va être l'administrateur principal du site, celui dont l'email est renseigné en Sysème / Configuration / Serveur - champ "E-mail du site".
Il est possible d'indiquer l'utilisateur comme destinataire mais aussi d'utiliser des tags système en cliquant sur le titre 

Le tag {site_fromemail} permet de récupérer l'adresse mail renseignée en Configuration du site. La liste affichée permet également de récupérer de façon automatique d'autres paramètres de configuration, ce qui est particulièrement utile lors d'une utilisation d'un même scénario sur plusieurs sites.

Lorsque vos paramètres sont renseignés, il faut enregistrer la séquence ET le scénario.

5- Résultat au sein de l'email envoyé :

Exemple 2 : utilisation de tags de plusieurs séquences

Nous allons nous appuyer sur l'exemple d'utilisation "Afficher un message dynamique avec calcul du montant pour bénéficier des frais de livraison gratuits".

Ce scénario se décompose en 3 séquences :

Séquence 1 : Observation de type "Seuil panier" (thématique "e-Commerce") - Titre et objectif :  "Déterminer le seuil du panier qui va déclencher un message"
Séquence 2 : Action de type "Opération calcul" (thématique "Système") - Titre et objectif : "Calcul de l'écart pour profiter de la livraison gratuite"
Séquence 3 : Action de type "EngageBox" (thématique "Extension") - Titre et objectif : "EngageBox de rappel du montant d'achat restant pour livraison gratuite"

Pour comprendre les tags de substitution associés à chaque séquence, nous allons visualiser la séquence 3 (ou séquence courante), où sont disponibles les données des tags de substitution des séquences précédentes (1 et 2).

Le titre et le contenu du message ont été construits en intégrant plusieurs tags (en vert pour ceux provenant de la séquence 1, en rouge pour ceux provenant de la séquence 2).

Résultat de l'EngageBox affichée :

Pour rappel dans l'exemple d'utilisation, la fenêtre pop up s'affiche à partir d'un seuil de 50€.