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

Estimado 13 minuto de leitura
|
Atualizado 13 de nov. de 2024, 16:54 EST
O que você vai aprender

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 o construtor de lógica mostrar/ocultar do editor de modelos.  

O senhor pode usar isso para exibir conteúdo diferente, por exemplo, para aqueles que estão em determinados níveis de fidelidade ou que compraram um produto específico. Esse recurso permite que o senhor direcione o conteúdo do seu e-mail com base em informações sobre o assinante, para que cada destinatário tenha uma experiência de marketing altamente personalizada.  

Antes de começar

Antes de começar

O senhor pode mostrar/ocultar o conteúdo com base em: 

  • Dados de perfil (ou seja, o perfil ou propriedades personalizadas)
  • Variáveis de evento, mas apenas para:
    • Fluxo acionado por evento (também chamado de fluxo acionado por métrica)
    • Bloco show/hide com código personalizado

Antes de criar seu e-mail, o senhor deve ter os dados necessários em sua conta. Em outras palavras, o senhor deve ter 1 evento ou perfil com a propriedade que deseja usar. 

Uso de dados de perfil

Se o senhor quiser mostrar/ocultar condições com base nos dados do perfil (por exemplo, local, idioma etc.), precisará de pelo menos um perfil com esses dados. 

As propriedades personalizadas e de perfil podem ser adicionadas das seguintes maneiras: 

Saiba mais sobre as propriedades de perfil em Klaviyo. 

Uso de propriedades de eventos

Da mesma forma, para as propriedades de evento, deve haver 1 evento em sua conta da Klaviyo. Em seguida, o senhor pode mostrar/ocultar o bloco com base no evento de acionamento desse fluxo usando blocos com código personalizado. O senhor não pode fazer referência a dados de eventos usando o construtor de lógica. 

Assim, em um carrinho abandonado fluxo com o acionador Started checkout, o senhor pode criar condições de mostrar/ocultar com base no valor de um carrinho ou nos itens específicos que o cliente adicionou. 

Crie sua mensagem

Crie sua mensagem

O construtor de lógica show/hide suporta dados de perfil formatados como texto, números e lista. Ele não oferece suporte a dados de eventos, datas ou booleanos. Se o senhor quiser usar dados não suportados em sua condição de mostrar/ocultar, use código personalizado para escrever a condição

  1. Adicione um bloco ou seção a um modelo de e-mail. 
  2. Selecione a guia Display.
    A guia de exibição de um bloco
  3. Em Mostrar/ocultar lógica, selecione Usar construtor de lógica
  4. Selecione uma condição. 
    1. O senhor 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 os conectores AND versus OR
  5. Use o botão Add condition (Adicionar condição ) para adicionar condições adicionais, se desejar. 
  6. Selecione Salvar

Se usar a lógica mostrar/ocultar em uma seção e um bloco dentro dessa seção, as configurações podem interagir e causar conflitos. Saiba mais em nosso artigo sobre opções de exibição

AND vs. OR em condições de mostrar/ocultar 

AND vs. OR em condições de mostrar/ocultar 

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

Como exemplo, considere a seguinte condição: 

Uma condição de segmento de amostra

Seguindo esses critérios, verifique se o bloco está visível para alguns destinatários da amostra: 

BeneficiárioO bloco é exibido?Por quê?

Jane

loyalty_points = 145

Cor favorita = verde 

Fruta favorita = banana 

NãoJane poderia qualificar se sua cor favorita era azul ou se sua fruta favorita era banana

Alex
loyalty_points = 73

Cor favorita = azul

Fruta favorita = maçã

NãoAlex poderia se qualificar com mais pontos de fidelidade, ou se sua fruta favorita fosse kiwi.

Amanda
loyalty_points = 110

Cor favorita = azul

Fruta favorita = romã

SimA Amanda se qualifica porque tem > 99 pontos de fidelidade e sua cor favorita é azul. Sua fruta favorita não é considerada, porque ela atende a ambos os critérios no lado oposto do operador OR. 

Stephanie
pontos_de_fidelidade = 42

Cor favorita = laranja

Fruta favorita = kiwi

SimStephanie se qualifica porque sua fruta favorita é o kiwi. As outras condições não são consideradas, porque ela atende aos critérios em um lado do operador OR. 

 

Casos de uso para mostrar/ocultar bloco 

Casos de uso para mostrar/ocultar bloco 

problema de fidelidade banner

problema de fidelidade banner

Se o senhor tiver um problema de fidelidade, mostre aos participantes ativos quantos pontos eles têm no momento. Ofereça ao contato que ainda não se inscreveu no programa um incentivo para participar. Para configurar isso, o senhor precisará de 2 banners. 

Mostre aos participantes ativos do problema de fidelidade um banner com essa condição de mostrar e ocultar: 

Pontos de fidelidade > é maior que 0 

Uma condição para mostrar um bloco para aqueles com mais de 0 pontos de fidelidade 

Mostre aos clientes potenciais um banner com essa condição: 

loyalty_points > não está definido

Uma condição para mostrar um bloco para quem não tem uma propriedade de pontos de fidelidade

Talvez o senhor precise ajustar os critérios com base nos dados disponíveis em sua própria conta. 

Imagens personalizadas

Imagens personalizadas

Se o senhor coletar informações sobre como o assinante usa o produto, mostre imagens relacionadas a ele. 

Por exemplo, uma marca que vende mochilas pode perguntar se o assinante as usa para ir ao trabalho, viajar ou fazer caminhadas. Dependendo da resposta, a marca poderia mostrar imagens de seus produtos nesses ambientes. 

Para configurar isso, o senhor precisará de 3 blocos de imagens mostrando seu produto em 3 configurações diferentes. 

Mostre aos passageiros uma foto de um motociclista usando a mochila durante um trajeto com essa condição: 

Preferência de bolsa = deslocamento para o trabalho

Uma condição para aqueles que usam a bolsa para se deslocar

Mostre aos viajantes uma foto de uma de suas mochilas em um aeroporto movimentado com essa condição: 

Preferência de bolsa = Viagem

Uma condição para quem usa sua bolsa para viajar

Mostre a todos uma foto de uma de suas mochilas em uma paisagem externa com essa condição: 

A preferência de bolsa > não é igual a > Travel AND A preferência de bolsa > não é igual a > Commuting

Uma condição para aqueles que usam a bolsa para qualquer outra coisa

Observe que a última imagem não é direcionada apenas aos caminhantes; qualquer pessoa que não seja um viajante ou viajante a verá. É importante levar em conta os destinatários que talvez não tenham essa propriedade definida, para que seu e-mail tenha uma boa aparência para todos. 

Notas específicas do produto

Notas específicas do produto

Para fazer referência a um item no evento de acionamento de um fluxo, é necessário usar um código personalizado.

Comunique informações específicas do produto aos abandonadores de carrinhos, para fornecer a eles informações importantes que possam influenciar a decisão de compra. Por exemplo, se um produto estiver acabando, adicione um bloco de texto com um aviso de estoque baixo que apareça apenas para as pessoas com esse item no carrinho com essa condição:
ITEM_NAME in event.Items

Uma condição para aqueles que têm um item específico em seus carrinhos

Mensagens específicas do local 

Mensagens específicas do local 

As condições específicas do local só podem avaliar o texto; elas não podem avaliar a distância de um CEP. Mostre um banner personalizado aos residentes que moram em uma determinada área, como os que estão na mesma cidade da sua loja pop-up física, com essa condição:

Cidade = Boston

Uma condição para os residentes de Boston

Solução de problemas Mostrar/ocultar bloco 

Solução de problemas Mostrar/ocultar bloco 

Se o bloco mostrar/ocultar não estiver sendo renderizado conforme o esperado, use o botão Converter em código para converter a lógica do construtor em código. A partir daí, o senhor pode inspecionar e ajustar o código para que seja renderizado conforme o esperado. 

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

Ao solucionar problemas, confirme se o tipo de dados usado no valor da condição é o mesmo que o tipo de dados no perfil ao qual o senhor está fazendo referência. Por exemplo, o número 22 é diferente do valor de texto "22". Se a condição for definida como Número, mas os valores estiverem armazenados como texto no perfil, a condição não poderá ser avaliada corretamente. 

Conversão de texto em números 

Se o senhor tiver propriedades numéricas, mas elas estiverem armazenadas como texto em um perfil, poderá convertê-las em números no campo de código personalizado usando o filtro |multiply. Para usar isso, adicione o filtro diretamente após o nome da variável: 

person.Birthday|multiply:"1" > 21

Booleans armazenar como texto 

Se os dados true/false forem armazenados como texto, não como booleano, ou se o senhor estiver fazendo referência a uma propriedade que contenha booleanos e texto, poderá usar essas estruturas para cobrir todos os cenários. Inclua todas as grafias e maiúsculas presentes em seus dados. 

Condição da amostraMostre o bloco se...
person|lookup:'VIP' == 1 or person|lookup:'VIP' == 'true' or person|lookup:'VIP' == 'True'A propriedade VIP é definida como o valor booleano true ou as cadeias de caracteres true ou True
person|lookup:'VIP' == 0 or person|lookup:'VIP' == 'false' or person|lookup:'VIP' == 'False'A propriedade VIP é definida como o valor booleano false ou as cadeias de caracteres false ou False

Caracteres não alfanuméricos nas propriedades

Se as propriedades ou os valores referenciados pelo bloco mostrar/ocultar contiverem caracteres não alfanuméricos (por exemplo, símbolos como =, ), a condição poderá não ser avaliada corretamente. Para obter melhores resultados, use apenas letras (maiúsculas ou minúsculas, sensíveis a maiúsculas), números, sublinhados (_) ou traços (-). 

Codificação personalizada para mostrar/ocultar bloco

Codificação personalizada para mostrar/ocultar bloco

Se preferir ter mais controle, ou se quiser criar uma condição usando dados de eventos, datas ou booleanos, codifique seu bloco mostrar/ocultar de forma personalizada em vez de usar o construtor de lógica. Para começar do zero usando código, selecione o botão Usar código nas configurações de mostrar/ocultar lógica. 

A opção de código personalizado

Como alternativa, converta uma condição show/hide existente para usar código com o botão Converter em código

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

Se o senhor optar por usar código, certifique-se de que tem um bom conhecimento do Django, da lógica de programação e dos tipos de dados do Klaviyo. A equipe de suporte da Klaviyo não é capaz de fornecer suporte direto ou solução de problemas para códigos personalizados. 

Saiba mais sobre estruturas de condição suportada. 

Mostrar/ocultar condições com base em dados de eventos

Mostrar/ocultar condições com base em dados de eventos

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

Entender como os dados são armazenados

Entender como os dados são armazenados

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

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

A forma como seus dados são armazenados influenciará as condições de mostrar/ocultar que funcionarão para o senhor. Saiba como identificar tipos de dados em sua própria conta.

Crie sua mensagem

Crie sua mensagem

A primeira etapa para adicionar condições de exibição/ocultação com código personalizado em uma mensagem é criar o modelo de e-mail. Esta seção apresentará um exemplo específico, mas o senhor pode seguir as mesmas etapas para definir qualquer bloco a ser exibido com base em seus próprios critérios.

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

O formulário de registro

O senhor 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 panorâmico em uma trilha de caminhada. 

  1. Criar uma mensagem de Campanha ou fluxo.
  2. Adicionar um bloco de imagem.
  3. Faça o upload da imagem relacionada ao trabalho para o bloco.
  4. Clique em Display no menu de personalização do bloco de imagens.
  5. Em Show/hide logic (Mostrar/ocultar lógica), selecione Use code (Usar código). 
  6. Adicione esta condição: person|lookup:'Bag Preference' == 'Work'
  7. Clique em Save Changes (Salvar alterações). 
  8. Clique em Done (Concluído ) no bloco.

Esse bloco será exibido somente para as pessoas que selecionaram "Work" (Trabalho) como preferência. 

Em seguida, adicione a imagem relacionada à viagem a um novo bloco abaixo da imagem relacionada ao trabalho. Siga as mesmas etapas anteriores, mas, dessa vez, use a condição person|lookup:'Bag Preference' == 'Outdoors'

Esse bloco só será exibido para as pessoas que selecionaram "Outdoors" como preferência. 

Preferência de bolsa = ao ar livre

Por fim, adicione uma imagem para aparecer para qualquer pessoa que não tenha selecionado "Work" (Trabalho) ou "Outdoors" (Ao ar livre). Use uma imagem mais genérica e esta condição: person|lookup:'Bag Preference' != 'Work' e person|lookup:'Bag Preference' != 'Outdoors'.

Aqui, != significa que "não é igual a", de modo que essa condição procura pessoas que escolheram algo diferente de "Trabalho" ou "Ao ar livre" ou que nunca selecionaram uma preferência. 

Preferência de bolsa = qualquer outra coisa

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

  • Cliente que escolheu "Outdoors" (ao ar livre) 
  • Cliente que escolheu "Trabalho
  • E clientes sem preferência/com outra preferência

O senhor pode usar essas etapas para mostrar ou ocultar blocos com base em qualquer perfil ou dados de evento em sua conta. 

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

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

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

Para encontrar a variável correta a ser usada:

  1. Clique em Personalization (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 o nome da variável de dentro da tag. Para identificar o nome da variável, remova os colchetes ao redor da variável, bem como |default:'' no final (se houver), juntamente com qualquer outro filtro.
    Por exemplo, na captura de tela abaixo, a tag completa é {{ person|lookup:"Accepts Marketing"|default:"" }}. O nome da variável é person|lookup:"Accepts Marketing", portanto, selecione essa parte para usar em sua condição show/hide. 

Uma variável para a lógica de mostrar/ocultar

Criar uma condição de mostrar/ocultar com dados de eventos

Criar uma condição de mostrar/ocultar com dados de eventos

O senhor pode usar dados de eventos para exibir ou ocultar um bloco se a mensagem fizer parte de um fluxo acionado por eventos. Somente os 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 Preview & test.
  2. Em Preview data source (Visualizar fonte de dados), clique em Event (Evento).
  3. No menu suspenso, selecione o evento que acionará a mensagem que o senhor está criando. 
  4. Percorra as propriedades do evento para encontrar os dados que o senhor deseja 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 os colchetes (ou seja, {{ and }}) da tag, bem como quaisquer filtros.
  8. Use a variável que permanece em sua condição de mostrar/ocultar.

Na captura de tela abaixo, o senhor verá a tag {{ event|lookup:'Item Count' }}. O senhor só 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 em seus dados de evento. 

Visualizar dados para encontrar variáveis de eventos

Personalize suas condições de mostrar/ocultar

Personalize suas condições de mostrar/ocultar

Saiba como criar condições personalizadas de mostrar/ocultar usando a referência de lógica condicional. Esse recurso contém exemplos de condições, que o senhor pode personalizar usando seu próprio perfil e dados de eventos. 

Recursos adicionais

Recursos adicionais

Esse artigo foi útil?
Use esse formulário somente para fazer comentários sobre artigos. Saiba como entrar em contato com o suporte.

Saiba mais sobre a Klaviyo

Comunidade
Conecte-se com colegas, parceiros e especialistas da Klaviyo para encontrar inspiração, compartilhar percepções e obter respostas para todas as suas perguntas.
Treinamentos ao vivo
Participe de uma sessão ao vivo com especialistas da Klaviyo para aprender sobre as práticas recomendadas, como configurar os principais recursos e muito mais.
Suporte

Acesse o suporte por meio da sua conta.

Suporte por e-mail (teste gratuito e contas pagas) Disponível 24 horas

Chat/assistência virtual
A disponibilidade varia conforme o local e o tipo de plano