Explore AMPscript / Découvrez AMPscript

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 FunctionWhat It Does
Fonction AMPscriptCe qu’il fait
APICreate SOAP API interactions
APICréer des interactions avec l’API SOAP
ContactsModify Marketing Cloud contact information
ContactsModifier les informations de contact de Marketing Cloud
ContentModify Marketing Cloud content, such as text and images in email messages.
ContenuModifiez le contenu Marketing Cloud, tel que le texte et les images dans les e-mails.
Data ExtensionModify data in data extensions
Extension de donnéesModifier des données dans des extensions de données
Date TimeModify date and time information in Marketing Cloud
Date HeureModifier les informations de date et d’heure dans Marketing Cloud
EncryptionEncrypt and decrypt Marketing Cloud data
ChiffrementChiffrer et déchiffrer les données Marketing Cloud
httpGet, post, and modify HTTP information in Marketing Cloud
httpGet, post et modifier des informations HTTP dans Marketing Cloud
MathPerform basic math functions
MathEffectuer des fonctions mathématiques de base
Microsoft Dynamics CRMInteract with Microsoft Dynamics CRM data
CRM Microsoft DynamicsInteragir avec les données Microsoft Dynamics CRM
SalesforceInteract with Sales Cloud data in Marketing Cloud
SalesforceInteragir avec les données Sales Cloud dans Marketing Cloud
SitesInteract with CloudPages sites
SitesInteragir avec les sites CloudPages
SocialInteract with Social Forward functionality in Email Studio
SocialInteragissez avec la fonctionnalité Social Forward dans Email Studio
StringModify string information in Marketing Cloud
StringModifier les informations de chaîne dans Marketing Cloud
UtilitiesReturn and evaluate types of Marketing Cloud data
UtilitiesRenvoyer 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).

Resources /Ressources

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée. Les champs obligatoires sont indiqués avec *