Referência de personalização de mensagens

O que você vai aprender

Saiba como usar as variáveis ou tags de personalização da plataforma Klaviyo em suas mensagens de marketing para proporcionar uma experiência personalizada aos seus assinantes.

As tags de personalização podem ser usadas em e-mails (incluindo a linha de assunto do e-mail), mensagens SMS/MMS e notificações por push. Este artigo descreve algumas tags disponíveis, suas estruturas e formas, e explica como personalizá-las. Para saber como adicionar personalizações, consulte nosso artigo sobre como adicionar personalizações às suas mensagens. 

Sobre as tags de personalização

Quando você insere tags em um campo de texto de uma mensagem, elas são semelhantes à frase à esquerda na tabela abaixo. Depois que você envia a mensagem, as tags são substituídas por informações do perfil do destinatário ou dos detalhes do evento, e terão a aparência da frase à direita.

A personalização do perfil geralmente começa com person, com exceção de algumas tags especiais, como first_name e last_name. As variáveis de evento, que podem ser usadas em fluxos disparados por métricas, começam com event. As tags de organização (como o nome e o endereço da sua empresa) começam com organization. 

Personalização do perfil

A personalização do perfil permite que você exiba propriedades especiais da plataforma Klaviyo nas suas mensagens. A lista abaixo abrange toda a personalização de perfil (por exemplo, propriedades incorporadas da plataforma Klaviyo). As tags de personalização de perfil selecionadas estão disponíveis no menu Personalização do editor de e-mail ou no modal de visualização de mensagens SMS e push. 

Se quiser adicionar propriedades personalizadas às suas mensagens, pule para a seção sobre personalização. 

Tags de organização

As tags de organização permitem que você inclua informações sobre sua empresa ou organização em suas mensagens. Você pode gerenciar essas informações navegando até Conta > Informações de contato > Organização. Todas as tags de organização começam com organization. Consulte a tabela abaixo para ver a lista de tags de organização.

Tags de link e visualização

As tags de link e visualização permitem que os destinatários gerenciem suas preferências de assinatura e visualizem sua mensagem no navegador. Isso inclui: 

• Cancelar inscrição
• Gerenciar preferências
• Visualização na Web
• Visualizar texto 

Essas tags são compatíveis apenas com modelos de e-mail, não com SMS/MMS. Os links em um e-mail de visualização direcionam para uma página provisória, em vez de uma página de consentimento ativa ou de visualização. 

Cancelar inscrição

A plataforma Klaviyo exige um link para cancelamento de inscrição em todos os e-mails. Use uma tag simples de cancelamento de inscrição para um link que diga "Cancelar inscrição" ou adicione seu próprio texto entre aspas. 

Como alternativa, você pode usar a tag {% unsubscribe_link %} para gerar uma URL de cancelamento de assinatura. Em vez de gerar uma palavra ou frase vinculada completa, essa tag cria apenas a URL de cancelamento de inscrição. Use essa tag se quiser usar uma cor diferente para o link de cancelamento de inscrição em relação à cor do link definida nos estilos do modelo ou usar um botão ou imagem vinculada em vez de um link de texto. 

Quando um destinatário clica no link para cancelamento de inscrição, ele é direcionado a uma página de confirmação personalizável.

Gerenciar preferências

As páginas de preferências permitem que os destinatários atualizem suas preferências, permitindo que você segmente e direcione suas mensagens de forma mais eficaz. Para incluir um link para essa página para cada destinatário, use a tag Gerenciar preferências.

Você pode criar páginas de preferências de gerenciamento gerais e específicas da lista. As páginas específicas da lista são enviadas quando você envia uma mensagem para apenas uma lista. A página de gerenciamento geral de preferências é usada quando o usuário envia para um segmento uma combinação de listas e em fluxos que não são disparados por listas. Saiba mais sobre as páginas de gerenciamento de preferências. 

Use uma tag simples de gerenciamento de preferências para um link que diga "Gerenciar preferências" ou adicione seu próprio texto entre aspas. 

Como alternativa, você pode usar a tag {% manage_preferences_link %} para gerar um URL de gerenciamento de preferências. Em vez de gerar uma palavra ou frase completa com um link, essa tag cria apenas o URL da página de preferência do destinatário. Use essa tag se quiser usar para o seu link uma cor diferente da cor do link definida nos estilos do seu modelo ou usar um botão ou imagem com link em vez de um link de texto. 

Visualização na Web

Para dar aos destinatários a opção de visualizar um e-mail em seu navegador da Web, você pode usar a tag de visualização na Web. 

Visualizar texto

Em alguns casos, você pode querer exibir o texto de visualização dentro do corpo do modelo. Você pode fazer referência a qualquer texto de visualização definido na tela de visualização/configuração do e-mail usando a tag {% render_variable preview_text %}.

Se você atualizar o texto de visualização na tela de visualização do e-mail, essa tag exibirá o texto de visualização atualizado.

Personalização e tags de eventos

As tags personalizadas fazem referência a propriedades de perfil personalizadas (ou seja, todos os dados que você coletar sobre seus contatos que não sejam propriedades e eventos especiais da plataforma Klaviyo), como o aniversário da pessoa ou as preferências de contato. As tags de evento fazem referência aos dados de um evento específico (por exemplo, um evento de pedido feito) e só podem ser usadas em fluxos disparados por esse evento. 

Para adicionar uma tag personalizada, clique em Personalização em um campo de texto de e-mail e localize a tag. Para adicionar uma tag de evento, visualize sua mensagem e copie a tag da variável de evento dos dados de visualização. Como alternativa, use os formatos descritos abaixo para adicionar manualmente tags personalizadas aos seus modelos. 

Use a notação de ponto (.) para tags sem espaços ou caracteres especiais. Se os nomes das propriedades contiverem espaços ou caracteres especiais (por exemplo, $), use a notação de pesquisa. 

Personalização de tags com filtros

Para personalizar a forma como suas tags aparecem, aplique filtros de modelo. Os filtros podem ser usados para aplicar letras maiúsculas e minúsculas, definir o número de casas decimais de um número e muito mais. Dois dos filtros mais comuns são default e title. 

O filtro default define um valor padrão a ser exibido se o destinatário da mensagem não tiver essa propriedade definida. No exemplo abaixo, "friend" e "tasty treats" são definidos como valores padrão, caso o nome ou a comida favorita do destinatário não esteja definido em seu perfil da plataforma Klaviyo. 

O filtro title permite que você aplique letras maiúsculas e minúsculas a qualquer tag de texto, para garantir que ela apareça de forma consistente quando a mensagem for enviada. Por exemplo, alguns assinantes podem usar todas as letras maiúsculas ou minúsculas ao preencherem o formulário de inscrição. Sem um filtro, o nome da pessoa usaria o formato usado inicialmente ao preencher o formulário. No entanto, o filtro de título corrige o formato para que o nome seja exibido corretamente. 

Há dezenas de outros filtros disponíveis para suas mensagens. Saiba mais sobre como usar filtros para personalizar tags. 

Tags de data 

As tags de data são uma maneira rápida de inserir informações de data em um e-mail. A data está no fuso horário da sua conta e reflete o dia ou a hora em que a mensagem foi enviada. 

A tag {{ today }} é uma das tags de data mais comuns e preenche um registro de data e hora quando a mensagem é enviada. Para usar a tag today, cole a seguinte linha de código no seu modelo: 

{% today "%Y-%m-%d" as today %} {{ today }}

Observe que, se você usar a tag {{ today }} sem o código anterior, nada será renderizado. É necessário usar a linha completa de código. 

Para saber como usar ou personalizar as tags de data, consulte nosso artigo sobre tags de data em modelos. 

Tags de moeda 

Os dados de eventos como "Placed order", "Added to cart" e outros geralmente têm um valor financeiro associado a eles (por exemplo, o preço de um produto ou o valor do carrinho de um cliente). Use a tag {% currency_format … %} para aplicar a formatação da moeda de seu país a esse valor.

Por exemplo, considere o campo $value na métrica "Started checkout" abaixo: 

Usando apenas a variável {{ event|lookup:"$value" }}, esta propriedade será exibida com apenas uma casa decimal e sem símbolo de moeda no e-mail: 

No entanto, com a tag de formato de moeda, {% currency_format event|lookup:"$value" %}, o número é exibido com um símbolo de moeda e o número correto de casas decimais: 

Para usar a tag de formato de moeda, substitua o texto provisório em {% currency_format PLACEHOLDER %} pela sua variável.

Por exemplo, se sua variável fosse {{ event.item.price }}, a tag de formato de moeda completa seria {% currency_format event.item.price %}. Se sua tag incluir filtros (por exemplo, um valor padrão caso a propriedade esteja vazia), inclua-os também na tag: {% currency_format event.item.price|default:”0” %}. 

Como selecionar um país 

Você pode definir o formato da moeda para suas mensagens em 2 locais: 

• Para toda a sua conta
  Acesse Configurações > Organizações > Idioma e formato regional da organização e selecione Idioma da organização. 
• Para uma mensagem específica
  Selecione um formato de moeda diferente para uma única mensagem na aba Estilos do modelo, na seção Moeda. 

Solução de problemas da tag currency_format

Esta tag só é compatível com variáveis que sejam números (por exemplo, 10 e 24,56). As propriedades com o símbolo de moeda incluído (por exemplo, R$40, $76.30) são strings e a tag currency_format não pode alterá-las. 

Declarações condicionais

As tags condicionais permitem que você inclua conteúdos em suas mensagens para destinatários que atendam a determinados critérios e não o inclua para outros. Eles oferecem controles poderosos para personalizar suas mensagens para cada destinatário.

Declarações "If"

As declarações "If" permitem que você controle o conteúdo que alguém recebe com base em dados de perfil ou de eventos. 

No exemplo abaixo, uma pessoa verá a primeira linha de texto se tiver mais de 150 pontos de fidelidade. Se tiver menos de 150, mas mais de 0, ele verá a segunda linha. E, se não tiver pontos de fidelidade, verá a terceira mensagem. 

{% if person|lookup:'Loyalty Points' > 150 %}
Olá, VIP! Você tem frete e devoluções grátis
{% elif person|lookup:'Loyalty Points' > 0 %}
Você tem {{ person|lookup:'Loyalty Points' }} pontos. Só precisa de 150 para se tornar VIP! 
{% else %}
Você já ouviu falar do nosso programa VIP? Cadastre-se hoje mesmo no nosso site para começar a ganhar prêmios.
{% endif %}

Em uma instrução "If", é necessária uma condição inicial {% if … %} e uma tag de fechamento {% endif %}. Todos os outros elementos (ou seja, as tags {% elif %} e {% else %} ) são opcionais. Você pode usar um número ilimitado de tags {% elif %}, seguidas de no máximo uma tag {% else %}. Cada destinatário do e-mail verá apenas a primeira mensagem para a qual se qualificar. 

Declarações "For"

Os blocos "For" permitem que você itere sobre cada item em uma variável que esteja armazenando uma lista e os renderize individualmente. Veja abaixo um exemplo de declaração: 

Cada declaração For deve conter o seguinte: 

• Uma tag {% for … %} de abertura, contendo um alias de linha (item no exemplo acima) e uma coleção de linhas (event.shopping_cart_items no exemplo acima).
• Uma tag de fechamento {% endfor %}.

Entre as duas tags obrigatórias, você pode incluir qualquer texto que desejar. Para incluir variáveis aninhadas na coleção de linhas, substitua o início do nome da variável (a coleção de linhas mais o número após a coleção de linhas) pelo alias da linha. Por exemplo, a variável {{ event.shopping_cart_items.0.name }} se tornaria {{ item.name }}. 

Declarações condicionais e o editor de texto em linha

Quando você adiciona determinadas instruções condicionais a um bloco de texto, elas podem desaparecer do editor de texto em linha. O código ainda está presente, apenas oculto. Para visualizar e editar instruções condicionais, abra o campo Código-fonte do bloco de texto. 

As seguintes tags ficam visíveis apenas no campo Código-fonte de um bloco de texto: 

• {% for ... %}
• {% endfor %}
• {% if ... %}
• {% elif ... %}
• {% else %}
• {% endif %}
• {% with ... %}
• {% endwith %}

Recursos adicionais

• Como criar e enviar uma campanha de e-mail
• Como usar o painel de visualização para personalizar mensagens
• Como criar blocos dinâmicos em um e-mail de fluxo
• Solução de problemas com mensagens de erro de modelos de e-mail