Como mostrar ou ocultar blocos e seções do modelo com base em variáveis dinâmicas

O que você vai aprender

Saiba como mostrar um bloco ou uma seção específica em um e-mail para determinados destinatários usando a lógica de exibir/ocultar do editor de modelo e como mostrar diferentes versões do mesmo bloco ou seção para diferentes públicos usando variantes da lógica de exibir/ocultar.

Você pode usar isso para exibir conteúdo diferente para, por exemplo, pessoas em determinados níveis de fidelidade ou que compraram um produto específico. Com variantes de lógica, você cria a versão de um bloco ou seção para cada público em um só lugar, escolhe qual versão tem prioridade e adiciona uma alternativa para todos os outros. Esse recurso permite direcionar o conteúdo do seu e-mail com base em informações sobre seus assinantes, para que cada destinatário tenha uma experiência de marketing altamente personalizada.

Antes de começar

Tanto o criador de lógica quanto as condições de exibição/ocultação com código personalizado abaixo são usados em modelos de arrastar e soltar. Se você tiver um modelo HTML salvo, crie primeiro uma cópia de arrastar e soltar. Você precisa de permissão para editar modelos.

1. Acesse Conteúdo > modelos e selecione E-mail: salvos.
2. Abra o menu de três pontos do modelo HTML e selecione Clonar para arrastar e soltar.
3. Selecione Modelos convertidos. Quando o status for Pronto para usar, clique no nome do modelo convertido para abri-lo no editor de arrastar e soltar.

Seu modelo HTML original permanece inalterado. Revise o layout do texto e o conteúdo dinâmico antes de adicionar condições de mostrar/ocultar. Saiba mais sobre como converter um modelo HTML para arrastar e soltar.

Você pode mostrar/ocultar conteúdo com base em:

• Dados do perfil (ou seja, propriedades de perfil ou personalizadas)
• Acione dados de eventos em um fluxo acionado por evento (também chamado de fluxo acionado por métrica). Use o construtor de lógica para as propriedades disponíveis no menu suspenso ou código personalizado para outras condições.

Antes de criar seu e-mail, você precisa ter os dados necessários na sua conta. Em outras palavras, você precisa ter 1 evento ou perfil com a propriedade que quer usar.

Mostre um bloco ou uma seção para um público

1. Adicione um bloco ou uma seção a um modelo de e-mail.
2. Selecione o bloco ou a seção e, em seguida, selecione a guia Exibição.

3. Em Mostrar/ocultar lógica, selecione Mostrar somente para um público específico.

4. Em Tipo de condição, selecione Propriedades sobre alguém para dados de perfil. Em um e-mail de fluxo acionado por um evento, em vez disso, você pode selecionar Propriedades de seguido do nome do evento de acionamento, como Propriedades de Pedido feito. Escolha uma propriedade e, em seguida, escolha uma comparação. O menu de comparação também define o tipo de dados (texto, número ou lista). Insira um valor se a condição exigir um.

• Você pode criar uma condição simples com um único critério ou uma condição mais complexa com vários critérios conectados por AND ou OR. Saiba mais sobre conectores E versus OU.

5. Use o botão Adicionar condição para adicionar condições adicionais, se desejar.
6. Selecione Save.

Depois de salvar, o painel Lógica de exibir/ocultar mostra Editar lógica e Remover lógica. Para mostrar conteúdo diferente para outros públicos no mesmo lugar, selecione Personalizar para vários públicos e siga as etapas para mostrar conteúdo diferente para vários públicos.

Clique em Visualizar e confira perfis que atendem e não atendem às suas condições, incluindo perfis sem a propriedade. Para condições de evento, visualize diferentes ocorrências do evento de acionamento do fluxo, incluindo as que correspondem e as que não correspondem. Confirme se cada um mostra o conteúdo pretendido.

E vs. OU em condições de mostrar/ocultar

Ao avaliar a lógica de mostrar/ocultar, as condições conectadas por AND são avaliadas antes das condições conectadas por OR. Ao escrever sua lógica, considere a ordem em que ela será avaliada para garantir que seja interpretada como você pretende.

Como exemplo, considere a seguinte condição:

Com base nestes critérios, veja se o bloco fica visível para alguns destinatários de amostra:

Mostre conteúdos diferentes para vários públicos com variantes de lógica

Use variantes de lógica de mostrar/ocultar quando cada público deve ver sua própria versão do mesmo bloco ou seção, como um banner diferente para cada nível de fidelidade. Em vez de empilhar blocos separados, cada um com sua própria lógica de mostrar/ocultar, você cria todas as versões em um só lugar. Cada variante de lógica tem um nome, seu próprio conteúdo e sua própria condição de mostrar/ocultar.

Como funcionam as variantes de lógica

• As variantes de lógica são verificadas de cima para baixo. Cada destinatário vê apenas a primeira variante com a qual ele corresponde, mesmo que também corresponda a uma variante mais abaixo na lista.
• Os destinatários que não corresponderem a nenhuma variante verão o fallback. Se você não adicionar um fallback, eles não verão nada nesse espaço.
• Cada variante é uma cópia independente do bloco ou da seção. Alterar o conteúdo ou os estilos de uma variante não altera nenhuma outra variante.
• Você pode adicionar até 10 variantes de lógica a um bloco ou seção, além de 1 fallback.
• A condição de cada variante funciona como qualquer outra condição de mostrar/ocultar. Você pode criar isso com o criador de lógica ou escrever como código personalizado.

Criar variantes de lógica

1. Selecione o bloco ou a seção que você quer personalizar e, em seguida, selecione a guia Exibição.
2. Em Mostrar/ocultar lógica, selecione Personalizar para vários públicos. Se o bloco já tiver lógica de exibir/ocultar, essa opção aparecerá abaixo de Editar lógica e Remover lógica.
3. No painel Adicionar variante, insira um Nome da variante que descreva o público, como VIP. Os nomes são opcionais e podem ter até 50 caracteres. As variantes sem nome recebem um rótulo com base na posição, como Variante 1, e são renumeradas quando você as reordena.
4. Em Lógica, crie a condição para esse público. Para escrever a condição por conta própria, selecione Usar código.

5. Selecione Save. Se o bloco não tiver lógica de mostrar/ocultar, ele se tornará sua primeira variante. Se ele já tiver uma lógica de mostrar/ocultar, ela mantém essa lógica como a primeira variante, e uma cópia com sua nova condição é adicionada como a segunda variante.
6. Selecione Adicionar variante para criar uma versão para outro público. Insira um nome, crie a condição e selecione Salvar. A nova variante começa como uma cópia da variante que você selecionou e é adicionada ao final da lista.
7. Na tela, edite o conteúdo da nova variante. Por exemplo, troque a imagem ou altere o texto.
8. Repita as etapas 6 e 7 para cada público.
9. Opcional: selecione Adicionar fallback para mostrar conteúdo a todos que não corresponderem a uma variante. O fallback começa como uma cópia da sua última variante sem uma condição, então edite o conteúdo dele para um público geral. Ele é rotulado como Padrão e sempre fica na parte inferior da lista.

10. Clique em Prévia e verifique um perfil de cada público, além de um perfil que não corresponde a nenhuma variante. Confirme que cada um vê a versão pretendida.

Ver variantes de lógica na tela

Quando você seleciona um bloco ou uma seção com variantes de lógica, uma barra aparece abaixo da barra de ferramentas do editor. Selecione Todas para ver todas as variantes na tela ou selecione Uma e escolha uma variante no menu suspenso Variante para mostrar. Você também pode selecionar o cartão de uma variante na aba Exibição para selecioná-la na tela. Cada variante é identificada com o tipo e o nome do bloco, como VIP.

A tela mostra a variante que você escolher e não avalia condições. Para ver qual variante um destinatário específico vai receber, use Prévia com o perfil desse destinatário.

Gerenciar variantes de lógica

Gerencie suas variantes no painel Mostrar/ocultar lógica na guia Exibição:

• Alterar prioridade: Arraste os cartões de variante para cima ou para baixo. Coloque seus públicos-alvo mais específicos no topo. A opção de fallback sempre fica na parte inferior.
• Renomeie uma variante ou altere a condição dela: Selecione o ícone de edição (Editar lógica) no cartão da variante, atualize o nome ou a condição e selecione Salvar.
• Copie uma variante: Selecione o ícone de clonagem (Clonar variante). A cópia é adicionada diretamente abaixo do original, com o mesmo conteúdo e condição.
• Excluir uma variante: Selecione o ícone de lixeira (Excluir variante). Se restar apenas 1 variante e não houver fallback, ela volta à lógica normal de mostrar/ocultar e mantém sua condição.
• Renomeie ou exclua o fallback: use os ícones Renomear ou Excluir fallback no cartão de fallback.
• Duplicar ou excluir todas as variantes de uma vez: Abra o menu de três pontos ao lado do selo de contagem e selecione Duplicar tudo ou Excluir tudo. Excluir tudo remove todas as variantes e o fallback do seu e-mail.
• Mova o bloco: Ao arrastar um bloco ou seção com variantes de lógica na tela, você move todas as variantes dele juntas.

Variantes de lógica e lógica existente de mostrar/ocultar

As variantes de lógica não alteram nenhuma lógica de mostrar/ocultar que você já criou. Blocos e seções com lógica existente, seja criada com o construtor de lógica ou com código personalizado, são renderizados exatamente como antes. Na guia Exibição, elas mostram Editar lógica e Remover lógica em Lógica de mostrar/ocultar.

Blocos separados, cada um com sua própria lógica de exibição/ocultação, não são combinados automaticamente em variantes lógicas. Para combiná-los, crie variantes lógicas em um dos blocos, recrie as outras versões como variantes e, em seguida, exclua os blocos extras.

Limitações

• Blocos e seções de conteúdo universal, além de seções de objeto personalizado, oferecem suporte à lógica de mostrar/ocultar para apenas um público. As variantes de lógica não estão disponíveis para elas.
• Um bloco ou uma seção com variantes de lógica não pode ser salvo como conteúdo universal.
• As análises de mensagens não são detalhadas por variante.
• Se uma variante incluir um cupom, os códigos de cupom ainda serão gerados para os destinatários que veem uma variante diferente. Saiba mais sobre cupons nas mensagens.

Casos de uso para lógica de exibir/ocultar e variantes de lógica

Banner do programa de fidelidade

Se você tiver um programa de fidelidade, mostre aos participantes com atividade quantos pontos eles têm no momento. Ofereça aos contatos que ainda não se inscreveram no programa um incentivo para participar. Para configurar isso, adicione um banner e crie 2 variantes de lógica.

Mostre aos participantes do programa de fidelidade com saldo de pontos positivo uma variante chamada Membros com esta condição de exibição/ocultação:

Pontos de fidelidade > é maior que 0

Se a sua integração deixar loyalty_points sem definição para pessoas que não participaram, adicione uma variante chamada Não inscrito com esta condição:

loyalty_points > não está definido

Ajuste os critérios com base nos dados disponíveis na sua conta. A condição “não está definido” também corresponde a valores vazios ou falsos, incluindo o número 0. Se membros do programa puderem ter 0 pontos, use uma propriedade de associação para diferenciar membros de pessoas que ainda não entraram.

Imagens personalizadas

Se você coletar informações sobre como seus assinantes usam seu produto, mostre a eles imagens que tenham relação com eles.

Por exemplo, uma marca que vende mochilas pode perguntar se os assinantes as usam para ir ao trabalho, viajar ou fazer trilhas. Dependendo da resposta, essa marca pode mostrar imagens dos seus produtos nesses ambientes.

Para configurar isso, adicione um bloco de imagem e crie 2 variantes lógicas mais um fallback, cada uma mostrando seu produto em um contexto diferente.

Mostre aos passageiros uma imagem de um ciclista usando a mochila durante um deslocamento, com uma variante chamada Commuting e esta condição:

Preferência de bolsa = Deslocamento

Mostre aos viajantes uma imagem de uma das suas mochilas em um aeroporto movimentado, com uma variante chamada Travel e esta condição:

Preferência de bagagem = Viagem

Em seguida, selecione Adicionar fallback e use uma foto de uma das suas mochilas em uma paisagem externa cênica. O fallback não precisa de uma condição. Ele aparece para qualquer pessoa que não corresponda às variantes Deslocamento ou Viagem, incluindo destinatários que não têm preferência por bolsa.

Observe que o fallback não é direcionado apenas a quem faz trilhas; qualquer pessoa que não seja alguém que faz deslocamentos diários ou um viajante vai vê-lo. Um fallback garante que os destinatários que não tiverem essa propriedade definida ainda vejam uma imagem, para que seu e-mail fique ótimo para todo mundo.

Notas específicas do produto

Comunique informações específicas do produto para quem abandonou o carrinho, para fornecer informações-chave que possam influenciar a decisão de compra. Por exemplo, se você estiver ficando sem um produto, adicione um bloco de texto com um aviso de estoque baixo que apareça apenas para as pessoas com esse item no carrinho com esta condição:
'ITEM_NAME' in event.Items
Substitua ITEM_NAME pelo nome exato do produto. Este exemplo pressupõe que seu evento de acionamento tem uma lista Items contendo nomes de produtos; use a variável e a estrutura dos seus próprios dados de evento.

Mensagens específicas por local

As condições específicas de localização só podem avaliar texto; elas não podem avaliar a distância a partir de um CEP. Mostre um banner personalizado para moradores que vivem em uma determinada área, como os que estão na mesma cidade que sua loja pop-up física, com esta condição:

Cidade = Boston

Se você tiver lojas pop-up em várias cidades, crie uma variante lógica do banner para cada cidade, como City = Boston e City = Chicago, e adicione um fallback para todo mundo.

Solução de problemas de blocos de mostrar/ocultar

Se o bloco de mostrar/ocultar não estiver sendo exibido como esperado, selecione o bloco ou a seção e clique em Editar lógica. Selecione Converter em código, revise a confirmação e clique em Converter. Inspecione e ajuste o código e, em seguida, clique em Salvar. Para uma variante de lógica, selecione o ícone de edição no cartão da variante em vez de Editar lógica.

Verifique como a propriedade é armazenada e escolha o tipo de condição apropriado. As comparações de texto diferenciam o número 22 do valor de texto “22”. No entanto, as condições de Number no criador de lógica convertem texto numérico, como “22”, em um número antes de compará-lo. Valores que não podem ser convertidos em números são avaliados como 0, então verifique se há valores ausentes ou não numéricos ao solucionar problemas.

Um destinatário vê a variante de lógica errada

Os destinatários veem a primeira variante com que forem compatíveis, começando pelo topo da lista. Se um destinatário for compatível com mais de 1 variante, arraste a variante que você quer que ele veja para cima na lista ou torne a condição dela mais específica.

Alguns destinatários não veem nenhum conteúdo

Se um destinatário não corresponder a nenhuma variante e não houver fallback, nada será exibido nesse espaço. Adicione um fallback ou verifique se suas condições abrangem todo mundo, incluindo destinatários que não têm a propriedade definida.

Convertendo texto em números

Para comparações numéricas com código personalizado, converta o texto numérico em um número usando o filtro |multiply. Adicione o filtro diretamente após o nome da variável. Por exemplo, se a propriedade Age armazena a idade como texto numérico:

person|lookup:'Age'|multiply:"1" > 21

Valores booleanos armazenados como texto

Se seus dados verdadeiro/falso estiverem armazenados como texto, não como um booleano, ou se você estiver fazendo referência a uma propriedade que contém booleanos e texto, você pode usar essas estruturas para abranger todos os cenários. Inclua todas as grafias e capitalizações presentes nos seus dados.

Símbolos de comparação em valores de condição

No criador de lógica, os valores das condições não podem conter símbolos de comparação, como =, . Esses valores geram um erro de validação quando você salva. Essa restrição se aplica ao valor que você insere, não ao nome da propriedade. Outros sinais de pontuação, como espaços ou o símbolo @, não são bloqueados por essa validação. Os nomes das propriedades e os valores de texto diferenciam maiúsculas de minúsculas; portanto, faça a correspondência exata com seus dados.

Mostrar/ocultar blocos de codificação personalizada

Se você preferir ter mais controle ou se precisar de uma propriedade ou comparação que não está disponível no construtor de lógica, escreva um código personalizado para seus blocos de mostrar/ocultar. Para começar do zero usando código, selecione Usar código ao lado de Lógica no construtor de lógica. Você pode escrever um código personalizado para a lógica de mostrar/ocultar e para cada variante de lógica.

A conversão da lógica em código não é reversível.

Para converter uma condição existente, clique em Editar lógica (ou no ícone de edição no cartão da variante) e, em seguida, em Converter para código. Revise a confirmação e clique em Converter. Depois de editar seu código, clique em Salvar.

Se você optar por usar código, garanta que tenha um bom entendimento de Django, lógica de programação e dos tipos de dados da Klaviyo. A equipe de suporte da Klaviyo não pode oferecer suporte direto nem solucionar problemas de código personalizado.

This content requires Functional cookies to be enabled.

Update Cookie Settings

Saiba mais sobre estruturas de condição compatíveis.

Mostrar/ocultar condições com base nos dados do evento

Se o seu e-mail for enviado como parte de um fluxo acionado por evento (por exemplo, um fluxo de carrinho abandonado ou de confirmação de pedido), você poderá mostrar/ocultar blocos com base nos detalhes do evento de gatilho desse fluxo. Então, em um fluxo de carrinho abandonado com o gatilho Started Checkout, você pode criar condições de mostrar/ocultar com código personalizado com base no valor do carrinho ou nos itens específicos que o cliente adicionou. Saiba mais sobre variáveis de eventos.

Entenda como os dados são armazenados

Antes de configurar sua condição de mostrar/ocultar, verifique como seus dados são armazenados. Existem 5 tipos de dados na Klaviyo:

• Texto
• Número
• Data
• Booleano
• Lista

A forma como seus dados são armazenados vai influenciar quais condições de mostrar/ocultar funcionarão para você. Saiba como identificar tipos de dados na sua própria conta.

Digite sua mensagem

O primeiro passo para adicionar condições de exibir/ocultar em código personalizado em uma mensagem é criar o modelo de e-mail. Esta seção vai apresentar um exemplo específico usando variantes de lógica, mas você pode seguir as mesmas etapas para configurar qualquer bloco para ser exibido com base nos seus próprios critérios.

Por exemplo, se a sua empresa vende bolsas de couro, você pode coletar as preferências dos clientes sobre como eles usam as bolsas com um formulário de registro, como mostrado abaixo.

Você pode, então, exibir uma imagem diferente com base na preferência de bolsa do seu cliente. Por exemplo, se a preferência do cliente for "Trabalho", a bolsa aparecerá em uma imagem ao lado de um laptop. Se a preferência do cliente for "Ao ar livre", a bolsa aparecerá perto de um mirante em uma trilha de caminhada.

1. Crie uma mensagem de campanha ou de fluxo.
2. Adicione um bloco de imagens.
3. Faça upload da imagem relacionada ao trabalho no bloco.
4. Clique em Exibir no menu de personalização do bloco de imagem.
5. Em Lógica de exibição/ocultação, selecione Personalizar para vários públicos.
6. Digite Trabalho como o nome da variante e selecione Usar código.
7. Adicione esta condição: person|lookup:'Bag Preference' == 'Work'.
8. Clique em Save.

Essa variante será exibida apenas para as pessoas que selecionaram “Trabalho” como preferência.

This content requires Functional cookies to be enabled.

Update Cookie Settings

Em seguida, selecione Adicionar variante. Dê o nome de Outdoors à variante, selecione Usar código e use a condição person|lookup:'Bag Preference' == 'Outdoors'. Clique em Salvar e, em seguida, substitua a imagem na nova variante pela imagem de atividade ao ar livre.

Esta variante será exibida apenas para pessoas que selecionaram “Ao ar livre” como preferência.

Por fim, selecione Adicionar fallback e substitua a imagem do fallback por uma imagem mais genérica. O fallback aparece para qualquer pessoa que não tenha selecionado “Trabalho” nem “Ao ar livre”, incluindo pessoas que nunca escolheram uma preferência; por isso, ele não precisa de uma condição.

Depois de configurar cada uma das variantes, visualize sua mensagem usando 3 perfis. Esses perfis devem ser assinantes que atendam a um dos critérios de imagem:

• Cliente que escolheu "Atividades ao ar livre"
• Cliente que escolheu "Trabalho"
• Cliente sem preferência ou com uma preferência diferente de “Work” ou “Outdoors”

Você pode usar estas etapas para mostrar ou ocultar blocos com base nos dados do perfil. Para dados de evento, use um fluxo acionado por métrica e faça referência às propriedades do evento de acionamento.

Crie uma condição de mostrar/ocultar com dados de perfil

Se você estiver criando uma condição de mostrar/ocultar com código personalizado com base em uma Propriedade do perfil, substitua a variável de exemplo das tabelas na referência de lógica condicional (por exemplo, person|lookup:'Favorite Color') pela Propriedade do perfil.

Para encontrar a variável correta a ser usada:

1. Selecione um bloco de texto e clique em Personalização para abrir o menu de personalização.
2. Escolha uma opção no menu para adicioná-la ao bloco de texto.
3. Copie a variável de dentro da tag. Remova as chaves e os filtros de fallback ou de formatação de que você não precisa para a comparação, como |default:''. Mantenha todos os filtros de lookup que selecionam a propriedade.
   Por exemplo, na captura de tela abaixo, a tag completa é {{ person|lookup:"Accepts Marketing"|default:"" }}. O nome da variável é person|lookup:"Accepts Marketing", então selecione essa parte para usar na sua condição de mostrar/ocultar.

Crie uma condição de mostrar/ocultar com dados do evento

Você pode usar dados de evento para mostrar ou ocultar um bloco se sua mensagem fizer parte de um fluxo acionado por evento. Somente dados dentro do evento de acionamento podem ser usados em uma condição de mostrar/ocultar.

Para identificar variáveis de eventos:

1. No editor de modelos, clique em Visualização.
2. Para um modelo salvo, em Fonte de dados da prévia, clique em Evento. Em uma mensagem de fluxo acionada por métrica, os dados do evento de acionamento são selecionados automaticamente.
3. Se houver um menu suspenso de evento disponível, selecione a métrica que acionará seu fluxo. Use as setas para escolher uma ocorrência de exemplo do evento.
4. Role pelas Propriedades do evento para encontrar os dados que você gostaria de incluir.
5. Clique no nome da propriedade para copiar a tag.
6. Cole a tag em um bloco de texto ou editor de texto.
7. Remova as chaves (ou seja, {{ e }}) e os filtros de fallback ou formatação de que você não precisa para a comparação. Mantenha todos os filtros de lookup que selecionam a propriedade do evento.
8. Use a variável que permanece na sua condição de exibição/ocultação.

Na captura de tela abaixo, você verá a tag {{ event|lookup:'Item Count' }}. Você só vai precisar do texto event|lookup:'Item Count' para sua condição de mostrar/ocultar. Observe que seus dados podem usar uma estrutura diferente, como {{ event.extra.line_items.0.title }} ou {{ event.ShippingAddress.address1 }}. Use a variável como ela aparece nos dados do seu evento.

Personalize suas condições de mostrar/ocultar

Saiba como criar condições personalizadas de mostrar/ocultar usando a referência de lógica condicional. Este recurso contém exemplos de condições, que você pode personalizar usando seus próprios dados de perfil e de evento.

Recursos adicionais