Script de l'e-mail

REMARQUE : Il est vivement recommandé de lire le Guide de l’utilisateur Velocity pour en savoir plus sur le comportement du langage de modèle Velocity.

Apache Velocity est un langage basé sur Java qui est conçu pour modéliser et scripter le contenu des HTMLS. 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 une ! 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, voir Guide de l’utilisateur Apache.

Outils de vitesse

Le projet Apache Velocity met à disposition des fonctionnalités à l’aide de la fonction Outils de vitesse. 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 à si à partir de $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’option 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 via le Cliquez sur Modifier . option :

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 la fonction Envoyer un exemple de courrier électronique action 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 pour emprunter l’identité du prospect champ . Si vous effectuez un test avec $TriggerObject, vous pouvez sélectionner l’objet de déclenchement à l’aide de l’option Déclencheur param. Cette méthode utilise les données de l’objet mis à jour le plus récemment de ce type comme $TriggerObject Variable .

Vous pouvez également utiliser la variable Email Preview pour tester votre script. Pour ce faire, vous devez sélectionner Afficher sous : détails de la piste, puis sélectionnez 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>