이메일 스크립팅

참고: Velocity 사용 안내서 velocity 템플릿 언어의 동작에 대해 자세히 알아보십시오.

Apache Velocity 는 HTML 콘텐츠를 템플릿화하고 스크립팅하기 위해 설계된 Java를 기반으로 구축된 언어입니다. Marketo에서는 스크립팅 토큰을 사용하여 이메일 컨텍스트에서 사용할 수 있습니다. 이를 통해 Opportunities 및 Custom Objects에 저장된 데이터에 액세스할 수 있으며 Email에 동적 콘텐츠를 만들 수 있습니다. Velocity는 조건부 및 반복적인 컨텐츠 조작을 허용하기 위해 각 컨텐츠에 대한 if/else, for 및 for 와 함께 표준 고급 제어 흐름을 제공합니다. 다음은 올바른 인사말로 인사말을 인쇄하는 간단한 예입니다.

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

또한 조용한 참조 표기가 있으며, 여기에는 ! 다음 이후 포함 $. 일반적으로 속도가 정의되지 않은 참조를 발견하면 참조를 나타내는 문자열이 제자리에 남게 됩니다. 자동 참조 표기법을 사용할 때 정의되지 않은 참조가 발생하면 값이 전송되지 않습니다.

##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, 다음에서 if에 액세스: $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 이메일 편집기를 사용하여 주어진 이메일 내에서 참조할 수 있습니다.

다음을 사용하여 스크립트를 테스트할 수 있습니다 Send Sample Email Marketo 이메일 디자이너 내의 이메일 작업. 스크립트가 올바르게 처리되도록 하려면에서 가장할 기존 리드를 선택해야 합니다. 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>