Adicionar conteúdo dinâmico com Handlebars em campanhas de marketing

As campanhas de marketing permitem que você insira tags de substituição em seu conteúdo de e-mail ou assunto. As tags inseridas preencherão dinamicamente os dados do campo personalizado para esse campo para cada destinatário.

Você pode ir além da simples substituição de campo personalizada, usando o conteúdo dinâmico e Handlebars para atender às suas metas.

Para entender como adicionar tags aos seus projetos de campanhas de marketing, consulte nossa Documentação do Editor. A documentação do Editor também explica como visualizar sua mensagem com dados de exemplo.

Esta página fornece vários exemplos de casos de uso para mostrar como modificar o conteúdo dinâmico em seus designs com Handlebars. Para obter uma referência completa de todos os assistentes disponíveis, consulte Como utilizar Handlebars. Primeiro, descreveremos como lidar com valores padrão ao usar o Handlebars em campanhas de marketing.

Entendendo os valores padrão e Handlebars

Quando você copia uma tag da aba Tags nos editores de campanhas de marketing, colar a tag no seu design adicionará um "padrão" automaticamente. A tag terá a aparência do exemplo a seguir: nome da tag seguido por um caractere de barra vertical e a palavra "default." que você pode pensar na barra como a palavra "or." isso significa que a tag será first_name do seu destinatário ou a palavra "default."

{{ first_name | default }}

O padrão é fornecer um valor de fallback para a tag no caso de ela não poder ser preenchida com dados reais. Por exemplo, se você substituir a palavra "padrão" por "Prezado cliente", sua mensagem será entregue com first_name do destinatário ou a frase "Prezado cliente" quando os dados do first_name não estiverem disponíveis. Geralmente, isso é preferível a uma tag com falha, que não exibirá texto.

{{first_name | Valued Customer}}

Alterações de sintaxe para tags salvas

Os valores padrão são compatíveis somente com insert a palavra-chave. Quando você salvar seu design, a sintaxe da tag será alterada para se tornar compatível com a palavra-chave insert automaticamente. Se você ver a mudança de sintaxe, não se preocupe.

A tag quando colada

{{first_name | Valued Customer}}

A tag quando salva

{{insert first_name 'default=Valued Customer'}}

Padrões sem a palavra-chave insert

A palavra-chave insert e os valores padrão não podem ser adicionados a uma tag ao usar outro assistente de Handlebars para obter uma funcionalidade mais complexa. Por exemplo, você não pode formatar uma data com o assistente formatDate e fornecer um fallback ou um valor padrão para essa data formatada em uma única tag. O exemplo a seguir dará errado.

Exemplo errado

{{insert formatDate due_date "MM/DD/YYYY" 'default=30 days after signup'}}

Porque as tags copiadas da aba Tags são coladas automaticamente com um espaço reservado padrão, você deve excluir a parte | default da tag ao usar outros assistentes de Handlebars. Se o seu assistente não estiver funcionando como esperado, certifique-se de que a tag não foi salva com insert e 'default=default' dentro.

Para obter o comportamento de fallback ao usar outros assistentes, você pode usar instruções condicionais. Por exemplo, para criar um fallback para formatDate, você pode envolver a tag {{#if}} {{else}} como mostrado no exemplo a seguir.

Exemplo funcional

{{#if due_date}}
{{formatDate due_date "MM/DD/YYYY"}}
{{else}}
30 dias após a inscrição
{{/if}}

Para obter mais informações sobre instruções condicionais, consulte nossa página de Handlebars.

Use o assistente do formatDate

Twilio SendGrid armazena datas em formato de data ISO 8601. Este formato de data padrão ajuda a garantir que lidamos com as datas e horas corretamente. No entanto, o formato de data ISO 8601 não é o que os destinatários normalmente esperam no texto de um e-mail. Por esse motivo, fornecemos o assistente do formatDate para converter datas de ISO 8601 para um formato de data mais amigável, como MM/DD/AAAA.

Nas campanhas de marketing, você pode usar esse assistente para alterar a forma como uma tag de data é exibida na linha de assunto ou no conteúdo do e-mail. Para contexto, as opções de tag que você vê no editor de campanhas de marketing são criadas automaticamente com base em seus campos personalizados.

O exemplo a seguir presume que você tenha uma tag de data personalizada chamada offer_expiration. Você pode usar essa tag de data para exibir o final de uma promoção, solicitando que os clientes tomem medidas antes disso.

No editor de campanhas de marketing, sua cópia de e-mail tem a seguinte aparência (após remover o valor padrão do campo de data):

Estamos comemorando o aniversário do Cake or Pie{{ first_name | to you }}!

É difícil de acreditar, mas você assinou o serviço Cake or Pie Delicious Delivery há um ano. Agradecemos clientes leais como você, e é por isso que estamos enviando a você uma pequena oferta de presente de aniversário.

Você receberá 15% de desconto em todos os pedidos feitos durante o mês de aniversário. Isso é 15% de desconto em todos os pedidos feitos antes de {{ offer_expiration }}!

Obrigado por ser nosso cliente,

Equipe Cake or Pie

Como está, esta cópia de e-mail exibirá o offer_expiration no formato ISO 8601 (por exemplo, 2020-05-08T17:06:24Z). Para alterar a forma como isso é exibido, você usará o assistente formatDate.

Dentro do Handlebars, {{ }}, adicione o nome do assistente, formatDate, antes do nome da sua tag. Isso informa ao Twilio SendGrid que você deseja formatar a data da offer_expiration tag. Mantenha um espaço antes e depois do formatDate.

{{ formatDate offer_expiration }}

Em seguida, coloque o formato que deseja exibir no e-mail seguindo o nome da tag. A formatação deve ser colocada entre aspas. Mantenha um espaço antes e depois das aspas.

{{ formatDate offer_expiration "MM/DD/YYYY" }}

Para alterar o formato exibido para qualquer tag de data, você sempre seguirá este padrão:

{{ formatDate <date tag> "<desired format>" }}.

Para ver quais tokens de formato (por exemplo, AAAA, dddd, MM) estão disponíveis para exibir diferentes formatos de data, consulte a referência completa para o assistente formatDate em nossa documentação de Handlebars.

Verificações condicionais baseadas nos atributos do cliente

O Handlebars possibilitam alterar o conteúdo de uma mensagem com base nos atributos do cliente que podem não se emprestar a um segmento. Por exemplo, você pode querer entregar mensagens diferentes com base no CEP ou idiomas dos clientes.

Verificação condicional com igual

Neste exemplo, você verá como alterar condicionalmente uma mensagem com base na proximidade de um destinatário a uma loja, permitindo que você ofereça as vendas mais relevantes para ele.

Para isso, você pode manter um campo personalizado chamado nearest_zip_code que contenha a loja mais próxima de cada cliente. Você terá automaticamente esse campo personalizado disponível na aba de tags nos editores de campanhas de marketing.

Para alterar sua mensagem usando essa tag, o código do Handlebars pode parecer com o exemplo a seguir.

{{#equals nearest_zip_code 1234}}
20% de desconto em todos os livros!
{{else}}
Economia incrível!
{{/equals}}

Este exemplo usa o assistente equals para verificar o valor do nearest_zip_code para cada destinatário. Se o CEP mais próximo do destinatário for igual a 1234, ele verá "20% de desconto em todos os livros de bolso". Se eles estiverem em qualquer outro lugar, eles verão "descontos incríveis!"

Esse tipo de condicional pode ser útil, mas você provavelmente desejará verificar mais de um CEP. Nesse caso, também é possível adicionar várias verificações iguais encadeadas em outras verificações. No final do bloco do Handlebars, certifique-se de adicionar a tag de fechamento, {{/equals}}, para cada tag de abertura, {{#equals}}. Para verificar se há três CEPs, o Handlebars pode parecer com o exemplo a seguir.

{{#equals nearest_zip_code 12345}}
20% de desconto em todos os livros!
{{else}}{{#equals nearest_zip_code 23456}}
10% de desconto em todos os livros de ficção
{{else}}{{#equals nearest_zip_code 34567}}
Economia incrível!
{{/equals}}{{/equals}}{{/equals}}

Observe as três tags {{/equals}}de fechamento, uma para cada {{#equals}} de verificação.

Certifique-se de testar usos mais complexos dos Handlebars antes de enviar uma mensagem para uma de suas listas. Nem todos os Handlebars complexos podem ser visualizados com precisão usando aba de Pré-visualização de tag em campanhas de marketing neste momento.

Você pode usar uma abordagem semelhante para verificar o idioma preferido de seus clientes e fornecer texto nesse idioma. O uso da tag equals permite armazenar um campo único personalizado de language e verificar seu valor conforme mostrado no exemplo a seguir.

{{#equals language "english"}}
Hello, World!
{{else}}{{#equals language "español"}}
¡Hola Mundo!
{{else}}{{#equals language "français"}}
Bonjour le monde!
{{/equals}}{{/equals}}{{/equals}}

Verificação condicional com greatThan (Maior que)

Você pode usar o assistente greatThan (Maior que) para exibir texto com base em verificações em campos de números. Por exemplo, você pode armazenar o número de compras que um cliente faz em um campo personalizado chamado total_purchases. Você pode ter outro campo onde você armazena a meta de compra atual para seus clientes chamado purchase_goal. Se você quiser enviar uma mensagem para recompensar aqueles que excederam o seu purchase_goal ou incentivar o envolvimento de quem não o tinha, o Handlebars pode parecer com o exemplo a seguir.

{{#greaterThan total_purchases purchase_goal}}
Obrigado por ser um cliente fiel. Para mostrar nosso agradecimento, aproveite um desconto adicional de 15% em sua próxima compra.
{{else}}
Agradecemos novos clientes como você. É por isso que estamos oferecendo 10% de desconto em sua próxima compra.
{{/greaterThan}}

Para os destinatários cujo total_purchases forem maiores do que o purchase_goal, a mensagem será exibida: “Obrigado por ser um cliente fiel. Para mostrar nosso agradecimento, aproveite um desconto adicional de 15% em sua próxima compra.” Para aqueles que total_purchases forem iguais ou inferiores ao seu purchase_goal, a mensagem será exibida: “Agradecemos novos clientes como você. É por isso que estamos oferecendo 10% de desconto em sua próxima compra.”

Você poderia usar uma estratégia similar com o assistente lessThan (Menor que).

Recursos adicionais

Precisa de ajuda?

Às vezes, todos nós precisamos. Receba ajuda agora da equipe de suporte do Twilio SendGrid.

Enfrentando dificuldades de codificação? Confie na sabedoria da multidão navegando pela tag SendGrid em Stack Overflow ou visite o Stack Overflow Collective da Twilio.

Precisa de ajuda?

Obrigado pelo seu feedback!

Obrigado pelo seu feedback!