이메일 스크립팅

Velocity 템플릿 언어 동작에 대한 자세한 설명은 Velocity 사용 안내서를 참조하십시오.

Apache Velocity은(는) HTML 콘텐츠를 템플릿화하고 스크립팅하는 Java 기반 언어입니다. 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 이메일 디자이너에서 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>