电子邮件脚本

注意：强烈建议您阅读Velocity用户指南，以深入了解Velocity模板语言的行为。

Apache Velocity是一种基于Java构建的语言，专为模板化和编写HTML内容脚本而设计。 利用Marketo，可通过使用脚本令牌在电子邮件上下文中使用它。 这样可访问存储在商机和自定义对象中的数据，并允许在电子邮件中创建动态内容。 Velocity提供了标准的高级控制流，其中包含if/else、for和for each ，以允许对内容进行条件和迭代操作。 以下是一个打印问候语和正确问候语的简单示例：

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

变量

变量始终以“$”为前缀，并使用#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选项卡。 从右侧菜单中，将“Email Script”选项拖动到令牌列表中

在此处，您可以编辑令牌的名称，并通过Click to Edit选项打开编辑器：

进入编辑器后，您可以创建一个脚本，以便访问可脚本访问对象中的所有变量。 要从对象获取字段引用，请将其从右侧树拖入脚本中：

脚本嵌入和测试

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

您可以使用Marketo Email Designer中的Send Sample Email电子邮件操作测试脚本。 要使脚本正确处理，您必须在Lead字段中选择要模拟的现有潜在客户。 如果您正在使用$TriggerObject进行测试，则可以通过Trigger参数选择触发对象。 这会使用该类型的最近更新对象的数据作为$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>