Configurer du contenu dynamique avec des structures if

Les if-structures sont une manière, basée sur le texte, d'ajouter du contenu dynamique à vos messages. Elles vous permettent d'afficher des textes, des images ou des liens différents à différents contacts au sein d'un même e-mail, en fonction des informations dont vous disposez à leur sujet dans vos champs personnalisés.

Utilisez les if-structures lorsque le panneau de contenu dynamique au niveau de la structure n'est pas suffisamment précis — par exemple, lorsque vous souhaitez personnaliser une seule phrase à l'intérieur d'un paragraphe, ou ne remplacer que quelques mots d'une salutation. Les if-structures fonctionnent dans l'Email Builder, le modèle Wizard et l'éditeur HTML.

Prérequis

• Vous connaissez le nom du placeholder du champ personnalisé que vous souhaitez utiliser. Vous trouverez les noms de placeholders dans Configuration > Gérer les champs personnalisés.
• Votre profil de test dans Configuration est renseigné avec des valeurs représentatives, afin que vous puissiez prévisualiser le résultat.

Syntaxe de base

Une if-structure se construit en trois parties : une ouverture {if ...} , un {else}  facultatif et une fermeture {/if} . Entre les deux, vous placez le contenu que vous souhaitez afficher.

Afficher un contenu uniquement lorsque la condition est vraie :

{if ::firstname::!=""}

Afficher un contenu lorsque la condition est vraie, et un contenu de repli lorsqu'elle ne l'est pas :

{if ::firstname::!=""}Bonjour #firstname#,{else}Bonjour,{/if}

La partie entre {if  et }  est la condition — c'est là que vous décrivez ce que vous souhaitez vérifier. Tout le reste n'est que du contenu.

Faire référence à un champ personnalisé

À l'intérieur d'une if-structure, vous faites référence à un champ personnalisé en encadrant son placeholder de deux deux-points : ::placeholder:: . Par exemple, pour vérifier le champ prénom, vous écrivez ::firstname:: .

Cette syntaxe diffère de la forme #placeholder#  utilisée pour la personnalisation classique. À l'intérieur des if-structures, utilisez toujours la forme ::placeholder:: .

Fonctions disponibles

Vérifier la valeur d'un champ de contact

L'usage le plus courant d'une if-structure est de vérifier ce qui est stocké dans un champ de contact et d'afficher du contenu en conséquence.

{if ::language::=="fr"}Bonjour{else}Hello{/if}

Les contacts dont la langue de contact est le français voient « Bonjour ». Tous les autres voient « Hello ».

Uppercase, lowercase, uppercaseFirst

Les vérifications de valeur sont sensibles à la casse dans les if-structures. « Value » et « value » ne sont pas équivalents, et certains contacts peuvent passer à côté de votre condition simplement parce que leur champ a été stocké avec une casse différente. Encadrez le champ avec uppercase(...) ou lowercase(...) pour comparer en toute sécurité :

{if uppercase(::placeholder::)=="VALUE"}...{/if}

{if lowercase(::placeholder::)=="value"}...{/if}

Fallback

Utilisez {fallback(...)}  lorsque vous souhaitez afficher la valeur du champ d'un contact, avec une valeur par défaut pour les contacts dont le champ est vide. C'est plus simple qu'une if-else complète dans ce cas de figure courant.

Cher/Chère {fallback(::firstname::,"client(e)")}

Les contacts qui ont un prénom voient « Cher/Chère Sarah ». Les contacts qui n'en ont pas voient « Cher/Chère client(e) ». À noter que {fallback(...)} s'utilise seul, entre accolades — il n'a pas besoin d'être encadré par des balises {if}.

Contains

Utilisez contains() lorsque vous ne souhaitez vérifier qu'une partie de la valeur d'un champ, et non une correspondance exacte.

{if contains(::haystack::,"Needle")} … {else} … {/if}

Length

Utilisez length(...) lorsque le nombre de caractères d'un champ doit déterminer le contenu. Par exemple, imaginons que vous vendiez des porte-clés personnalisés, mais que seuls 7 caractères puissent tenir sur le produit :

{if length(::firstname::)<7} Article sur les porte-clés personnalisés {else} … {/if}

Où placer les if-structures

Vous pouvez placer des if-structures partout où vous pouvez taper du texte : à l'intérieur d'un élément texte dans l'Email Builder, dans les zones de texte du modèle Wizard, ou dans l'éditeur HTML. Elles fonctionnent de la même façon dans les trois outils.

Imbrication

Vous pouvez imbriquer des if-structures les unes dans les autres pour des combinaisons plus précises :

{if ::language::=="NL"} 
    {if ::country::=="BE"}Welkom in België 
    {else}Welkom{/if} 
{else}Welcome{/if}

Limitez l'imbrication au minimum. Deux niveaux de profondeur suffisent généralement largement — au-delà, cela devient difficile à lire et facile à casser.

Erreurs courantes à éviter

• Oublier de fermer la if-structure avec {/if}. Une structure non fermée casse le message et peut produire un résultat inattendu.
• Utiliser #placeholder# au lieu de ::placeholder::. À l'intérieur d'une if-structure, seule la forme ::placeholder:: fonctionne.
• Utiliser un nom de placeholder qui ne correspond pas à ce qui figure dans Configuration. Les noms de placeholders doivent correspondre exactement. Vérifiez dans Configuration > Gérer les champs personnalisés si vous n'êtes pas certain.
• Comparer des valeurs avec des casses différentes. « FR » et « fr » ne sont pas équivalents. Encadrez le champ avec uppercase(...) ou lowercase(...) pour rendre la comparaison insensible à la casse.
• Essayer de vérifier un intérêt ou un segment. Les if-structures ne fonctionnent qu'avec des champs personnalisés. Pour les intérêts ou les segments, utilisez le panneau de contenu dynamique au niveau de la structure dans l'Email Builder.

Étapes suivantes

• Consultez « Le contenu dynamique dans l'Email Builder » pour l'alternative au niveau de la structure, qui ne nécessite aucune syntaxe.
• Consultez « Personnaliser un message avec des espaces réservés » pour insérer directement les valeurs des champs de contact dans votre texte.
• Retrouvez vos noms de placeholders dans Configuration > Gérer les champs personnalisés.