Que Sont les Variables et Comment les Utiliser

Dans Connectif, les variables représentent des données pouvant changer en fonction du contact qui navigue et de son contexte web. Cela permet de créer des contenus et des expériences personnalisées, en fonction de l’utilisateur et de son comportement, ce qui augmente la fidélisation et la conversion. 

 

1. Propriétés

  • Une variable dans Connectif est la représentation de données qui changent selon le contact et son comportement.
  • Toute donnée collectée dans un workflow peut être assignée à une variable, qu’il s’agisse par exemple d’informations sur les produits ou sur le contact.
  • Chaque variable se distingue par un nom et un identifiant unique.
 

L’identifiant de la variable ne peut pas contenir d’espaces et ne peut inclure que des lettres, des chiffres, et les symboles tiret ( - ) et souligné ( _ ).

  • Les variables peuvent avoir un type de format déterminé selon les données qu’elles représentent. Ces formats sont Nombre, Date, Monnaie et Pourcentage. Par défaut, les variables sont définies comme Sans format. Ce type indéfini est utilisé pour représenter du texte ou des données qui ne sont pas destinés à être affichés de manière spécifique.
 

Si vous souhaitez en savoir plus sur le format des variables dans les emails, le contenu web, les notifications push ou les SMS, cliquez ici.

  • Les variables peuvent être incluses dans tout type de contenu depuis leurs éditeurs respectifs et être liées à toute donnée recueillie dans les nœuds précédents d’un workflow.
  • L’attribution des données aux variables se fait dans la configuration des nœuds d’action chargés d’envoyer du contenu au contact : "Envoyer du contenu web", "Envoyer un email", "Afficher une notification push" et "Envoyer un SMS".
  • Lors de la création d’une variable, il est possible de définir une valeur par défaut, qui sera automatiquement attribuée lorsqu’aucune donnée n’est disponible depuis la source. Si la variable n’est liée à aucune donnée et n’a pas cette valeur par défaut, un espace vide sera affiché à sa place.

 

2. Utilisation dans Connectif

2.1. Utilisation des variables prédéfinies

Il existe certaines variables que Connectif fournit pour les utiliser dans les contenus sans qu’il soit nécessaire de faire une association explicite des données dans les nœuds qui envoient ou affichent les contenus :

Ces variables n’acceptent pas la définition d’une valeur par défaut.

  • {{__cn_available_width}} : cette variable est disponible dans tous les contenus de Connectif sauf dans les Notifications Web Push. Elle est automatiquement remplacée par la valeur en pixels de la largeur de la cellule où se trouve la variable.
 

Par exemple, si nous créons un popup de 600px de large et y ajoutons un contenu dynamique avec cette variable configurée pour afficher des lignes de 4 cellules égales, chaque cellule du contenu dynamique aura une largeur de 150px. 

  • {{__cn_email_subject}} : cette variable est uniquement disponible dans le type de contenu email. Elle peut être utilisée dans n’importe quelle partie de l’email et est automatiquement remplacée par l’Objet de l’email. 
  • {{__cn_email_from}} : cette variable est uniquement disponible dans le type de contenu email. Elle peut être utilisée dans n’importe quelle partie de l’email et est automatiquement remplacée par l’adresse From utilisée pour envoyer l’email. 

 

2.2. Création de variables

Contenus web

1.  Accédez à "Contenus > Contenu web" et cliquez sur  Créer un nouveau contenu web. Si vous souhaitez créer des variables dans un design de contenu web existant, cliquez sur  Plus pour dérouler le menu et cliquez sur Éditer.

2. Ajoutez ou sélectionnez dans votre design le composant où vous souhaitez créer une nouvelle variable.

3. Cliquez sur  (Éditer l’élément).

4. Dans l’éditeur, cliquez sur le bouton Variables.

Actualisation variables - 1-min.png

5. Entrez un nom pour distinguer la variable dans Identifiant de variable.

6. (Optionnel) Définissez la Valeur par défaut si nécessaire.

7. (Optionnel) Attribuez un Type de données si nécessaire.

Actualisation variables - 2-min.png

8. Cliquez sur  Accepter pour enregistrer les modifications dans le nœud et sur  Enregistrer pour sauvegarder les modifications dans le workflow.

 

Emails

1.  Accédez à "Contenus > Email" et cliquez sur  Créer un nouvel email. Si vous souhaitez créer des variables dans un design d’email existant, cliquez sur  Plus pour dérouler le menu et cliquez sur Éditer.

2. Ajoutez ou sélectionnez dans votre design le composant où vous souhaitez créer une nouvelle variable.

3. Cliquez sur  (Éditer l’élément).

4. Dans l’éditeur, cliquez sur le bouton Variables.

Actualisation variables - 3-min.png

5. Entrez un nom pour distinguer la variable dans Identifiant de variable.

6. (Optionnel) Définissez la Valeur par défaut si nécessaire.

Actualisation variables - 4-min.png

8. Cliquez sur  Accepter pour enregistrer les modifications dans le nœud et sur  Enregistrer pour sauvegarder les modifications dans le workflow.

 

Notifications web push

1.  Accédez à "Contenus > Notifications Push" et cliquez sur  Créer une nouvelle notification push. Si vous souhaitez créer des variables dans un design existant, cliquez sur  Plus pour dérouler le menu et cliquez sur Éditer.

2. Dans les onglets Contenu ou Version compacte, cliquez sur le bouton {} (Définir une variable dynamique)

3. Entrez un nom pour distinguer la variable dans Identifiant de variable.

4. (Optionnel) Définissez la Valeur par défaut si nécessaire.

Actualisation variables - 5-min.png

5. Cliquez sur  Accepter.

6. Cliquez sur  Accepter pour enregistrer les modifications dans le nœud et sur  Enregistrer pour sauvegarder les modifications dans le workflow.

 

SMS

1.  Accédez à "Contenus > SMS" et cliquez sur  Créer un nouveau SMS. Si vous souhaitez créer des variables dans un design existant, cliquez sur  Plus pour dérouler le menu et cliquez sur Éditer.

2. Dans l’onglet Contenu, cliquez sur le bouton {} (Définir une variable dynamique).

3. Entrez un nom pour distinguer la variable dans Identifiant de variable.

4. (Optionnel) Définissez la Valeur par défaut si nécessaire.

Actualisation variables - 6-min.png

5. Cliquez sur  Accepter.

6. Cliquez sur  Accepter pour enregistrer les modifications dans le nœud et sur  Enregistrer pour sauvegarder les modifications dans le workflow.

 

2.3. Modification du type de données d’une variable

  

Il est uniquement possible de modifier les types de données d’une variable dans les contenus de type web et email.

1. Dans l’éditeur, cliquez sur   Propriétés générales.

2. Sélectionnez l’onglet Variables.

3. Cliquez sur   (Éditer).

4. Modifiez le type de données.

Actualisation variables - 7-min.png

5. Cliquez sur  Accepter pour enregistrer les modifications dans la variable et sur  Enregistrer pour sauvegarder les modifications dans le design.

 

2.4. Attribution de variables

Nœud "Envoyer du contenu web"

1.  Accédez à "Workflows" et cliquez sur  Créer un nouveau workflow. Si vous souhaitez attribuer des variables dans une stratégie existante, cliquez sur  Plus pour dérouler le menu et cliquez sur Éditer.

  

Pour pouvoir suivre les étapes de cette section, il est nécessaire d’avoir un contenu web avec des variables, et un workflow contenant au moins un nœud "Envoyer du contenu web".
N’oubliez pas que vous pouvez utiliser un modèle existant dans Connectif, par exemple, Recomendador en home.

2. Dans le nœud "Envoyer du contenu web", cliquez sur  (Éditer la configuration du nœud).

3. Sélectionnez le contenu web avec des variables.

4. Cliquez sur Suivant  .

5. À la deuxième étape, configurez l’envoi selon le type de contenu web.

  

Pour en savoir plus sur le nœud "Envoyer du contenu web", cliquez ici.

6. À la troisième étape, établissez la relation entre les données obtenues dans les nœuds précédents et les variables créées dans la conception du contenu web.

Actualisation variables - 8-min.png

7. Cliquez sur Terminer  .

8. Dans le workflow, cliquez sur  Enregistrer pour sauvegarder les modifications et sur  Démarrer pour l’activer.

 

Nœud "Envoyer un email"

1. Accédez à "Workflows" et cliquez sur  Créer un nouveau workflow. Si vous souhaitez attribuer des variables dans une stratégie existante, cliquez sur  Plus pour dérouler le menu et cliquez sur Éditer.

  

Pour suivre les étapes de cette section, vous aurez besoin d’un design d’ email avec variables  et d’un workflow contenant au moins un nœud "Envoyer un email". 
N’oubliez pas que vous pouvez utiliser un modèle existant dans Connectif, par exemple, Campagne d’email massive.

2. Dans le nœud "Envoyer un email", cliquez sur  (Éditer la configuration du nœud).

3. Sélectionnez le design d’email avec des variables.

4. Cliquez sur Suivant  .

5. À la deuxième étape, configurez les paramètres d’envoi.

6. À la troisième étape, établissez la relation entre les données obtenues dans les nœuds précédents et les variables créées dans la conception du contenu web.

Actualisation variables - 9-min.png

7. Cliquez sur Terminer  .

8. Dans le workflow, cliquez sur  Enregistrer pour sauvegarder les modifications et sur  Démarrer pour l’activer.

 

Nœud "Afficher une notification push"

1.  Accédez à "Workflows" et cliquez sur  Créer un nouveau workflow. Si vous souhaitez attribuer des variables dans une stratégie existante, cliquez sur  Plus pour dérouler le menu et cliquez sur Éditer.

  

Pour suivre les étapes de cette section, vous aurez besoin d’un design de notification web push avec variables, et d’un workflow contenant au moins un nœud "Afficher une notification push".
N’oubliez pas que vous pouvez utiliser un modèle existant dans Connectif, par exemple, Demander l’abonnement aux notifications web push.

2. Dans le nœud "Afficher une notification push", cliquez sur  (Éditer la configuration du nœud).

3. Sélectionnez le design de notification web push avec variables.

4. Cliquez sur Suivant  .

5. À la deuxième étape, établissez la relation entre les données obtenues dans les nœuds précédents et les variables créées dans la conception du contenu web.

Actualisation variables - 10-min.png

6. Cliquez sur Terminer  .

7. Dans le workflow, cliquez sur  Enregistrer pour sauvegarder les modifications et sur  Démarrer pour l’activer.

 

Nœud "Envoyer un SMS"

1.  Accédez à "Workflows" et cliquez sur  Créer un nouveau workflow. Si vous souhaitez attribuer des variables dans une stratégie existante, cliquez sur  Plus pour dérouler le menu et cliquez sur Éditer.

  

Pour suivre les étapes de cette section, vous aurez besoin d’un design de SMS avec variables, et d’un workflow contenant au moins un nœud "Envoyer un SMS".
N’oubliez pas que vous pouvez utiliser un modèle existant dans Connectif, par exemple, Envoyer un SMS après un achat.

2. Dans le nœud "Envoyer un SMS", cliquez sur  (Éditer la configuration du nœud).

3. Sélectionnez le design de SMS avec variables.

4. Cliquez sur Suivant  .

5. À la deuxième étape, configurez les paramètres d’envoi.

6. À la troisième étape, établissez la relation entre les données obtenues dans les nœuds précédents et les variables créées dans le design du SMS.

Actualisation variables - 11-min.png

7. Cliquez sur Terminer  .

8. Dans le workflow, cliquez sur  Enregistrer pour sauvegarder les modifications et sur  Démarrer pour l’activer.

 

2.5. Identification des variables

  

La colonne de gauche affiche une liste des données obtenues par les nœuds précédents du workflow.
La colonne de droite énumère les variables créées dans le contenu dynamique.
La colonne centrale, vide, permet de relier les données aux variables.

1. Attribuez les données obtenues dans le workflow à la variable correspondante.

  

Faites glisser les données de la liste (colonne de gauche) vers la colonne centrale pour établir la relation avec la variable (colonne de droite).

Actualisation variables - 12-min (2).png

 

Dans notre exemple, les variables provenant de la source de données Contact ont d’abord été assignées depuis le nœud "Nœud "Accueil"".

Actualisation variables - 13 (1)-min.png

 

Dans notre exemple, les données provenant ensuite du nœud "Obtenir des produits", contenant les informations produits, ont été assignées aux variables du contenu dynamique.

  

Quelques associations de variables courantes sont :
"Name" : Nom du contact.
"Title" : Nom du produit.
"Description" : Description de l’article.
"ButtonUrl" : URL de la fiche produit dans l’eCommerce.
"ImageUrl" : Image du produit.
"Price" : Prix actuel du produit.

 

Si vous souhaitez en savoir plus sur les différentes données incluses dans les informations produit, cliquez ici.

2. (Optionnel). Attribuez des valeurs littérales aux variables qui le nécessitent.

  

Une valeur littérale est une donnée définie, statique, qui sera commune à tous les contacts, contrairement aux données dynamiques qui varient en fonction du contact et de son comportement.

Actualisation variables - 14-min (1).png

 

Dans notre exemple, les liens des boutons (buttonURL) mènent toujours à la page du panier, c’est pourquoi une valeur littérale est utilisée.

Le résultat aurait été le même si ce comportement avait été défini depuis la configuration des boutons dans l’éditeur de contenu.

3. Cliquez sur  Terminer.

4. Dans le workflow, cliquez sur  Enregistrer pour sauvegarder les modifications et sur  Démarrer pour l’activer.

 

  

 Félicitations !
Vous êtes arrivé à la fin de la leçon.

  

 Des questions non résolues ?
N’oubliez pas que vous pouvez faire appel à nos spécialistes Connectif. Pour les contacter, ouvrez simplement un ticket au Support en cliquant sur le bouton bleu “Aide” dans votre tableau de bord.

 


Continuez à apprendre !

Pour exploiter tout le potentiel de votre compte Connectif, nous vous recommandons de poursuivre avec les articles suivants :