E-Mail-Skripterstellung

Eine ausführliche Erläuterung ​ Verhaltens der VelocityVorlagensprache finden Sie im Velocity-Benutzerhandbuch .

Apache Velocity ist eine Java-basierte Sprache für die Vorlage und Skripterstellung von HTML-Inhalten. Verwenden Sie Velocity in E-Mail-Skript-Token von Marketo, um auf Daten zuzugreifen, die in Opportunities und benutzerdefinierten Objekten gespeichert sind, und um dynamische E-Mail-Inhalte zu erstellen.

Velocity bietet if/else, for und foreach Steuerungsfluss für bedingte und iterative Inhalte.

Variablen

Variablen mit dem Präfix $. Erstellen oder aktualisieren Sie sie mit #set:

#set($variable = "value")

Abrufen von Variablenwerten mit Verweistypen, die unterschiedliche Verhaltensweisen aufweisen:

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

Die Notation für stille Verweise enthält ! nach der $. Standardmäßig lässt Velocity die Referenzzeichenfolge an Ort und Stelle, wenn eine Referenz nicht definiert ist. Eine stille Referenz gibt keinen Wert aus, wenn sie nicht definiert ist:

##Defined Reference

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

##Undefined Reference

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

##quiet
$!baz ##outputs nothing

Weitere Informationen zum Referenzieren von Variablen finden Sie im Apache-Benutzerhandbuch.

Velocity-Tools

Das Apache Velocity-Projekt stellt Velocity-Tools bereit. Diese Wrapper stellen Java-Objektmethoden über globale Variablen zur Verfügung, die für alle Skripte verfügbar sind.

Um beispielsweise eine Methode aus ComparisonDateTool zu verwenden, greifen Sie über die Variable $date in einem Skript-Token darauf zu:

#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

Erstellen eines Skript-Tokens

Hinzufügen von Velocity-Skripten zu E-Mails mit E-Mail-Skript-Token. Erstellen Sie ein Token in Marketing-Aktivitäten in einem Marketing-Ordner oder -Programm.

Um ein Token verwenden zu können, muss die E-Mail ein untergeordnetes Element des Programms sein, dem das Token gehört, oder von einem Marketing-Ordner erben. Wechseln Sie zu einem Ordner oder Programm und wählen Sie die Registerkarte Meine Token aus. Ziehen Sie die Option E-Mail-Skript aus dem rechten Menü in die Token-Liste.

Bearbeiten Sie den Token-Namen und wählen Sie dann Zum Bearbeiten klicken aus, um den Editor zu öffnen:

Erstellen Sie im Editor ein Skript, das auf Variablen in Objekten zugreift, auf die über ein Skript zugegriffen werden kann. Um einen Objektfeldverweis hinzuzufügen, ziehen Sie ihn aus der rechten Struktur in das Skript:

Einbetten und Testen von Skripten

Nachdem Sie das Skript in einem „Mein Token“-Programm definiert haben, verweisen Sie im E-Mail-Editor von Marketo darauf aus einer E-Mail.

Testen Sie das Skript mit der Aktion Beispiel-E-Mail senden im E-Mail-Designer von Marketo. Wählen Sie einen vorhandenen Lead im Feld Lead aus, damit das Skript ordnungsgemäß verarbeitet wird.

Wählen Sie beim Testen von $TriggerObject das auslösende Objekt mit dem Parameter Trigger ​ aus. Marketo verwendet das zuletzt aktualisierte Objekt dieses Typs als $TriggerObject.

Sie können auch mit E-Mail-Vorschau testen. Wählen Anzeigen als: Lead-Detail und wählen Sie dann einen Lead aus einer statischen Liste aus. Die Vorschau zeigt auch Ausnahmen von der Skriptausführung an:

Bewährte Methoden

Die Gesamtlänge aller E-Mail-Skript-Token in einer bestimmten E-Mail darf 100.000 Byte nicht überschreiten. Diese Begrenzung bezieht sich auf die Gesamtlänge der Token-Zeichenfolgen selbst (nicht auf die Gesamtlänge nach dem Erweitern von Token).

<!-- 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>