Script de l’e-mail

Lisez le Guide d’utilisation de Velocity pour une explication détaillée du comportement du langage de modèle Velocity.

Apache Velocity est un langage Java permettant de créer des modèles et des scripts de contenu HTML. Utilisez Velocity dans les jetons de script d’e-mail Marketo pour accéder aux données stockées dans les opportunités et les objets personnalisés et créer du contenu d’e-mail dynamique.

Velocity fournit un flux de contrôle if/else, for et foreach pour le contenu conditionnel et itératif.

Variables

Préfixez les variables avec $. Créez-les ou mettez-les à jour avec les #set suivantes :

#set($variable = "value")

Récupérez des valeurs de variable avec des types référence qui fournissent différents comportements :

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

La notation de référence silencieuse inclut les ! après $. Par défaut, Velocity laisse la chaîne de référence en place lorsqu’une référence est indéfinie. Une référence silencieuse n’émet aucune valeur lorsqu’elle est indéfinie :

##Defined Reference

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

##Undefined Reference

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

##quiet
$!baz ##outputs nothing

Pour plus d’informations sur la référence à des variables, consultez le Guide d’utilisation d’Apache.

Outils Velocity

Le projet Apache Velocity fournit des outils Velocity. Ces wrappers exposent les méthodes d’objet Java par le biais de variables globales disponibles pour tous les scripts.

Par exemple, pour utiliser une méthode à partir de ComparisonDateTool, accédez-y à 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

Ajoutez des scripts Velocity aux e-mails avec des jetons de script d’e-mail. Créez un jeton dans les Activités marketing au sein d’un dossier ou d’un programme marketing.

Pour utiliser un jeton, l’e-mail doit être un enfant du programme propriétaire du jeton ou hériter de celui-ci d’un dossier marketing. Accédez à un dossier ou un programme et sélectionnez l’onglet Mes jetons. Faites glisser l’option Script d’e-mail du menu de droite vers la liste de jetons.

Modifiez le nom du jeton, puis sélectionnez Cliquer pour modifier pour ouvrir l’éditeur :

Dans l’éditeur, créez un script qui accède aux variables dans les objets accessibles par script. Pour ajouter une référence de champ d’objet, faites-la glisser de l’arborescence de droite vers le script :

Incorporation et test de scripts

Après avoir défini le script dans un programme Mon jeton, référencez-le à partir d’un e-mail dans l’éditeur d’e-mail de Marketo.

Testez le script avec l’action Envoyer un exemple d’e-mail dans le concepteur d’e-mail Marketo. Sélectionnez un prospect existant dans le champ Prospect afin que le script procède correctement.

Lors du test des $TriggerObject, sélectionnez l’objet de déclenchement avec le paramètre Trigger. Marketo utilise l’objet de ce type mis à jour le plus récemment comme variable $TriggerObject.

Vous pouvez également effectuer des tests avec Aperçu de l’e-mail. Sélectionnez Afficher en tant que : Détails du lead, puis sélectionnez un lead dans une liste statique. L’aperçu affiche également les exceptions à l’exécution du script :

Meilleures pratiques

La longueur combinée de tous les jetons de script d’e-mail dans un e-mail 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 le développement 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>