Referência sobre a personalização de mensagens

O que você vai aprender

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

As tags de personalização podem ser usadas em e-mails (incluindo o campo de assunto), mensagens SMS/MMS e notificações push. Este artigo descreve algumas tags, suas estruturas e formas, e como personalizá-las. Para mais informações, consulte o artigo sobre como adicionar personalizações às suas mensagens. 

Sobre as tags de personalização

As tags inseridas no campo de texto de uma mensagem 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 do evento, e aparecem como a frase à direita.

A personalização do perfil geralmente começa com person, exceto em 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 Klaviyo nas suas mensagens. A lista abaixo abrange toda a personalização de perfil (propriedades incorporadas da Klaviyo). As tags de personalização de perfil selecionadas estão disponíveis no menu Personalização do editor de e-mail ou na 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 nas suas mensagens. Você pode gerenciar essas informações em 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 preferências de inscrição e visualizem mensagens no navegador. Isso inclui: 

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

Essas tags só são compatíveis 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 Klaviyo exige um link de cancelamento de inscrição em todos os e-mails. Use uma tag simples dizendo "Cancelar inscrição" ou adicione seu próprio texto entre aspas. 

Você também pode usar a tag {% unsubscribe_link %} para gerar um URL de cancelamento de inscrição. Em vez de um link com uma palavra ou frase, essa tag cria apenas o URL de cancelamento de inscrição. Use-a se quiser exibir o link em uma cor diferente da definida nos estilos do modelo ou se quiser usar um botão/imagem em vez de um link de texto. 

Ao clicar no link de cancelamento de inscrição, o destinatário é direcionado a uma página de confirmação personalizável.

Gerenciar preferências

As páginas de preferências permitem que os usuários atualizem suas preferências e que você segmente mensagens de forma mais eficaz. Para incluir um link para essa página, use a tag "gerenciar preferências".

Você pode criar páginas de gerenciamento gerais e específicas para listas. As páginas específicas são usadas quando você envia uma mensagem para apenas uma lista. A página de gerenciamento geral de preferências é usada quando você envia para um segmento, uma combinação de listas ou 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 em 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 um link com uma palavra ou frase, essa tag cria apenas o URL da página de preferência do destinatário. Use-a se quiser exibir o link em uma cor diferente da definida nos estilos do modelo ou se quiser usar um botão/imagem em vez de um link de texto. 

Visualizar na web

Para que os destinatários possam visualizar um e-mail em um navegador, use a tag de visualização na web. 

Visualização do texto

Em alguns casos, pode ser útil exibir o texto de visualização no 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 atualizar o texto na tela de visualização do e-mail, essa tag exibirá o texto atualizado.

Tags de personalização e de eventos

As tags personalizadas referem-se a propriedades de perfil personalizadas, ou seja, dados que não sejam propriedades e eventos especiais da Klaviyo (por exemplo, aniversário ou preferências de contato). As tags de evento referem-se a dados de um evento específico (por exemplo, pedido realizado) 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 dos dados de visualização. Como alternativa, use os formatos abaixo para adicionar manualmente tags personalizadas aos seus modelos. 

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

Personalização de tags com filtros

Para personalizar a exibição das suas tags, aplique filtros de modelo. Eles podem ser usados para aplicar iniciais em letras maiúsculas, definir 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 não tiver essa propriedade definida. No exemplo abaixo, "friend" (amigo) e "tasty treats" (quitutes) são definidos como valores padrão, caso o nome ou a comida favorita do destinatário não esteja definido no perfil da Klaviyo. 

O filtro title permite que você aplique iniciais maiúsculas a qualquer tag de texto para garantir consistência. Por exemplo, alguns assinantes podem usar todas as letras maiúsculas ou minúsculas ao preencher o formulário de inscrição. Sem um filtro, o nome da pessoa apareceria como digitado originalmente. O filtro de título corrige isso 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 esse tipo de informação 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 registra a data e a hora de envio da mensagem. Para usar a tag "today", cole a seguinte linha de código no seu modelo: 

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

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 o artigo sobre tags de data em modelos. 

Tags de moeda 

Dados de eventos, como "Pedido Realizado" ou "Adicionado ao Carrinho", costumam ter um valor financeiro associado (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 local a esse valor.

Por exemplo, considere o campo $value na métrica Checkout Iniciado abaixo: 

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

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 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 em suas mensagens de duas maneiras: 

• 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. 

Como resolver problemas na tag currency_format

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

Declarações condicionais

Com as tags condicionais, você pode incluir conteúdos somente para destinatários que atendam a determinados critérios. É uma ótima maneira de 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 pontos, mas mais do que 0, ela verá a segunda linha. 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ó faltam 150 para se tornar VIP! 
{% else %}
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", é preciso incluir uma condição inicial {% if … %} e uma tag de fechamento {% endif %}. Os outros elementos (tags {% elif %} e {% else %} ) são opcionais. Você pode usar uma quantidade ilimitada de tags {% elif %}, seguidas de no máximo uma tag {% else %}. Cada destinatário verá apenas a primeira mensagem com a qual se qualificar. 

Declarações "For"

Os blocos “For” permitem iterar sobre cada elemento de uma variável que armazena uma lista e renderizá-los 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 subsequente) pelo alias da linha. Por exemplo, a variável {{ event.shopping_cart_items.0.name }} se torna {{ item.name }}. 

Declarações condicionais e editor de texto integrado

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

As seguintes tags só ficam visíveis 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
• Como resolver mensagens de erro em modelos de e-mail