Referência de lógica condicional para modelos

O que você vai aprender

Conheça todas as condições disponíveis que podem ser usadas para exibir dinamicamente um bloco, uma seção ou uma parte de conteúdo codificado personalizado em um modelo de e-mail somente para determinados destinatários. Para saber como usar essas condições em seus modelos, consulte Como mostrar ou ocultar blocos de modelos com base em variáveis dinâmicas. 

Saiba como usar a lógica condicional:

• Onde o senhor pode usar as condições
• Dicas para o sucesso
• Estruturas de condições
• Criar condições complexas

Onde o senhor pode usar as condições

O senhor pode usar condições: 

• Na lógica mostrar/ocultar, para exibir dinamicamente blocos ou seções do modelo de e-mail somente para determinados destinatários. 
  • Se o senhor preferir não escrever código, use o construtor de lógica mostrar/ocultar. 
• Dentro de condicionais if/else para escrever declarações personalizadas do Django.

Dicas para o sucesso

Ao criar condições de mostrar/ocultar, preste atenção aos detalhes. As condições de mostrar/ocultar diferenciam maiúsculas de minúsculas e a ortografia deve corresponder exatamente ao seu perfil ou aos dados do evento. 

Além disso, certifique-se de considerar todos os possíveis destinatários de seu e-mail. Por exemplo, se o senhor mostrar um bloco específico somente para residentes de um determinado estado, cubra todas as grafias possíveis do nome desse estado (por exemplo, Massachusetts, massachusetts, mass, MA). Leve em consideração também os perfis que podem não ter a propriedade definida.

Depois de criar a mensagem e aplicar as condições, visualize o e-mail usando uma variedade de perfis para confirmar que a mensagem é exibida como você pretendia em todos os cenários. 

Estruturas de condições

As condições devem incluir de 1 a 3 elementos, dependendo do seu objetivo para o bloco e dos dados que estiver usando. A condição deve incluir pelo menos uma variável (por exemplo, person|lookup:'Favorite Color'). Ele também pode incluir uma função de comparação, como = (igual) ou > (maior que) e um valor, que especifica um valor de propriedade específico a ser procurado. Além disso, algumas condições começam com not (não), caso o senhor queira que o bloco apareça apenas para perfis que não atendam a uma condição. 

A tabela abaixo contém uma lista completa das possíveis estruturas que uma condição de mostrar/ocultar pode seguir. 

Condições para booleanos

Se estiver fazendo referência a dados armazenados como booleanos, o senhor precisará usar 1 e 0 em vez de "true" e "false" na definição da condição show/hide. Não coloque o 1 ou 0 entre aspas. Use os exemplos de condições abaixo como modelo.

Condições para booleanos armazenados como texto

Se os dados true/false forem armazenados como texto, e não como booleano, use as condições de exemplo para propriedades de texto acima. Se não tiver certeza, ou se estiver fazendo referência a uma propriedade que contenha booleanos e texto, o senhor pode usar essas estruturas para cobrir todos os cenários. Inclua todas as grafias e maiúsculas presentes em seus dados. 

Criar condições complexas

Se quiser que seu bloco seja exibido para pessoas que atendam a vários critérios ou se tiver um caso de uso complexo, poderá usar várias condições de mostrar/ocultar para um bloco. Para isso, conecte uma série de condições com AND ou OR. Por exemplo, se o senhor quiser exibir um bloco para qualquer pessoa em Massachusetts, mas Massachusetts estiver escrito de forma diferente em alguns perfis, poderá usar uma condição como esta: 

person.location.region == 'Massachusetts' or person.location.region == 'massachusetts' or person.location.region == 'mass' or person.location.region == 'MA'

Se o senhor quiser mostrar um bloco somente para pessoas cuja cor favorita seja verde e que também sejam VIPs, poderá usar uma condição como esta: 

person|lookup:'Favorite Color' == 'green' and person|lookup:'VIP'== 1

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

Quando o senhor 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 são visíveis apenas no campo Código-fonte de um bloco de texto: 

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

Recursos adicionais

• Como mostrar ou ocultar blocos de modelos com base em variáveis dinâmicas
• Referência de personalização de mensagens 
• Guia de perfis em Klaviyo 
• Glossário de filtros variáveis