メールスクリプト

メモ：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'

$ の後に Included という ! があるクワイエット参照表記もあります。 通常、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 変数から if にアクセスします。

#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 スクリプトは、メールスクリプティングトークンを使用してメールに含まれます。 これらは、マーケティングフォルダーまたはプログラムのマーケティングアクティビティで作成できます。 トークンをメール内で使用するには、そのメールが、トークンを所有するプログラムの子であるか、マーケティングフォルダーから継承されている必要があります。 トークンを作成するには、フォルダーまたはプログラムに移動し、「​ マイトークン ​」タブを選択します。 右側のメニューから「Email Script」オプションをトークン・リストにドラッグします

ここから、トークンの名前を編集し、「​ クリックして編集 ​ オプションでエディターを開くことができます。

エディターを開くと、スクリプトでアクセス可能なオブジェクト内のすべての変数にアクセスできるスクリプトを作成できます。 オブジェクトからフィールド参照を取得するには、右側のツリーからスクリプトにドラッグします。

スクリプトの埋め込みとテスト

プログラムマイトークン内でスクリプトを定義したら、特定のメール内でMarketoのメールエディターを使用してスクリプトを参照できます。

Marketoのメールデザイナー内で「​ サンプルのメールを送信 ​」メールアクションを使用して、スクリプトをテストできます。 スクリプトが正しく処理されるようにするには、別のユーザーとして実行する既存のリードを「​ リード ​」フィールドで選択する必要があります。 $TriggerObject を使用してテストしている場合は、​ トリガー パラメーターを介してトリガーオブジェクトを選択できます。 そのタイプの最も新しく更新されたオブジェクトのデータを $TriggerObject 変数として使用します。

また、​ メールのプレビュー ​ を使用して、スクリプトをテストすることもできます。 これを行うには、「表示形態：リード詳細」を選択し、使用可能な静的リストからリードを選択する必要があります。 これには、スクリプトの実行中に発生した例外を出力できるという利点もあります。

役に立つヒント

特定のメール内のすべてのメールスクリプトトークンの長さを組み合わせた長さは、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>