E-Mail-Skripterstellung

HINWEIS: Sie sollten dringend den Velocity-Benutzerhandbuch für einen tiefen Einblick in das Verhalten der Velocity-Vorlagensprache.

Apache Velocity ist eine auf Java basierende Sprache, die für die Vorlagenerstellung und die Skripterstellung von HTML-Inhalten entwickelt wurde. Marketo ermöglicht die Verwendung von Skript-Token im Kontext von E-Mails. Dadurch erhalten Sie Zugriff auf Daten, die in "Chancen"und "Benutzerdefinierte Objekte"gespeichert sind, und können dynamische Inhalte in E-Mails erstellen. Velocity bietet standardmäßigen Steuerungsfluss auf hoher Ebene mit if/else, for und für jede , um bedingte und iterative Bearbeitung von Inhalten zu ermöglichen. Hier ist ein einfaches Beispiel, um eine Grußformel mit der richtigen Anrede zu drucken:

//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...

Variablen

Variablen erhalten immer das Präfix '$' und werden mithilfe von #set festgelegt und aktualisiert:

#set($variable = "value")

Ihre Werte können dann über verschiedene Referenztypen mit unterschiedlichem Verhalten abgerufen werden:

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

Es gibt auch eine stille Referenznotation, bei der eine ! Eingeschlossen nach der $. Wenn bei Geschwindigkeit ein nicht definierter Verweis auftritt, bleibt die Zeichenfolge, die den Verweis darstellt, an Ort und Stelle. Wenn bei stillen Referenznotation ein nicht definierter Verweis auftritt, wird kein Wert ausgegeben:

##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 unter Apache-Benutzerhandbuch.

Velocity-Tools

Das Apache Velocity-Projekt stellt Funktionen durch die Verwendung von Velocity-Tools. Diese sind lediglich Wrapper für Java-Objekte und stellen ihre Methoden über globale Variablen bereit, die für alle Skripte zur Verfügung gestellt werden.

So verwenden Sie beispielsweise eine Methode aus ComparisonDateTool, greifen Sie auf zu, wenn über die $date in einem Skript-Token:

#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

Skript-Token erstellen

Das Velocity-Skript wird mithilfe von E-Mail-Skript-Token in E-Mails eingeschlossen. Diese können in Marketingaktivitäten entweder in einem Marketingordner oder in einem Programm erstellt werden. Damit ein Token in einer E-Mail verwendet werden kann, muss es sich bei der E-Mail um ein untergeordnetes Element eines Programms handeln, das entweder Eigentümer des Tokens ist oder es von einem Marketing-Ordner übernimmt. Um ein Token zu erstellen, navigieren Sie zu einem Ordner oder Programm und wählen Sie die Meine Token Registerkarte. Ziehen Sie aus dem Kontextmenü die Option "E-Mail-Script"in die Token-Liste

Von hier aus können Sie den Namen des Tokens bearbeiten und den Editor über die Klicken zum Bearbeiten Option:

Sobald Sie sich im Editor befinden, können Sie ein Skript mit Zugriff auf alle Variablen in Objekten erstellen, auf die über Skripte zugegriffen werden kann. Um eine Feldreferenz aus einem Objekt zu erhalten, ziehen Sie sie aus der rechten Baumstruktur in das Skript:

Einbetten und Testen von Skripten

Nachdem Sie Ihr Skript in einem Programm-My Token definiert haben, können Sie es mit dem Marketo-E-Mail-Editor in einer bestimmten E-Mail referenzieren.

Sie können Ihr Skript mithilfe der Beispiel-E-Mail senden E-Mail-Aktion im Marketo-E-Mail-Designer. Damit das Skript ordnungsgemäß verarbeitet werden kann, müssen Sie einen vorhandenen Lead auswählen, der im Lead -Feld. Wenn Sie mit $TriggerObject, können Sie das auslösende Objekt über die Trigger param. Dabei werden die Daten des zuletzt aktualisierten Objekts dieses Typs als $TriggerObject -Variable.

Sie können auch die E-Mail-Vorschau , um Ihr Skript zu testen. Wählen Sie dazu Anzeigen als: Lead-Detail und wählen Sie einen Lead aus einer verfügbaren statischen Liste aus. Dies hat den zusätzlichen Vorteil, dass Ausnahmen ausgegeben werden, die möglicherweise während der Skriptausführung aufgetreten sind:

Nützliche Hinweise

Die Gesamtlänge aller E-Mail-Skript-Token in einer 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 der Erweiterung der 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>