Écriture en langage AMPscript

Objectifs de formation

Une fois cette unité terminée, vous pourrez :

• Écrire une instruction simple AMPscript
• Utiliser AMPscript pour des cas d’utilisation spécifiques

Écriture d’une instruction

Maintenant que vous connaissez les fondamentaux du langage AMPscript, voyons comment vous pouvez l’écrire. Après nous être replongés dans nos cours de mathématiques, souvenons-nous cette fois de nos cours de français. Vous rappelez-vous quand vos professeurs vous donnaient des exercices de rédaction ? Peut-être vous ont-ils montré comment écrire dans différents styles, par exemple des poèmes, des histoires et des articles. Vous avez appris que chaque style d’écriture est différent, mais que tous sont corrects. De même, AMPscript peut être écrit de plusieurs manières, toutes correctes. Étudions ces différents styles et quelques exemples, et voyons quand vous pouvez les utiliser.  

Type de style	Exemple de code	Quand l’utiliser	Où l’utiliser
Code AMPscript en ligne	%%=LOWERCASE(FavoriteColor)=%%	Sortie simple	Blocs de forme libre Blocs d’extraits de code Blocs de contenu HTML
Bloc AMPscript	%%[Output(LOWERCASE(FavoriteColor))]%%	Code plus complexe avec plusieurs étapes ou une logique de condition	Blocs d’extraits de code Blocs de contenu HTML
Balise AMPscript	<script runat=server language=ampscript>      Output(LOWERCASE(FavoriteColor))</script>	Code plus complexe avec plusieurs étapes ou une logique de condition À utiliser si vous êtes plus à l’aise avec la syntaxe de script Web (JavaScript)	Blocs d’extraits de code Blocs de contenu HTML

Ces exemples de code accomplissent tous la même tâche : La couleur préférée (FavoriteColor) d’un client s’affiche en minuscule (LOWERCASE) dans l’e-mail envoyé, même si les données sont stockées en majuscules comme dans le tableau suivant.

Nom du champ	Des données
FirstName	Susan
FavoriteColor	RED

Pourquoi avez-vous besoin d’AMPscript pour réaliser cette tâche, alors que vous pouvez simplement utiliser des chaînes de personnalisation ? Examinons ci-dessous la différence entre l’e-mail n^o 1, qui utilise uniquement des chaînes de personnalisation, et l’e-mail n^o 2 qui utilise à la fois une chaîne de personnalisation et du code AMPscript en ligne. 

E-mail n°1	Sortie
Bonjour %%FirstName%%, Nous venons de recevoir de nouvelles vestes de couleur %%FavoriteColor%% dans votre taille. Bon shopping, Le service client	Bonjour Susan, Nous venons de recevoir de nouvelles vestes de couleur ROUGE dans votre taille. Bon shopping, Le service client

E-mail n°2	Sortie
Bonjour %%FirstName%%, Nous venons de recevoir de nouvelles vestes de couleur %%=LOWERCASE(FavoriteColor)=%% dans votre taille. Bon shopping, Le service client	Bonjour Susan, Nous venons de recevoir de nouvelles vestes de couleur rouge dans votre taille. Bon shopping, Le service client

Exemples de code

Maintenant, passons aux choses sérieuses. Voici quelques extraits de code AMPscript en ligne courants pour vous familiariser avec ce nouveau langage.

Ajout d’une date

Vous pouvez inclure des requêtes simples telles que la date et l’heure d’envoi dans votre message.

Code	Fonction
Merci de répondre à cet e-mail le %%=Now()=%%.	Ajoute la date d’envoi à un e-mail.

Mise en forme de la devise

Vous pouvez spécifier le format d’un champ décimal dans une extension de données pour refléter la devise.

Code	Fonction
Montant dû : %%=Format(@price, "C", 'en-US')=%%	Met à jour le prix d’un produit pour refléter la mise en forme correspondant à la devise américaine.

Nettoyage des données

Vous pouvez également manipuler du texte contenu dans une variable pour l’inclure dans votre message.

Code	Fonction
%%=ProperCase(FullName)=%%	Propercase : renvoie la chaîne spécifiée avec la première lettre de chaque mot en majuscule.
%%=Lowercase(FavoriteColor)=%%	Lowercase : renvoie la valeur en lettres minuscules.
%%=Uppercase(FirstName)=%%	Uppercase : renvoie la valeur en lettres majuscules.
%%=Format(Now(), "YYYY")=%%	Format : renvoie la valeur en fonction de la chaîne que vous spécifiez entre guillemets. Vous pouvez ainsi manipuler des données, comme une année dans un pied de page comportant des informations sur les droits d’auteur.

Mise à jour de la langue

Vous pouvez modifier un message d’accueil en fonction de la langue préférée du client. Cette fonction utilise les commandes if, elseif, endif. Voici un exemple qui utilise une balise AMPscript. 

Code	Fonction
<script runat=server language=ampscript> IF @language == 'FR' THEN     SET @greeting = 'Bonjour!' ELSEIF @language == 'SP' THEN SET @greeting = '¡Hola!' ELSE     SET @greeting = 'Hi!' ENDIF </script>	Si la langue d’un client est identifiée comme FR (français), le message d’accueil s’affiche sous la forme « Bonjour ! ». Si la langue d’un client est identifiée comme SP (espagnol), le message d’accueil s’affiche sous la forme « ¡Hola! ». Si la langue du client est définie sur une autre valeur (ou n’est pas indiquée), le message d’accueil s’affiche sous la forme « Hi! ».

Autres exemples

Pour terminer, voici quelques commandes supplémentaires que vous pouvez utiliser.

Code	Fonction
%%=Empty(@variable)=%%	Empty : renvoie true si la valeur est une chaîne vide ou nulle. Vous pouvez l’utiliser lorsqu’une valeur peut être inconnue ou nulle, par exemple le fait que l’abonné a ou non des animaux domestiques.
%%=Concat(@firstname," ",@lastname)=%%	Concat : concatène ou lie des éléments entre eux. Par exemple, vous pouvez utiliser Concat pour afficher un nom complet, même si vous avez enregistré séparément le nom et le prénom dans vos données.
%%=RedirectTo(@samplelink)=%%	RedirectTo :  cette fonction redirige un utilisateur vers une URL spécifiée.
/*Are you still reading this table?*/	Comments : permet de décrire ce que votre code fait pour en informer les autres et pour votre propre usage.

Utilisation d’AMPscript dans les e-mails

Maintenant, passons à la pratique. Où ces nouveaux exemples de code pratiques s’insèrent-ils ? Pouvez-vous les coller n’importe où dans votre e-mail ? Pas vraiment. Revenons à notre exemple qui combine des chaînes de personnalisation et du code AMPscript en ligne, pour montrer comment utiliser AMPscript dans Content Builder. Du code AMPscript en ligne peut être ajouté à la plupart des types de blocs dans Content Builder. 

 Voyons rapidement comment créer un bloc de contenu de forme libre. 

1. Accédez à Content Builder.
2. Cliquez sur Créer, puis Blocs de contenu et enfin Forme libre dans la liste déroulante.
3. Saisissez le texte, y compris tout le code AMPscript en ligne.

Une précision importante : les blocs ou les balises AMPscript ne peuvent être utilisés que dans des extraits de code ou des blocs de contenu HTML. Saisissez simplement votre code AMPscript dans le bloc de contenu, puis cliquez sur Modification terminée.

Dans l’unité suivante, nous approfondirons un peu le sujet en utilisant des variables et une fonction de recherche pour intégrer à vos e-mails des données issues de plusieurs sources. 

Ressources

• Documentation du développeur : Premiers pas avec le développement AMPscript – Leçon 1
• Trailhead : Fonctionnalités de Content Builder