Learning Objectives/ Objectifs de formation
After completing this unit, you’ll be able to: / Une fois cette unité terminée, vous pourrez :
- Review the fundamentals and syntax for AMPscript. /Verifier les principes fondamentaux et la syntaxe d’AMPscript.
- Create inline AMPscript and AMPscript blocks./ Créez des blocs AMPscript et AMPscript en ligne.
- Insert personalization strings. / Insérez des chaînes de personnalisation.
- Implement AMPscript functions and operators. / Implémentez les fonctions et les opérateurs AMPscript.
- Work with AMPscript examples and best practices. / Travaillez avec des exemples AMPscript et ces meilleures pratiques.
As a developer, you’re probably familiar with more than a few languages. / En tant que développeur, vous connaissez probablement plusieurs langages.
And as a developer, you know that it’s impossible to learn everything about a language from a single document. / Et en tant que développeur, vous savez qu’il est impossible d’apprendre tout sur une langue à partir d’un seul document.
This module introduces you to the basics of AMPscript, while also giving you the resources you need to dig deeper./ Ce module vous présente les bases d’AMPscript, tout en vous donnant également les ressources dont vous avez besoin pour aller plus loin.
AMPscript Fundamentals and Syntax / Fondamentaux et syntaxe AMPscript
At the most basic level, AMPscript calls act as a placeholder for the data requested from Marketing Cloud or a data extension. / Au niveau le plus basique, les appels AMPscript agissent comme un espace réservé pour les données demandées à Marketing Cloud ou une extension de données.
These calls can appear in one of three basic forms. / Ces appels peuvent apparaître sous l’une des trois formes de base.
- Inline AMPscript:
%%=LOWERCASE(Name)=%%
- AMPscript block:
%%[ LOWERCASE(Name) ]%%
- AMPscript tag:
<script runat=server language=ampscript> Lowercase(Name) </script>
AMPscript can handle constant values, values from attributes and data extensions, and keywords. / AMPscript peut gérer des valeurs constantes, des valeurs d’attributs et d’extensions de données et des mots clés.
This example shows how to produce the same results for all three language elements. / Cet exemple montre comment produire les mêmes résultats pour les trois types de données.
- ‘example@salesforce.com‘ (note the quotes around the string constant /notez les guillemets autour de la constante de chaîne)
- SubscriberEmail (this string returns the value of SubscriberEmail from a data extension, which conveniently is example@salesforce.com /cette chaîne renvoie la valeur de SubscriberEmail à partir d’une extension de données, qui est sous cette forme example@salesforce.com)
- @EmailAddress (this variable holds the value assigned to it earlier in the AMPscript block, which would be example@salesforce.com /cette variable contient la valeur qui lui a été attribuée plus tôt dans le bloc AMPscript, qui serait example@salesforce.com)
Note / Remarque
Use your own email address or another valid address for testing. / Utilisez votre propre adresse e-mail ou une autre adresse valide pour les tests.
AMPscript uses terms you’re probably familiar with, such as IF, ELSEIF, ELSE, and ENDIF. /AMPscript utilise des termes que vous connaissez probablement, tels que IF, ELSEIF, ELSE et ENDIF.
Take a look at this example to see how to implement these conditions in your AMPscript. /Jetez un œil à cet exemple pour voir comment implémenter ces conditions dans votre code AMPscript.
<script runat=server language=ampscript> IF @region == '1' THEN SET @greeting = 'Bonjour!' ELSEIF @region == '2' THEN SET @greeting = 'Hola!' ELSE SET @greeting = 'Hi!' ENDIF </script>
You can include as many ELSEIF statements as necessary for all the conditions you need to evaluate. /Vous pouvez inclure autant d’instructions ELSEIF que nécessaire pour toutes les conditions que vous devez évaluer.
You can also set up FOR loops in AMPscript to iterate over content as many times as necessary. /Vous pouvez également configurer des boucles FOR dans AMPscript pour parcourir le contenu autant de fois que nécessaire.
This example sets the applicable first name values for the number of included roles. /Cet exemple définit les valeurs de prénom applicables pour le nombre de rôles inclus.
%%[FOR @Position = '1' TO @Position = @rowCount DO ]%% SET @FirstName = FirstName %%[NEXT @Position]%%
And, of course, you can assign variables (declared as VAR) in AMPscript using SET. /Et, bien sûr, vous pouvez affecter des variables (déclarées comme VAR) dans AMPscript à l’aide de SET.
%%[ VAR @text SET @text = "Hello, world!" Output(v(@text))]%%
Notice how the Output() function prints the value of the variable contained in the v(). /Remarquez comment la fonction Output () imprime la valeur de la variable contenue dans le v ().
For email messages, remember that AMPscript processes the HTML body of the message first (including any preheader), then the text body. /Pour les e-mails, n’oubliez pas que AMPscript traite d’abord le corps HTML du message (y compris tout en-tête), puis le corps du texte.
The subject line goes last. / La ligne d’objet en dernier.
AMPscript Functions /Fonctions AMPscript
AMPscript uses functions—an extremely large number of functions. / AMPscript utilise des fonctions, un très grand nombre de fonctions.
We divide functions into several different categories. /Nous divisons les fonctions en plusieurs catégories différentes.
AMPscript Function | What It Does |
Fonction AMPscript | Ce qu’il fait |
API | Create SOAP API interactions |
API | Créer des interactions avec l’API SOAP |
Contacts | Modify Marketing Cloud contact information |
Contacts | Modifier les informations de contact de Marketing Cloud |
Content | Modify Marketing Cloud content, such as text and images in email messages. |
Contenu | Modifiez le contenu Marketing Cloud, tel que le texte et les images dans les e-mails. |
Data Extension | Modify data in data extensions |
Extension de données | Modifier des données dans des extensions de données |
Date Time | Modify date and time information in Marketing Cloud |
Date Heure | Modifier les informations de date et d’heure dans Marketing Cloud |
Encryption | Encrypt and decrypt Marketing Cloud data |
Chiffrement | Chiffrer et déchiffrer les données Marketing Cloud |
http | Get, post, and modify HTTP information in Marketing Cloud |
http | Get, post et modifier des informations HTTP dans Marketing Cloud |
Math | Perform basic math functions |
Math | Effectuer des fonctions mathématiques de base |
Microsoft Dynamics CRM | Interact with Microsoft Dynamics CRM data |
CRM Microsoft Dynamics | Interagir avec les données Microsoft Dynamics CRM |
Salesforce | Interact with Sales Cloud data in Marketing Cloud |
Salesforce | Interagir avec les données Sales Cloud dans Marketing Cloud |
Sites | Interact with CloudPages sites |
Sites | Interagir avec les sites CloudPages |
Social | Interact with Social Forward functionality in Email Studio |
Social | Interagissez avec la fonctionnalité Social Forward dans Email Studio |
String | Modify string information in Marketing Cloud |
String | Modifier les informations de chaîne dans Marketing Cloud |
Utilities | Return and evaluate types of Marketing Cloud data |
Utilities | Renvoyer et évaluer les types de données Marketing Cloud |
Personalization Strings / Chaînes de personnalisation
AMPscript offers some easy strings to pull information into content, email addresses, and other areas where you need to dynamically assign values. / AMPscript propose des chaînes simples pour extraire des informations dans le contenu, les adresses e-mail et d’autres domaines dans lesquels vous devez affecter dynamiquement des valeurs.
These personalization strings return data from Email Studio lists. / Ces chaînes de personnalisation renvoient des données à partir des listes Email Studio.
Use AMPscript functions to return content from data extensions in other Marketing Cloud functions. / Utilisez les fonctions AMPscript pour renvoyer le contenu des extensions de données dans d’autres fonctions Marketing Cloud.
Impression Tracking /Suivi des impressions
AMPscript lets you determine which sections of an email message perform better in sends. /AMPscript vous permet de déterminer quelles sections d’un message électronique fonctionnent mieux dans les envois.
We may know intuitively that random cat pictures attract more attention than a block of text, but now you have the statistics to prove it! /Nous pouvons savoir intuitivement que les images aléatoires de chats attirent plus l’attention qu’un bloc de texte, mais maintenant vous avez les statistiques pour le prouver!
Surround a piece of content—pulled in using the ContentArea() or ContentAreaByName() functions—with the BeginImpressionRegion() and EndImpressionRegion() functions, and use impression tracking reports to see how your cat pictures measure up. / Entourez un élément de contenu (tiré à l’aide des fonctions ContentArea () ou ContentAreaByName ()) avec les fonctions BeginImpressionRegion () et EndImpressionRegion () et utilisez des rapports de suivi des impressions pour voir comment vos photos de chat se mesurent.
So What Do I Do with AMPscript? / Alors, que dois-je faire avec AMPscript?
You can perform a number of tasks in Marketing Cloud using these functions. / Vous pouvez effectuer un certain nombre de tâches dans Marketing Cloud à l’aide de ces fonctions.
That said, AMPscript is usually used to pull data from data extensions using calls like Lookup() and LookupRow(). /Cela dit, AMPscript est généralement utilisé pour extraire des données des extensions de données à l’aide d’appels comme Lookup () et LookupRow ().
These functions look for data in specified data extensions and return fields based on the values you include in the functions. /Ces fonctions recherchent des données dans des extensions de données spécifiées et renvoient des champs en fonction des valeurs que vous incluez dans les fonctions.
This example looks up purchases made by a contact identified by a member ID and returns any rows containing purchase information. /Cet exemple recherche les achats effectués par un contact identifié par un ID de membre et renvoie toutes les lignes contenant des informations d’achat.
%%[ VAR @row SET @rows = LookupRows("Purchases","MemberID",@memID)]%%
This example shows how to retrieve a content area from Content Builder in an email message, using the key value. /Cet exemple montre comment récupérer une zone de contenu à partir de Content Builder dans un e-mail, à l’aide de la valeur de clé.
%%=ContentBlockbyKey("myContentBlock")=%%
Once you retrieve that information, you can perform all manner of modifications and transformations to accomplish what you need. / Une fois que vous avez récupéré ces informations, vous pouvez effectuer toutes sortes de modifications et transformations pour accomplir ce dont vous avez besoin.
Next, let’s take a look at Server-side JavaScript (SSJS). / Voyons maintenant le JavaScript côté serveur (SSJS).