电子邮件脚本

有关Velocity模板语言行为的详细说明，请阅读Velocity用户指南。

Apache Velocity是一种基于Java的语言，用于模板化和编写HTML内容的脚本。 在Marketo电子邮件脚本令牌中使用Velocity可访问存储在商机和自定义对象中的数据并创建动态电子邮件内容。

Velocity为条件内容和迭代内容提供了if/else、for和foreach控制流。

变量

为变量添加前缀$。 使用#set创建或更新它们：

#set($variable = "value")

使用提供不同行为的引用类型检索变量值：

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

$之后的静默引用表示法包括!。 默认情况下，当引用未定义时，Velocity将保留引用字符串。 静默引用未定义时不会发送任何值：

##Defined Reference

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

##Undefined Reference

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

##quiet
$!baz ##outputs nothing

有关如何引用变量的更多信息，请参阅Apache用户指南。

Velocity工具

Apache Velocity项目提供Velocity工具。 这些包装器通过可用于所有脚本的全局变量公开Java对象方法。

例如，要使用ComparisonDateTool中的方法，请从脚本令牌中的$date变量访问该方法：

#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

创建脚本令牌

向带有电子邮件脚本令牌的电子邮件添加Velocity脚本。 在营销文件夹或项目的营销活动中创建令牌。

要使用令牌，电子邮件必须是拥有该令牌的程序的子项，或从营销文件夹继承该令牌。 转到文件夹或项目群，然后选择My Tokens选项卡。 将右侧菜单中的“电子邮件脚本”选项拖入令牌列表。

编辑令牌名称，然后选择Click to Edit以打开编辑器：

在编辑器中，创建一个脚本，用于访问可访问脚本的对象中的变量。 要添加对象字段引用，请将其从右树拖动到脚本中：

脚本嵌入和测试

在程序“我的令牌”中定义脚本后，从Marketo电子邮件编辑器中的电子邮件引用该脚本。

在Marketo Email Designer中使用Send Sample Email操作测试脚本。 在Lead字段中选择现有潜在客户，以便脚本正确处理。

测试$TriggerObject时，选择包含Trigger参数的触发对象。 Marketo使用该类型的最近更新的对象作为$TriggerObject变量。

您还可以使用Email Preview进行测试。 选择​View As: Lead Detail，然后从静态列表中选择潜在客户。 预览还会显示脚本执行的异常：

最佳实践

给定电子邮件中所有电子邮件脚本令牌的组合长度不得超过100,000字节。 此限制与令牌字符串本身的总长度有关（而不是令牌扩展后的总长度）。

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