電子郵件指令碼

注意：強烈建議您閱讀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

建立指令碼Token

使用電子郵件指令碼Token時，電子郵件中會包含Velocity指令碼。 您可以在行銷資料夾或方案的行銷活動中建立這些檔案。 對於要在電子郵件內使用的權杖，電子郵件必須是擁有權杖或從行銷資料夾繼承權杖之計畫的子項。 若要建立Token，請導覽至資料夾或程式，然後選取「My Tokens」索引標籤。 從右側選單將「電子郵件指令碼」選項拖曳到權杖清單中

從這裡，您可以編輯權杖的名稱，並透過Click to Edit選項開啟編輯器：

進入編輯器後，您可以建立指令碼，以在指令碼可存取的物件中存取所有變數。 若要從物件取得欄位參考，請從右側樹狀結構將其拖曳到您的指令碼中：

指令碼內嵌和測試

在計畫「我的Token」中定義指令碼後，您就可以使用Marketo電子郵件編輯器，在指定的電子郵件中參考該指令碼。

您可以使用Marketo電子郵件設計工具中的Send Sample Email電子郵件動作來測試指令碼。 若要讓指令碼正確處理，您必須在Lead欄位中選取要模擬的現有銷售機會。 如果您使用$TriggerObject進行測試，您可以透過Trigger引數選取觸發物件。 這會使用該型別最近更新之物件的資料做為$TriggerObject變數。

您也可以使用Email Preview來測試您的指令碼。 若要這麼做，您必須選取​ View As: Lead Detail，然後從可用的靜態清單中選取銷售機會。 這樣做的另一個好處是，可輸出指令碼執行期間可能發生的任何例外狀況：

檢視電子郵件

實用提示

指定電子郵件中所有電子郵件指令碼Token的合併長度不得超過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>