Tags de mesclagem

As tags de mesclagem inserem os dados de cada destinatário em uma campanha: o nome dele no assunto, um campo personalizado no corpo e o link de descadastro pessoal dele. Esta página lista todas as tags, as regras de sintaxe e como pré-visualizar o resultado.

Tags disponíveis

As tags de mesclagem funcionam no Subject da campanha, no conteúdo HTML e na versão em texto simples. Elas não são substituídas em From name, From email nem Reply to.

<p>Hi {{first_name}},</p>
<p>Your {{cf.plan}} plan now includes scheduled sending.</p>
<p><a href="{{unsubscribe_url}}">Unsubscribe</a> from Acme emails sent to {{email}}.</p>

Inserir tags nos editores

• Editor de texto formatado: digite @ e escolha uma variável, ou um campo personalizado pelo nome.
• Editor Dragit: use o menu de campos de mesclagem, que lista First name, Last name, Email e os seus campos personalizados. O link de descadastro fica entre os links especiais.
• Editor HTML e campo Subject: digite a tag.

Regras de sintaxe

• Sem espaços dentro das chaves. Escreva {{first_name}}. Uma tag com espaços, como {{ first_name }}, não é substituída e aparece no e-mail como foi digitada. Isso importa principalmente para o link de descadastro: a verificação da etapa Send aceita {{ unsubscribe_url }}, mas só {{unsubscribe_url}} vira um link que funciona.
• Os nomes das tags não diferenciam maiúsculas de minúsculas, então {{First_Name}} também funciona. As chaves dos campos personalizados devem ser exatamente iguais à chave armazenada, e as chaves são sempre em minúsculas, então escreva {{cf.company}}, e não {{cf.Company}}.
• Os campos personalizados precisam do prefixo cf.. {{company}} não é uma tag de mesclagem e aparece como foi digitada.
• Qualquer outra coisa entre chaves duplas fica como foi digitada. O Emailit só substitui as tags da tabela acima.

Valores ausentes

Quando um contato não tem valor para uma tag, a tag é substituída por nada. Não há sintaxe de valor alternativo nas campanhas: {{first_name|"there"}} não é suportado e aparece como foi digitado.

Então, ou escreva um texto que continue fazendo sentido sem o valor, ou garanta que todos tenham um. Na lista de contatos, filtre por First name com is empty para encontrar os contatos sem nome.

Como os valores são renderizados

Os valores são inseridos exatamente como estão armazenados, sem escape de HTML. Se as pessoas podem digitar o próprio nome, por exemplo em um formulário de inscrição público, confira esses valores antes de usá-los em HTML.

Pré-visualizar as tags de mesclagem

• Preview as contact, na etapa Preview and test, renderiza o assunto e o conteúdo com os dados de um contato real. Use-o para conferir nomes, campos personalizados e valores vazios.
• Os envios de teste preenchem {{email}} com o endereço de teste e deixam vazios os nomes e os campos personalizados. O link de descadastro de um teste não descadastra ninguém.

Consulte Testar e agendar.

Tags de mesclagem e Temple

As campanhas usam as suas próprias tags de mesclagem. Os templates enviados pela API de e-mail e os e-mails enviados por automações usam o Temple, a linguagem de templates do Emailit, que parece semelhante, mas funciona de outro jeito:

No Temple, o valor alternativo vem depois de uma barra vertical, por exemplo {{first_name|"there"}}. Se você salvar uma campanha como template e enviá-la pela API, o Temple preenche as tags dela com as variables que você passar. Passe first_name para {{first_name}}, um objeto cf para {{cf.company}} e o seu próprio unsubscribe_url, se o conteúdo tiver um link para ele. Nas automações, os campos personalizados do contato ficam disponíveis como {{custom_fields.<key>}}, e não como {{cf.<key>}}.

Veja também