Principais lições
- Os scripts de velocidade do Marketo adaptam um único e-mail para cada destinatário.
- Os tokens padrão não podem ler registros de objetos personalizados; os scripts podem.
- Um único campo vazio pode quebrar um script para milhares de usuários.
- Faça testes com registros de casos extremos antes de cada envio, não depois.
- Os scripts alteram o que os destinatários veem, nunca quem recebe a informação.
- A IA pode elaborar um roteiro; uma pessoa precisa testá-lo.
Conteúdo

Os scripts de velocidade do Marketo podem fazer com que um único e-mail pareça ter sido escrito para cada lead, e um campo vazio pode, silenciosamente, quebrá-lo para milhares deles. Você criou Listas Inteligentes que selecionam exatamente quem recebe cada mensagem, mas o conteúdo visualizado por essas pessoas ainda é limitado. Os tokens padrão inserem um nome ou o nome da empresa. O conteúdo dinâmico exige uma regra separada para cada variação.
Quando você precisa combinar campos, limpar dados desorganizados ou ler registros de objetos personalizados, os recursos nativos do Marketo se tornam insuficientes para a personalização de e-mails. Este guia explica como os scripts de velocidade do Marketo funcionam, quando sua complexidade se justifica, como testá-los e onde a IA pode ajudar sem comprometer seus envios.
O que são os scripts de velocidade do Marketo?
Um script Velocity do Marketo é um bloco de código da linguagem Apache Velocity Template Language que avalia dados de leads e objetos personalizados e gera conteúdo de e-mail personalizado que os tokens padrão não conseguem produzir.
Os scripts de velocidade do Marketo usam a linguagem de modelo Apache Velocity (VTL), uma sintaxe de script criada para conteúdo dinâmico. Um token básico exibe o valor de um campo, enquanto um script avalia condições e produz resultados com base na lógica definida por você. No Marketo, você cria um script como um token de Script de E-mail: abra a guia Meus Tokens em uma pasta ou programa de marketing, arraste a opção Script de E-mail para a lista de tokens e, em seguida, faça referência a ele em seu e-mail. A Adobe documenta a sintaxe e as limitações em seu guia de scripts de e-mail do Marketo Engage.
Uma observação sobre os nomes: "velocidade da campanha", a métrica de velocidade que mede a rapidez com que sua equipe lança uma campanha, refere-se ao tempo de ciclo, enquanto um script de velocidade é uma técnica para personalizar um e-mail.
Como funciona a linguagem de modelos no Marketo
Os scripts de velocidade do Marketo são executados quando o Marketo cria o e-mail para cada destinatário. A Adobe descreve o comportamento dos scripts em Enviar Amostra, Campanha em Lote, Acionar Campanha e Visualização de E-mail, e esses são os locais para realizar testes. A linguagem de modelo usada pelo Marketo funciona em conjunto com tokens padrão, e um script pode combinar vários campos de uma só vez.
Em vez de mostrar um nome de produto genérico, você pode considerar o tamanho da empresa, o setor e o histórico de engajamento em conjunto e recomendar um nível de produto, com uma linha explicando por que ele é adequado para aquele cliente potencial.
Importante: um script apenas cria o conteúdo do e-mail. Ele não pode atualizar registros de leads, acionar fluxos de trabalho ou escolher quem receberá o e-mail.
Quais são as principais funcionalidades de um script Velocity?
Os scripts de velocidade do Marketo oferecem quatro recursos que a personalização nativa não consegue igualar facilmente.
Lógica Condicional de Múltiplos Campos
Um único script pode se comportar de maneira diferente para cada destinatário. Ele verifica o setor, o tamanho da empresa e a pontuação de engajamento em conjunto e inclui uma ramificação para registros incompletos. Isso substitui uma longa lista de variações de conteúdo dinâmico separadas por uma lógica que você escreve apenas uma vez.
Formatação e transformação de dados
A formatação é uma das vantagens mais práticas. Um script limpa valores incorretos à medida que o e-mail é gerado, antes que o destinatário o veja, eliminando a necessidade de limpar o banco de dados apenas para corrigir a aparência de um campo.
Considere um exemplo ilustrativo: números de telefone. Seu banco de dados pode conter (555) 123-4567 ao lado de 5551234567 e +44 20 7946 0958. Um script pode remover os caracteres não numéricos, contar os dígitos e exibir um número americano de dez dígitos como (555) 123-4567, mantendo os números internacionais com o código do país. Outros usos comuns incluem:
- Converter texto para maiúsculas e minúsculas para uma apresentação profissional
- Unindo campos de endereço com pontuação adequada.
- Cálculo de datas, como dias até a renovação.
Personalização de objetos personalizados
Os tokens padrão não conseguem ler registros de objetos personalizados do Marketo, como histórico de compras, inscrições em eventos ou casos de suporte. A Adobe documenta o uso de scripts de e-mail como forma de extrair esses dados para um e-mail. A personalização de objetos personalizados funciona percorrendo os registros de uma pessoa e criando conteúdo a partir das informações encontradas. Por padrão, um script visualiza os 10 registros atualizados mais recentemente por pessoa, numerados de 0 (do mais recente ao mais antigo) a 9 (do mais antigo).
Montagem de Conteúdo Dinâmico
Além de substituir um campo, um script pode criar blocos de conteúdo inteiros: uma grade de produtos, uma recomendação de evento ou um aviso legal específico para uma região, tudo dentro de um único modelo.

Quando usar scripts Velocity em vez de personalização nativa
Nem toda personalização exige um script. Os tokens padrão do Marketo e o conteúdo dinâmico atendem às necessidades mais simples e são mais fáceis de criar e manter.
Quando os recursos nativos funcionam bem
- Inserir um único valor de campo, como um nome ou empresa.
- Exibindo uma imagem diferente para um segmento.
- Escolhas simples do tipo "se/então" com dois resultados.
- Personalização que raramente muda
Para essas tarefas, os recursos nativos proporcionam uma configuração mais simples e uma manutenção mais fácil.
Quando a velocidade se torna necessária
Os scripts de velocidade do Marketo demonstram sua complexidade em cinco situações.
- Recomendações complexas: A receita, o plano atual, o cronograma de renovação e a utilização dos recursos devem ser avaliados em conjunto para sugerir um nível de produto.
- Conteúdo regional: Um script pode verificar campos de localização e consentimento e exibir ou ocultar conteúdo para seguir suas próprias regras regionais. Peça à sua equipe jurídica para confirmar essas regras, pois o script apenas as aplica.
- Qualidade dos dados: Formatos de telefone mistos, capitalização inconsistente e endereços parciais podem ser padronizados no momento da exibição. Preste atenção aos nomes dos seus campos, porque Como os campos de leads compartilhados prejudicam os e-mails Mostra o que acontece quando um campo é alterado durante um envio em tempo real.
- Dados de objetos personalizados: Quando compras, eventos ou casos de suporte estão armazenados em objetos personalizados, um script é o meio pelo qual esses dados chegam ao e-mail. Para muitas equipes B2B, esse caso específico justifica a curva de aprendizado.
- Programas de desenvolvimento com múltiplos atributos: Um programa de relacionamento que se adapta à pontuação de engajamento, ao conteúdo consumido e aos dados firmográficos precisa, em conjunto, da lógica condicional proporcionada por um roteiro.
Principais benefícios de usar scripts Velocity
Quando bem utilizados, os scripts de velocidade do Marketo permitem que uma equipe pequena faça mais com menos recursos.
- Menos versões de e-mail: Um único modelo com lógica sólida pode substituir versões separadas para cada linha de produto ou região, o que significa menos recursos para testar e atualizar.
- Dados mais claros na tela: A formatação em tempo de exibição oculta valores incorretos dos destinatários sem interromper as campanhas para limpeza.
- Menos coisas para acompanhar: Com menos modelos, há menos risco de enviar uma versão desatualizada.
- Conteúdo que leva em consideração o consentimento: Os scripts podem ler os campos de consentimento e mostrar ou ocultar o conteúdo de acordo com a sua relevância, de forma que o e-mail acompanhe as alterações no registro do lead.
Esteja ciente da contrapartida: cada script adiciona algo que sua equipe precisa testar e manter.
O que os scripts Velocity não conseguem fazer
Os scripts de velocidade do Marketo têm limites claros, e conhecê-los evita expectativas irreais.
- Não é possível atualizar os registros de leads: Um script cria o conteúdo do e-mail. Ele não grava dados de volta no seu banco de dados.
- Não é possível selecionar destinatários: As Listas Inteligentes decidem quem recebe um e-mail antes da execução de qualquer script. Os scripts alteram o que os destinatários veem, não quem eles são.
- Não é possível acionar fluxos de trabalho: Os scripts não podem iniciar uma Campanha Inteligente, alterar o status de um Programa ou acionar uma etapa de fluxo.
- Não foi possível calcular os segmentos: A Adobe documenta a criação de scripts apenas para conteúdo de e-mail; portanto, não espere que um script crie listas ou atualize dados durante o processamento da campanha.
- Não se pode presumir que sejam feitas chamadas a serviços externos: A Adobe descreve o acesso a dados de leads, contas, oportunidades e objetos personalizados, mas não descreve a chamada a serviços externos. Planeje como se um script não pudesse acessar serviços externos ao Marketo.
Importante: A velocidade aprimora a personalização em campanhas que já estão segmentadas. Ela não substitui a segmentação ou a lógica da campanha.
Como testar, revisar e documentar um script Velocity
Um script que funciona para um registro de lead completo pode falhar em um registro incompleto, e seus destinatários verão a falha. Trate os testes, a revisão e a documentação como parte do processo de desenvolvimento.
Comece com um caso de uso simples.
Não comece com o problema de personalização mais difícil. Os scripts de velocidade do Marketo são mais fáceis de testar em tarefas específicas, como formatação de números de telefone, e um sucesso inicial gera a confiança e o apoio interno necessários para scripts mais complexos posteriormente.
Criar registros de teste para casos extremos
Crie um conjunto permanente de leads de teste que seus scripts devem processar corretamente e reutilize-o em todas as campanhas. Inclua:
- Registros com valores vazios nos campos que seu script lê
- Registros internacionais com formatos e idiomas variados
- Registros mínimos contendo apenas os campos obrigatórios.
- Registros completos com todos os campos preenchidos
- Texto muito longo ou caracteres incomuns
- Cancelamentos recentes
Execute o comando "Enviar amostra" com cada lead selecionado, pois a Adobe observa que o comando "Enviar amostra" precisa de um lead existente escolhido para que o script funcione corretamente. Em seguida, verifique a "Visualização de e-mail", que exibe erros de script, e adicione essas verificações à sua lista de verificação de controle de qualidade da campanha antes do lançamento.
Planeje conteúdo alternativo para campos vazios
Nos scripts de e-mail do Marketo, uma referência indefinida como `$company` é impressa como texto literal, enquanto a forma silenciosa `$!company` não imprime nada. Nunca deixe um script produzir qualquer um desses resultados acidentalmente. Defina um valor padrão para cada ramificação, pois uma linha genérica como "Explore nossa linha de produtos" é melhor do que texto codificado ou um espaço em branco.
Os scripts de velocidade do Marketo expõem problemas nos dados em vez de os ocultarem; portanto, quanto mais desorganizados forem os seus campos, mais ramificações o script precisará. Corrija as lacunas recorrentes na origem sempre que possível.
Revisar antes do envio de qualquer produto.
Um olhar fresco percebe o que o autor deixou passar. Peça a uma segunda pessoa que revise cada roteiro usando esta lista:
- Sintaxe: Os parênteses e as diretivas coincidem.
- Lógica: Toda condição tem uma consequência.
- Alternativas: Existe um valor padrão para cada campo vazio.
- Desempenho: Nenhum laço de repetição executa mais trabalho do que o necessário.
- Consentimento: O roteiro respeita o seu consentimento e as regras de privacidade.
Essa revisão promove a responsabilidade e dissemina o conhecimento sobre roteiros por toda a equipe, à medida que os revisores aprendem uns com os outros.
Documente a lógica
Escreva uma nota em linguagem simples para cada script, separada do código: o objetivo de negócio, os campos que ele lê, o fluxo lógico, o comportamento de fallback, as limitações conhecidas e um histórico de alterações. Quando alguém renomear um campo, essa nota indicará quais scripts serão afetados. Mantenha uma pequena biblioteca de scripts de velocidade do Marketo testados para tarefas comuns, como formatação de números de telefone e verificação de região, e anote quais campanhas usam cada versão para que uma correção nunca interrompa um programa em produção de forma inesperada.
Monitore os limites e envie o desempenho
Scripts de velocidade do Marketo com loops complexos e buscas repetidas em objetos personalizados podem tornar o envio mais lento. Portanto, teste com volumes realistas e observe os tempos de conclusão do envio após o lançamento. Conheça também os limites. A Adobe afirma que todos os tokens de script em um e-mail podem totalizar 100,000 bytes, e o artigo de suporte da Adobe sobre tokens de velocidade informa que um e-mail falhará se seus scripts fizerem referência a mais de 40 campos personalizados. Links criados dentro de loops também não são rastreados por cliques.
Onde a IA ajuda na criação de scripts de velocidade no Marketo
A IA pode acelerar a criação de scripts de velocidade no Marketo, desde que haja uma pessoa responsável pelo resultado. Um assistente geral pode elaborar um script inicial, explicar um script existente em linguagem simples e sugerir registros de teste para casos extremos, conforme a lista acima. No entanto, a IA não tem conhecimento dos nomes dos seus campos, da configuração dos seus objetos personalizados ou de como sua instância se comporta quando um campo está vazio, e os scripts tendem a falhar silenciosamente exatamente nesse caso.
Forneça à IA amostras ou dados fictícios, nunca registros de leads reais, e execute os mesmos testes em sua saída. Trate cada rascunho da IA como um primeiro rascunho que uma pessoa edita e testa antes de ser enviado por e-mail. Para uma visão mais ampla, veja a produção de campanhas de IA no Eloqua e no Marketo e como a IA integrada do Marketo se compara.
Conclusão
Os scripts de velocidade do Marketo oferecem uma personalização que tokens e conteúdo dinâmico não conseguem alcançar: lógica multicampo, formatação clara e dados de objetos personalizados em um único modelo. Eles também trazem responsabilidade real, então comece com um caso de uso simples, teste-o com registros complexos e documente seu funcionamento. Para necessidades simples, use tokens padrão e, quando seus cenários exigirem mais, crie o script com cuidado. Usado com atenção, um único modelo pode substituir vários. Se você quiser uma segunda opinião sobre sua abordagem, entre em contato com a 4Thought Marketing.
Sobre a 4Thought Marketing
Somos uma consultoria de automação de marketing B2B e IA especializada em fazer com que tecnologias complexas funcionem de verdade. Desde 2008, ajudamos centenas de organizações dos setores financeiro, tecnológico, industrial e imobiliário a obterem o máximo do Eloqua, Marketo e suas integrações com CRM. Atendemos nossos clientes em estratégia de automação de marketing, ciclo de leads, IA, compliance, gestão de preferências e muito mais. Explore nossos serviços or entre em contato.
Perguntas Frequentes (FAQs)
O que são scripts de velocidade do Marketo?
Os scripts de velocidade do Marketo são blocos de código da linguagem de modelo Apache Velocity, construídos como tokens de script de e-mail, que geram conteúdo de e-mail personalizado a partir de dados de leads e objetos personalizados. Eles vão além dos tokens padrão, aplicando lógica a vários campos simultaneamente.
Preciso ter experiência em programação para usar scripts Velocity no Marketo?
Sim, em parte. A programação usa conceitos de desenvolvimento, como variáveis, condições e loops, então muitas equipes trabalham em conjunto com um desenvolvedor ou reservam um tempo considerável para aprendizado antes de criar scripts de produção. A sintaxe é acessível se você estiver familiarizado com lógica básica.
Os scripts Velocity podem extrair dados de objetos personalizados do Marketo?
Sim. Os tokens padrão não conseguem ler registros de objetos personalizados, e a Adobe documenta o uso de scripts de e-mail como forma de acessar dados como histórico de compras ou inscrições em eventos. Por padrão, um script visualiza os 10 registros atualizados mais recentemente por pessoa.
Qual a diferença entre scripts Velocity e tokens padrão?
Um token padrão insere o valor de um único campo. Um script avalia vários campos, realiza cálculos e aplica lógica condicional, o que o torna mais adequado para cenários complexos.
É possível usar scripts de velocidade para segmentar meu público no Marketo?
Não. As Listas Inteligentes selecionam o público-alvo. Os scripts apenas alteram o que cada destinatário vê no e-mail.
Como os scripts Velocity ajudam a resolver problemas de qualidade de dados?
Eles padronizam a forma como os valores são exibidos, como formatos de telefone, capitalização de nomes e datas, sem a necessidade de limpeza do banco de dados. Os dados armazenados permanecem inalterados, então basta continuar corrigindo a fonte ao longo do tempo.
Quando devo usar Velocity em vez de blocos de conteúdo dinâmico?
Use os scripts de velocidade do Marketo quando a personalização exigir vários campos simultaneamente, dados de objetos personalizados ou transformação de dados. Os blocos de conteúdo dinâmico são suficientes quando um único segmento decide a troca.
Como faço para testar um script Velocity antes de enviá-lo?
Crie um conjunto permanente de leads de teste para casos extremos, execute o comando "Enviar amostra" com cada lead selecionado e verifique a pré-visualização do e-mail em busca de erros no script. Adicione uma alternativa para cada campo vazio e peça a uma segunda pessoa para revisar o script. Qualquer script elaborado com IA passa pelos mesmos passos.

