Script de l'e-mail

REMARQUE : Il est vivement recommandé de lire le Guide de l’utilisateur Velocity pour découvrir en détail le comportement du langage de modèle Velocity.

Apache Velocity est un langage Java conçu pour créer des modèles et des scripts de contenu d’HTML. Marketo permet de l’utiliser dans le contexte des emails à l’aide de jetons de script. Cela permet d’accéder aux données stockées dans Opportunités et Objets personnalisés et de créer du contenu dynamique dans les emails. Velocity offre un flux de contrôle de haut niveau standard avec si/sinon, pour et pour chacun d’eux afin de permettre une manipulation conditionnelle et itérative du contenu. Voici un exemple simple pour imprimer un message de salutation correct :

//check if the lead is male
if(${lead.MarketoSocialGender} == "Male")
    if the lead is male, use the salutation 'Mr.'
    set($greeting = "Dear Mr. ${lead.LastName},")
//check is the lead is female
elseif(${lead.MarketoSocialGender} == "Female")
    if female, use the salutation 'Ms.'
    set($greeting = "Dear Ms. ${lead.LastName},")
else
    //otherwise, use the first name
    set($greeting = "Dear ${lead.FirstName},")
end
print the greeting and some content
${greeting}

    Lorem ipsum dolor sit amet...

Variables

Les variables sont toujours précédées du préfixe '$' et sont définies et mises à jour à l’aide de #set :

#set($variable = "value")

Leurs valeurs peuvent ensuite être récupérées via plusieurs types de référence différents avec des comportements différents :

$variable ##outputs 'value'
$variablename ##outputs '$variablename'
${variable}name ##outputs 'valuename'

Il existe également une notation de référence silencieuse, où il existe un ! inclus après le $. Normalement, lorsque la vitesse rencontre une référence non définie, la chaîne représentant la référence est conservée. Avec une notation de référence silencieuse, si une référence non définie est rencontrée, aucune valeur n’est émise :

##Defined Reference

#set($foo = "bar")
$foo ##outputs "bar"

##Undefined Reference

##normal
$baz ##outputs "$baz"

##quiet
$!baz ##outputs nothing

Pour plus d’informations sur la manière de référencer des variables, consultez le Guide de l’utilisateur Apache.

Outils de vitesse

Le projet Apache Velocity rend la fonctionnalité disponible à l’aide des outils Velocity. Il s’agit simplement de wrappers pour les objets Java et d’exposer leurs méthodes par le biais de variables globales mises à la disposition de tous les scripts.

Par exemple, pour utiliser une méthode de ComparisonDateTool, accédez à if à partir de la variable $date dans un jeton de script :

#set($birthday = $convert.parseDate("2015-08-07","yyyy-MM-dd"))
##use whenIs to determine how many days away it is
$date.whenIs($birthday).days ##outputs 1

Création d’un jeton de script

Le script Velocity est inclus dans les emails à l’aide de jetons de script de messagerie. Ils peuvent être créés dans Activités marketing dans un dossier marketing ou un programme. Pour qu’un jeton soit utilisé dans un email, celui-ci doit être un enfant d’un programme qui possède le jeton ou en hérite depuis un dossier marketing. Pour créer un jeton, accédez à un dossier ou à un programme, puis sélectionnez l’onglet Mes jetons. Dans le menu de droite, faites glisser l'option "Script de l'email" dans la liste des jetons.

À partir de là, vous pouvez modifier le nom du jeton et ouvrir l’éditeur à l’aide de l’option Cliquez pour modifier :

Une fois que vous êtes dans l’éditeur, vous pouvez créer un script ayant accès à toutes les variables des objets accessibles par script. Pour obtenir une référence de champ à partir d’un objet, faites-la glisser dans votre script à partir de l’arborescence de droite :

Incorporation et test de script

Une fois que votre script est défini dans un programme Mon jeton, vous pouvez le référencer dans un email donné à l’aide de l’éditeur de messagerie de Marketo.

Vous pouvez tester votre script à l’aide de l’action de messagerie Envoyer un exemple de courrier électronique dans le concepteur d’email de Marketo. Pour que le script soit traité correctement, vous devez sélectionner une piste existante à emprunter dans le champ Lead. Si vous effectuez un test avec $TriggerObject, vous pouvez sélectionner l’objet de déclenchement via le paramètre Trigger . Cela utilise les données de l’objet mis à jour le plus récemment de ce type comme variable $TriggerObject.

Vous pouvez également utiliser l’ aperçu de l’email pour tester votre script. Pour ce faire, vous devez sélectionner Afficher comme : détails de la piste et sélectionner une piste dans une liste statique disponible. Cela a pour avantage de générer des exceptions qui peuvent s’être produites lors de l’exécution du script :

Conseils utiles

La longueur combinée de tous les jetons de script de courrier électronique dans un email donné ne peut pas dépasser 100 000 octets. Cette limite concerne la longueur totale des chaînes de jeton elles-mêmes (et non la longueur totale après l’extension des jetons).

<!-- Correct -->
#set($url = "www.example.com/${object.id}")
<a href="http://${url}">Link Text</a>

<!-- Correct -->
<a href="http://www.example.com/${object.id}">Link Text</a>

<!-- Incorrect -->
<a href="${url}">Link Text</a>

<!-- Incorrect -->
<a href="{{my.link}}">Link Text</a>

<!-- Incorrect -->
<a href="http://{{my.link}}">Link Text</a>