Scripts de e-mails

OBSERVAÇÃO: é altamente recomendável que você leia o Guia do usuário do Velocity para aprofundar-se no comportamento da Linguagem de modelo do Velocity.

Apache Velocity é uma linguagem criada em Java projetada para modelos e scripts de conteúdo de HTML. O Marketo permite que ele seja usado no contexto de emails usando tokens de script. Isso dá acesso aos dados armazenados em Oportunidades e Objetos personalizados e permite a criação de conteúdo dinâmico em emails. A Velocity oferece um fluxo de controle padrão de alto nível com if/else, for e for para permitir a manipulação condicional e iterativa do conteúdo. Este é um exemplo simples para imprimir uma saudação com a saudação correta:

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

Variáveis

As variáveis sempre recebem o prefixo '$' e são definidas e atualizadas usando #set:

#set($variable = "value")

Seus valores podem ser recuperados por meio de vários tipos de referência diferentes com comportamentos diferentes:

$variable ##outputs 'value'
$variablename ##outputs '$variablename'
${variable}name ##outputs 'valuename'

Também há uma notação de referência silenciosa, em que há um ! Incluído após o $. Normalmente, quando a velocidade encontra uma referência indefinida, a string que representa a referência é deixada no lugar. Com a notação de referência silenciosa, se uma referência indefinida for encontrada, nenhum valor será emitido:

##Defined Reference

#set($foo = "bar")
$foo ##outputs "bar"

##Undefined Reference

##normal
$baz ##outputs "$baz"

##quiet
$!baz ##outputs nothing

Para obter mais informações sobre como fazer referência a variáveis, consulte o Guia do Usuário do Apache.

Ferramentas do Velocity

O projeto Apache Velocity disponibiliza a funcionalidade por meio das Ferramentas do Velocity. Eles são apenas invólucros para objetos Java e expõem seus métodos por meio de variáveis globais que são disponibilizadas para todos os scripts.

Por exemplo, para usar um método de ComparisonDateTool, acesse se for da variável $date em um token de script:

#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

Criação de um token de script

O script do Velocity é incluído nos emails usando tokens de script de email. Eles podem ser criados em Atividades de marketing em uma Pasta de marketing ou em um Programa. Para que um token seja usado dentro de um email, o email deve ser filho de um programa que possua o token ou o herde de uma pasta de marketing. Para criar um token, navegue até uma pasta ou programa e selecione a guia Meus tokens. No menu direito, arraste a opção "Script de email" para a lista de tokens

Aqui, você pode editar o nome do token e abrir o editor por meio da opção Clique para editar:

Quando estiver no editor, você poderá criar um script com acesso a todas as variáveis em objetos acessíveis por script. Para obter uma referência de campo de um objeto, arraste-a da árvore direita para o script:

Incorporação e teste do script

Depois de definir o script em um Meu token de programa, você pode referenciá-lo em um determinado email usando o editor de email do Marketo.

Você pode testar seu script usando a ação de email Enviar Email de Exemplo no designer de email do Marketo. Para que o script seja processado corretamente, você deve selecionar um cliente potencial existente para representar no campo Cliente Potencial. Se você estiver testando com $TriggerObject, é possível selecionar o objeto de acionamento por meio do parâmetro Acionador. Isso usa os dados do objeto atualizado mais recentemente desse tipo como a variável $TriggerObject.

Você também pode usar a Visualização de email para testar seu script. Para fazer isso, selecione Exibir como: Detalhe de Cliente Potencial e selecione um cliente potencial em uma lista estática disponível. Isso tem a vantagem adicional de gerar quaisquer exceções que possam ter ocorrido durante a execução do script:

Dicas úteis

O comprimento combinado de todos os tokens de script de email em um determinado email não pode exceder 100.000 bytes. Esse limite pertence ao comprimento total das próprias cadeias de caracteres do token (não ao comprimento total após a expansão dos tokens).

<!-- 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>