Scripts de e-mails

Leia o Guia do usuário do Velocity para obter uma explicação detalhada do comportamento da linguagem de modelo do Velocity.

Apache Velocity é uma linguagem baseada em Java para modelagem e script de conteúdo HTML. Use os tokens de script de email do Velocity in Marketo para acessar dados armazenados em oportunidades e objetos personalizados e criar conteúdo de email dinâmico.

A Velocity fornece o fluxo de controle if/else, for e foreach para conteúdo condicional e iterativo.

Variáveis

Prefixar variáveis com $. Criar ou atualizar com #set:

#set($variable = "value")

Recupere valores de variável com tipos de referência que fornecem comportamentos diferentes:

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

A notação de referência silenciosa inclui ! após $. Por padrão, a Velocity deixa a string de referência no lugar quando uma referência está indefinida. Uma referência silenciosa não emite valor quando está indefinida:

##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 fornece Ferramentas do Velocity. Esses invólucros expõem métodos de objeto Java por meio de variáveis globais disponíveis para todos os scripts.

Por exemplo, para usar um método de ComparisonDateTool, acesse-o a partir 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

Adicione scripts do Velocity a emails com tokens de script de email. Crie um token em Atividades de marketing em uma pasta ou programa de marketing.

Para usar um token, o email deve ser secundário ao programa que possui o token ou herdá-lo de uma pasta de marketing. Vá para uma pasta ou programa e selecione a guia Meus tokens. Arraste a opção Script de email do menu direito para a lista de tokens.

Edite o nome do token e selecione Clique para Editar para abrir o editor:

No editor, crie um script que acesse variáveis em objetos acessíveis por script. Para adicionar uma referência de campo de objeto, arraste-a da árvore direita para o script:

Incorporação e teste do script

Depois de definir o script em um programa Meu token, faça referência a ele por um email no editor de email do Marketo.

Teste o script com a ação Enviar Email de Exemplo no designer de email do Marketo. Selecione um cliente potencial existente no campo Cliente Potencial para que o script seja processado corretamente.

Ao testar $TriggerObject, selecione o objeto de disparo com o parâmetro Trigger. O Marketo usa o objeto atualizado mais recentemente desse tipo como a variável $TriggerObject.

Você também pode testar com Visualização de email. Selecione Exibir como: Detalhe de Cliente Potencial e selecione um cliente potencial em uma lista estática. A visualização também exibe exceções da execução do script:

Práticas recomendadas

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>