Script de l'e-mail

REMARQUE : il est vivement recommandé de lire le Guide de l’utilisateur Velocity pour une analyse approfondie du comportement du langage de modèle Velocity.

Apache Velocity est un langage basé sur Java qui a été conçu pour créer des modèles et des scripts de contenu HTML. Marketo permet de l’utiliser dans le contexte des e-mails à l’aide de jetons de script. Cela donne accès aux données stockées dans les opportunités et les objets personnalisés, et permet la création de contenu dynamique dans les e-mails. Velocity offre un flux de contrôle standard de haut niveau avec if/else, for et for each pour permettre la manipulation conditionnelle et itérative du contenu. Voici un exemple simple pour imprimer un message d’accueil avec la formule de salutation appropriée :

##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ù un ! est 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 laissée en place. Avec la notation de référence silencieuse, si une référence non définie est rencontrée, alors 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 référence à des variables, consultez le Guide d’utilisation d’Apache.

Outils Velocity

Le projet Apache Velocity rend les fonctionnalités disponibles à l’aide des outils Velocity. Il s’agit simplement de wrappers pour les objets Java, qui exposent leurs méthodes par le biais de variables globales accessibles à tous les scripts.

Par exemple, pour utiliser une méthode à partir de ComparisonDateTool, accédez à depuis 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 e-mails à l’aide de jetons de script de messagerie. Ils peuvent être créés dans des activités marketing dans un dossier marketing ou un programme. Pour qu’un jeton soit utilisé dans un e-mail, l’e-mail doit être l’enfant d’un programme qui détient le jeton ou qui l’hérite d’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 d’e-mail » dans la liste des jetons

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

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

Incorporation et test de scripts

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

Vous pouvez tester votre script à l’aide de l’action d’e-mail Envoyer un exemple d’e-mail dans le concepteur d’e-mail Marketo. Pour que le script s’exécute correctement, vous devez sélectionner un prospect existant à emprunter dans le champ Lead. Si vous effectuez un test avec $TriggerObject, vous pouvez sélectionner l’objet de déclenchement à l’aide du paramètre Trigger. Cette méthode utilise les données de l’objet de ce type le plus récemment mis à jour comme variable $TriggerObject.

Vous pouvez également utiliser l’Aperçu de l’e-mail pour tester votre script. Pour ce faire, vous devez sélectionner Afficher en tant que : Détails du lead, puis sélectionner un lead dans une liste statique disponible. Cela a l’avantage supplémentaire 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 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>