Suivez votre progression
Accueil Trailhead
Accueil Trailhead

É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 no 1, qui utilise uniquement des chaînes de personnalisation, et l’e-mail no 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, par exemple une année dans un pied de page avec les 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?*/
Commentaires : 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. 

Remarque

Remarque

Vous souhaitez rafraîchir vos connaissances sur Content Builder ? Consultez le module Trailhead Fonctionnalités de 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.

Personnalisation de Content Builder

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 et cliquez sur Modification terminée.

Exemple de code AMPscript en bloc dans un bloc d’extrait de code

Dans l’unité suivante, nous approfondissons un peu le sujet et allons utiliser des variables et une fonction de recherche pour extraire des données de vos e-mails depuis plusieurs sources. 

Ressources