Referência sobre a personalização de mensagens
Saiba como usar as tags do modelo da Klaviyo para personalizar a experiência dos seus clientes.
As tags de personalização podem ser usadas em e-mails (incluindo o campo de assunto), mensagens SMS/MMS, notificações push e no Customer Hub. 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.
Antigamente, as tags de personalização eram chamadas de tags do modelo e sintaxe variável.
Sobre as tags de personalização
As tags inseridas no campo de texto são semelhantes à frase à esquerda na tabela abaixo. Depois que a mensagem é exibida, as tags são substituídas por informações do perfil do destinatário ou do evento, e aparecem como a frase à direita.
Oi, | Oi, George Washington, sua cor favorita é verde |
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.
Todas as tags de personalização diferenciam maiúsculas de minúsculas e devem corresponder exatamente aos nomes das propriedades a que se referem. Certifique-se de que suas tags sejam digitadas corretamente e usem maiúsculas/minúsculas exatamente como aparecem nos perfis.
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.
Tag | Propriedade do perfil |
| E-mail |
| Nome |
| Sobrenome |
| Organização do destinatário |
| Endereço 1 |
| ID única ($id/external ID) |
| Latitude |
| Longitude |
| ID da Klaviyo |
| Nome completo |
| Cargo |
| Telefone |
| Endereço 2 |
| Cidade |
| Estado/Região |
| País |
| CEP |
| Fonte |
| Consentimento |
| $consent_form_id |
| $consent_form_version |
| $consent_method |
| Recipient timezone |
| $consent_timestamp |
| $phone_number_region |
| Itens visualizados recentemente |
| Data prevista do próximo pedido |
Tags de objeto personalizado
As tags de objeto personalizado permitem que você use dados de objeto em envios de fluxo e de campanha.
Consulte as referências de tag para ver exemplos específicos de como usar a tag para obter uma ID de objeto ou retornar uma contagem.
Antes de usar dados de objetos personalizados no modelo, você precisa criar um objeto. A tag {{ object }} só está disponível quando um objeto dispara um fluxo.
Tag | Resultado |
| Apresenta o objeto que acionou um fluxo |
| |
| Apresenta um único objeto de um filtro de objetos |
| |
| Apresenta uma contagem de um filtro de objeto |
| Recuperar um objeto por ID |
| Recuperar todos os registros de um objeto de um perfil |
Tags de organização
As tags de organização permitem que você inclua informações sobre sua empresa ou organização nas suas mensagens. É possível gerenciar essas informações clicando no nome da sua organização no canto inferior esquerdo e, em seguida, selecionando Configurações > Organização > Informações de contato. Todas as tags de organização começam com organization. Consulte a tabela abaixo para ver a lista de tags de organização.
Tag de organização | Descrição |
| Nome da organização |
| Site da organização |
| Endereço completo da organização, incluindo cidade, estado/região e CEP |
| Endereço da organização |
| Continuação do endereço da organização (por exemplo, número do apartamento ou da unidade) |
| Cidade da organização |
| Estado, município ou região da organização |
| CEP da 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
- Prévia do texto
Essas tags só são compatíveis com modelos de e-mail. 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.
Tag | Resultado |
| Cancelar inscrição |
Se não quiser mais receber e-mails, | Se não quiser mais receber e-mails, clique aqui. |
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.
Tag | Resultado |
| Este é um link sofisticado de cancelamento de inscrição. |
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.
Tag | Resultado |
| Gerenciar preferências |
Deseja atualizar suas preferências? | Deseja atualizar suas preferências? Clique aqui. |
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.
Tag | Resultado |
| Este é um link sofisticado para gerenciar preferências. |
Visualizar na web
Para que os destinatários possam visualizar um e-mail em um navegador, use a tag de visualização na web.
Tag | Resultado |
| Exibir no seu navegador |
Não consegue ver este e-mail? | Não consegue ver este e-mail? Abra o e-mail no seu navegador. |
| Este é um link sofisticado de visualização na web. |
Prévia 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.
Formato da tag | Descrição | Exemplo |
| Tag simples de personalização de perfil |
|
| Tag de personalização de perfil, se o nome da propriedade tiver espaços ou caracteres especiais |
|
| Tag simples de variável de evento |
|
| Tag de variável de evento, se o nome da variável tiver espaços ou caracteres especiais |
|
| Tag de variável de evento, se a variável estiver aninhada nos dados do evento |
|
| Tag de variável de evento, se a variável estiver aninhada em outra variável com um nome que contenha um espaço ou caractere especial |
|
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.
Com propriedades aninhadas, se um nome de propriedade usar a notação de pesquisa, todas as propriedades posteriores também deverão usar a notação de pesquisa. Ou seja: event|lookup:'Collection Names'|lookup:'0' está correto, mas event|lookup:'Collection Names'.0 não está.
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.
Texto com tags de personalização | Resultado |
Olá, | Olá, amigo, você tem interesse em alguns quitutes? |
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 registro. 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.
Texto com tags de personalização | Resultado |
Olá, | Olá, Elisa, já viu nosso último lançamento? |
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 é renderizado 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ção > Idioma da organização e formato regional e selecione o 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:
| Manta de praia grande × 1 Cadeiras de praia × 4 Protetor solar com FPS × 2 Cooler de plástico × 1 |
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. Para incluir variáveis aninhadas na coleção de linhas, substitua o início do nome da variável (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
Conheça os conceitos básicos de campanhas de e-mail e aprenda a enviá-las na Klaviyo.
- Como usar o painel de visualização para personalização de mensagens
Saiba como usar o painel de visualização para entender os dados de personalização disponíveis para suas mensagens e como acessar a tag do modelo. Use o modal de visualização como sua fonte de verdade para as opções de personalização.
- Como criar blocos dinâmicos em um e-mail de fluxo
Saiba como usar blocos de tabelas dinâmicas para adicionar informações sobre produtos e outros eventos aos seus fluxos acionados por métricas. Neste artigo, o senhor aprenderá a criar um bloco dinâmico usando o exemplo de um lembrete de carrinho abandonado que mostra os produtos que foram deixados para trás.
- Solução de problemas com mensagens de erro de modelos de e-mail
Se o senhor encontrar erros ou avisos em um modelo de e-mail, talvez seja necessário resolvê-los antes de enviar a mensagem. Pesquise neste recurso a mensagem de erro ou aviso que o senhor está encontrando para encontrar dicas para resolver o problema.
- Como criar um bloco de conteúdo para o Klaviyo Customer Hub
Saiba como criar um bloco de conteúdo para seu Klaviyo Customer Hub. Os blocos de conteúdo são blocos altamente personalizáveis e customizáveis que têm acesso a Klaviyo dados do perfil que permitem que o senhor exiba integrações (por exemplo, o O senhor pode usar o saldo de pontos de fidelidade), ofertas personalizadas e muito mais.