Comment ajouter une logique conditionnelle aux modèles d’e-mail à l’aide du générateur de logique

Objectif de cet article

Découvrez comment utiliser le générateur de logique pour ajouter une logique conditionnelle dynamique (comme des instructions if/else et des boucles for) directement dans les blocs de texte de vos modèles d’e-mail. Cela vous permet d’afficher du contenu personnalisé à différents destinataires en fonction de leur profil ou de leurs propriétés personnalisées, sans écrire de code.

Avant de commencer

Le générateur de logique est disponible dans :

• Éditeur d’e-mail en glisser-déposer — blocs de texte, blocs de tableau et blocs de fractionnement
• Éditeur d’e-mail en texte uniquement — via une fenêtre modale plutôt qu’un panneau latéral

Pour utiliser le générateur de logique, vous aurez besoin d’au moins un profil dans votre compte qui possède la propriété que vous souhaitez évaluer. Les profils et les propriétés personnalisées peuvent être ajoutés via des formulaires d’inscription, des imports CSV, des intégrations e-commerce et d’autres outils de développement de liste.

Remarque : Le générateur de logique prend en charge les propriétés de profil et personnalisées. Il ne prend pas en charge les données d’événements. Pour utiliser les données d’événements dans votre logique, utilisez l’option Convertir en code et écrivez directement des tag Django.

Ajouter une instruction if/else

Utiliser une instruction if/else pour afficher du contenu différent aux destinataires selon un profil ou une propriété personnalisée. Par exemple, vous pourriez afficher un bloc de réduction VIP uniquement aux clients qui ont plus de 500 points de fidélité, et une incitation à l’inscription à tout le monde.

Dans l’éditeur avec fonction glisser-déposer

1. Double-cliquez dans un bloc de texte, un bloc de tableau ou un bloc de fractionnement pour passer en mode d’édition.
2. Cliquez sur le bouton Insérer dans la barre d’outils en haut de la page.
3. Sélectionnez If/else dans le menu déroulant.
   • Un panneau latéral s’ouvrira à gauche, et la zone de travail se décalera vers la droite.
4. Configurez votre instruction if :
   • Utiliser la première liste déroulante pour choisir une propriété de profil ou personnalisée à évaluer.
   • Utilisez le deuxième menu déroulant pour sélectionner un opérateur (par exemple, est égal à, est supérieur à, est défini).
   • Saisissez ou sélectionnez une valeur à comparer, en fonction de l’opérateur choisi.
5. Si vous le souhaitez, cliquer sur Ajouter une condition pour ajouter des critères supplémentaires à l’instruction if.
   • Utilisez AND ou OR pour relier des conditions. OR est sélectionné par défaut.
   • Cliquez sur le bouton cloner sur une condition pour la dupliquer en tant que nouvelle condition OU.
6. Pour ajouter une branche else if, cliquez sur Ajouter else if et configurez les conditions de la même manière. Les destinataires qui remplissent ces conditions—mais pas l’instruction if—verront ce contenu.
7. Pour ajouter une branche else, cochez la case Else (cochée par défaut). Modifiez le contenu dans le canevas pour définir ce que verront les destinataires qui ne répondent à aucune condition. Décochez la case pour supprimer entièrement la branche else.
8. Modifiez le contenu dans le canevas pour chaque condition. Chaque condition apparaît sous la forme d’une boîte bleue pendant sa configuration.
9. Lorsque vous avez terminé, cliquez sur la flèche de retour pour fermer le panneau et enregistrer votre logique.

Astuce : Pour supprimer toute la logique configurée d’un bloc, cliquez sur Supprimer la logique dans le panneau latéral.

Note : si vous cliquez sur Supprimer dans l’instruction if initiale, ses valeurs seront réinitialisées au lieu de supprimer complètement l’instruction. Si vous cliquez sur Supprimer dans une branche else if ou else, cette branche sera supprimée.

Dans l’éditeur en texte uniquement

Suivez les mêmes étapes ci-dessus, mais sélectionnez Insérer dans la barre d’outils de modification de texte. Le générateur de logique s’ouvrira dans une fenêtre modale au lieu d’un panneau latéral. Toutes les mêmes options de configuration sont disponibles.

Ajouter une boucle for

Utilisez une boucle for pour itérer dans une liste d’éléments et afficher du contenu répété pour chacun. Par exemple, vous pouvez parcourir les produits récemment consultés par un client afin d’afficher chacun d’eux dans l’e-mail.

Dans l’éditeur avec fonction glisser-déposer

1. Double-cliquez dans un bloc de texte, un bloc de tableau ou un bloc de fractionnement.
2. Cliquez sur le bouton Insérer dans la barre d’outils.
3. Sélectionnez Boucle for dans le menu déroulant.
   • Un panneau latéral s’ouvrira à gauche.
4. Dans le champ Variable, saisir la liste que vous souhaitez parcourir en boucle (par exemple, event.items).
5. Dans le champ Alias de l’élément, saisissez un nom pour référencer chaque élément individuel dans la boucle (par exemple, item).
6. Modifiez le contenu dans la zone de travail afin de définir ce qui s’affichera pour chaque élément.
7. Cliquez sur la flèche de retour pour fermer le panneau et enregistrer votre logique.

Astuce : pour supprimer complètement la boucle, cliquez sur Supprimer la logique dans le panneau latéral.

Ajouter un tag configurable

Utilisez un tag configurable pour insérer des tag Django qui ne sont pas couverts par les générateurs if/else ou boucle for, comme les instructions with ou les tag de catalogue.

1. Double-cliquez dans un bloc de texte, un bloc de tableau ou un bloc de fractionnement.
2. Cliquez sur le bouton Insérer dans la barre d’outils.
3. Sélectionnez Tag configurable dans le menu déroulant.
   • Un panneau latéral s’ouvrira à gauche.
4. Dans le champ Nom du tag, saisissez le tag qui ouvrira et fermera le bloc (par exemple, with).
5. Dans la zone de texte Code, ajouter votre code de tag Django personnalisé.
6. Pour ajouter une branche, cliquez sur Ajouter une branche. Cela crée une section supplémentaire dans laquelle vous pouvez configurer un autre nom de tag et un bloc de code.
7. Cliquez sur la flèche de retour pour fermer le panneau et enregistrer votre logique.

Travailler avec une logique imbriquée

Vous pouvez imbriquer des instructions logiques les unes dans les autres — par exemple, une instruction if/else dans une boucle for. Cela vous permet de créer des séquences de contenu hautement ciblées.

Lorsque la logique est imbriquée :

• Les icônes de ligne verticale indiquent le niveau d’imbrication de chaque instruction logique.
• Le survol d’une instruction parente met en surbrillance l’ensemble du bloc imbriqué.
• Le survol d’une instruction enfant met en surbrillance uniquement cette instruction enfant.
• Vous pouvez réduire et développer les instructions enfants indépendamment de l’instruction parente.
• Si plus de trois niveaux de logique sont imbriqués, un indicateur + [nombre] s’affiche pour indiquer la profondeur d’imbrication supplémentaire.

Convertir la logique en code

Si vous avez besoin de mieux contrôler votre logique, ou si vous souhaitez utiliser des fonctionnalités non prises en charge, telles que les données d’événement ou les comparaisons de dates, vous pouvez convertir la configuration de votre générateur de logique en code Django brut.

Avertissement : la conversion de la logique en code est une action irréversible et ne peut pas être annulée. Vous ne pourrez pas revenir au générateur de logique après la conversion.

Pour convertir :

1. Ouvrez le panneau latéral du générateur de logique pour le bloc que vous souhaitez mettre à jour.
2. Pour les instructions if/else, chaque segment individuel (if, else if) dispose de son propre bouton Convertir en code. Cliquez sur celui du segment que vous souhaitez convertir.
3. Pour les boucles for, cliquez sur le bouton unique Convertir en code pour l’ensemble de la boucle.
4. Une fenêtre modale d’avertissement s’affichera. Confirmez que vous souhaitez continuer.
5. Après la conversion, le code converti apparaîtra dans un éditeur de code dans le panneau latéral. Vous pouvez le modifier directement depuis cet emplacement.

Cet état converti est permanent — il persistera même après que vous aurez fermé le panneau ou quitté le modèle.

Différences dans l’éditeur de texte uniquement

Le générateur de logique dans l’éditeur en texte uniquement fonctionne de la même manière que dans l’éditeur en glisser-déposer, à une différence près : la logique est configurée dans une fenêtre modale plutôt que dans un panneau latéral. Toutes les mêmes options pour if/else, les boucles for, les tag configurables, l’imbrication et la conversion en code sont disponibles.

Une fois la logique configurée, elle apparaît dans le canevas de la même manière que dans l’éditeur glisser-déposer. Le fait de cliquer sur Modifier sur une condition configurée ouvre la fenêtre modale pour permettre d’autres modifications.

Ressources supplémentaires

• Guide de la logique conditionnelle
• Comment afficher ou masquer des blocs et des sections de modèles en fonction de variables dynamiques
• Guide de personnalisation des messages
• À propos des propriétés personnalisées
• Formation sur l’application des concepts de logiques de programmation pour personnaliser des messages