Pesquisa

[Manual] Mostrar ou ocultar conteúdo em seu e-mail usando instruções if

A Brevo oferece dois métodos para mostrar ou ocultar conteúdo nos seus e-mails: usar o recurso Visibilidade de conteúdo no editor de e-mail de arrastar e soltar ou digitar instruções if manualmente.
Este artigo aborda o método manual. Se preferir o recurso Visibilidade de conteúdo, confira nosso artigo dedicado Mostrar ou ocultar conteúdo nos seus e-mails (visibilidade de conteúdo).

Use uma instrução if para mostrar ou ocultar partes do seu e-mail com base nos dados de cada remetente. Isso permite que você envie um único e-mail que se adapta dinamicamente a diferentes contatos, dependendo de condições específicas.

Você pode definir condições de declaração if com base em diferentes critérios:

  • Atributos de contato
    Exibir ou ocultar seções do seu e-mail dependendo dos valores armazenados nos atributos de contato. Por exemplo, você pode mostrar uma mensagem somente VIP para Contatos com o atributo de status definido como "VIP".
  • Dados do evento
    Personalize o conteúdo com base nas ações que seus Contatos realizaram (ou não). Por exemplo, você pode mostrar um bloco promocional apenas para Contatos que nunca fizeram um pedido.
  • Feeds de dados
    Personalize o conteúdo usando dados em tempo real dos feeds externos. Por exemplo, você pode mostrar recomendações personalizadas de produtos, preços em tempo real ou informações localizadas da loja com base em dados externos.
  • Feeds de produtos
    Personalize o conteúdo usando informações de produtos do seu site de comércio eletrônico. Por exemplo, você pode mostrar seus produtos mais vendidos ou recomendações personalizadas de produtos.

O que é uma instrução if?

Uma instrução if é uma regra condicional que decide se determinado conteúdo é exibido com base em uma condição especificada. No modelo de e-mail, as instruções if permitem que você mostre ou oculte conteúdo dinamicamente de acordo com os dados do destinatário, tornando seus e-mails mais direcionados e personalizados.

Por exemplo, os e-mails abaixo são enviados do mesmo modelo, mas apresentam conteúdos diferentes de acordo com os dados do destinatário:

show_hide_content_example1_en-us.png show_hide_content_example2_en-us.png

Confira alguns exemplos:

  • Saudações personalizadas
    Exiba "Olá, Sr. X" para homens, "Olá, Sra. Y" para mulheres ou simplesmente "Olá" se o nome ou gênero estiver faltando.
  • Imagens ou promoções direcionadas
    Mostre uma imagem de um modelo vestindo o tamanho de roupa preferido do modelo ou personalize um produto na cor favorita dele.
  • Mensagens promocionais personalizadas
    Inclua ofertas especiais em e-mails transacionais com base em compras anteriores ou outros atributos de contato.

Estrutura e sintaxe de uma instrução if

Uma instrução if deve seguir regras específicas de estrutura e sintaxe:

  • A instrução começa com uma etiqueta if, seguida por uma condição: {% if ... %}. 
  • Opcionalmente, você pode incluir:
    • Condições alternativas, que são avaliadas em sequência. Elas começam com {% elif ... %}. 
    • Uma cláusula geral logo antes do final da instrução com {% else %}.
  • Cada instrução if deve terminar com {% endif %}.

Maneiras comuns de construir uma instrução if

💡 É bom saber
Evite usar uma instrução if em variáveis que contenham valores float, pois elas podem não produzir resultados precisos. No entanto, você pode aplicar uma instrução se o valor float for passado como uma string (entre aspas, por exemplo, "3.14").

Aqui estão algumas maneiras comuns de criar uma instrução if e mostrar ou ocultar conteúdo em seus e-mails com base em condições específicas:

if

Verifica se um valor é verdadeiro ou se uma matriz contém elementos (ou seja, não está vazia).

Exemplo 1

Sintaxe 
{% if condition %}
     Adicione o conteúdo a ser exibido se o valor for verdadeiro ou se uma matriz contiver elementos
{% endif %}
Exemplo de entrada 
{% if contact.active %}
     Parabéns! Você atingiu sua meta neste mês.
{% endif %}
Exemplo de saída
O valor é verdadeiro ou a matriz contém elementos O valor é falso ou a matriz está vazia

Parabéns! Você atingiu sua meta neste mês.

O conteúdo está oculto

Exemplo 2

Sintaxe 
{% if condition %}
{% for loop %}
     Adicione o conteúdo ao loop se o valor for verdadeiro ou se uma matriz contiver elementos
{% endfor %}
{% endif %}
Exemplo de entrada 
{% if params.tutors %}
Os seguintes tutores estão disponíveis para ajudar você:
{% for tutor in params.tutors %}
     {{ tutor.name }}
{% endfor %}
{% endif %}
Exemplo de saída
O valor é verdadeiro ou a matriz contém elementos O valor é falso ou a matriz está vazia

Os seguintes tutores estão disponíveis para ajudar você:

Abby Smith

James Doe

Peter Parker

O conteúdo está oculto

==

Verifica se uma expressão é verdadeira.

Exemplo 1

Sintaxe 
{% if condition == "value" %}
     Adicione o conteúdo a ser exibido se a expressão for verdadeira
{% endif %}
Exemplo de entrada 
{% if coupon == "WELCOME" %}
     Bem-vindo à nossa lista! Aqui está seu primeiro cupom: WELCOME25
{% endif %}
Exemplo de saída
A expressão é verdadeira A expressão é falsa

Bem-vindo à nossa lista! Aqui está seu primeiro cupom: WELCOME25

O conteúdo está oculto

Exemplo 2

Sintaxe 
{% if condition == true %}
     Adicione o conteúdo a ser exibido se a expressão for verdadeira
{% endif %}
Exemplo de entrada 
{% if contact.donor == true %}
     Agradecemos o seu apoio!
{% endif %}
Exemplo de saída
A expressão é verdadeira A expressão é falsa

Agradecemos o seu apoio!

O conteúdo está oculto

if, in

Verifica se um valor (substring) está presente em uma string ou se uma variável é encontrada em uma matriz.

Exemplo 1

Sintaxe 
{% if "value" in condition %}
     Adicione o conteúdo a ser exibido se um valor estiver presente em uma string ou
     se uma variável for encontrada dentro de uma matriz
{% endif %}
Exemplo de entrada 
{% if "recent" in customer.last_purchase_status %}
     Agradecemos sua compra recente! Esperamos que você goste dos seus novos itens.
{% endif %}
Exemplo de saída
O valor está presente em uma string ou a variável é encontrada em uma matriz Nenhum valor está presente em uma string ou nenhuma variável foi encontrada em uma matriz

Agradecemos sua compra recente! Esperamos que você ame seus novos itens.

O conteúdo está oculto

Exemplo 2

Sintaxe 
{% if "value" in condition %}
     Adicione o conteúdo a ser exibido se um valor estiver presente em uma string ou
     se uma variável for encontrada dentro de uma matriz
{% endif %}
Exemplo de entrada 
{% if "fragile" in params.type %}
     Manuseie com cuidado! Um ou mais itens frágeis estão no seu pedido.
{% endif %}
Exemplo de saída
O valor está presente em uma string ou a variável é encontrada em uma matriz Nenhum valor está presente em uma string ou nenhuma variável foi encontrada em uma matriz

Manuseie com cuidado! Um ou mais itens frágeis estão no seu pedido.

O conteúdo está oculto

not

Verifica se um valor é falso.

Exemplo 1

Sintaxe 
{% if not condition %}
     Adicione o conteúdo a ser exibido se um valor for falso
{% endif %}
Exemplo de entrada 
{% if not user.subscribed %}
    Você não está inscrito em nossos alertas de ofertas secretas. Cadastre-se aqui.{% endif %}
Exemplo de saída
O valor é falso O valor é verdadeiro

Você não está inscrito em nossos alertas de vendas secretas. Inscreva-se aqui.

O conteúdo está oculto

and / or

Verifica várias condições.

Exemplo 1

Sintaxe 
{% if condition1 and condition2 %}
     Adicione o conteúdo a ser exibido se todas as condições forem verdadeiras
{% endif %}
Exemplo de entrada 
{% if temperature > 10 and temperature < 55 %}
     Brr. Está frio! Aqui está um cupom de 20% de desconto em qualquer bebida quente, somente hoje.
{% endif %}
Exemplo de saída
Todas as condições são verdadeiras Pelo menos uma das condições não é verdadeira

Brr. Está frio! Aqui está um cupom de 20% de desconto em qualquer bebida quente, somente hoje.

O conteúdo está oculto

Exemplo 2

Sintaxe 
{% if condition1 == "value" and condition2 == "value" %}
     Adicione o conteúdo a ser exibido se todas as condições forem verdadeiras
{% endif %}
Exemplo de entrada 
{% if contact.lang == "FR" and contact.country == "Canada" %}
     À l'occasion de la fête du Canada ce 1er juillet 2024, profitez de 10 % 
     de réduction supplémentaires dans nos enseignes canadiennes !
{% endif %}
Exemplo de saída
Todas as condições são verdadeiras Pelo menos uma das condições não é verdadeira

À l'occasion de la fête du Canada ce 1er juillet 2024, profitez de 10 % de réduction supplémentaires dans nos enseignes canadiennes !

O conteúdo está oculto

Exemplo 3

Sintaxe 
{% if condition1 == "value" or condition2 == "value" %}
     Adicione o conteúdo a ser exibido se pelo menos uma das condições for verdadeira
{% endif %}
Exemplo de entrada 
{% if contact.country == "United States" or contact.country == "Canada" %}
     Agradecemos por comprar conosco! Aproveite o frete grátis para pedidos acima de US$ 50 nos 
     Estados Unidos e no Canadá.  
{% endif %}
Exemplo de saída
Pelo menos uma das condições é verdadeira Nenhuma das condições é verdadeira

Agradecemos por comprar conosco! Aproveite o frete grátis para pedidos acima de US$ 50 nos Estados Unidos e no Canadá.

O conteúdo está oculto

elif, else

Verifica várias ramificações.

Exemplo 1

Sintaxe 
{% if condition1 == "value" %}

         Adicione o conteúdo a ser exibido se a condição 1 for verdadeira
            
{% elif condition2 == "value" %}

        Adicione o conteúdo a ser exibido se a condição 2 for verdadeira

          {% else %} 

        Adicione o conteúdo a ser exibido se nenhuma das condições for verdadeira
          
{% endif %}
Exemplo de entrada 
Olá 
{% if contact.gender == "Male" %}
Senhor {{ contact.lastname }},
{% elif contact.gender == "Female" %}
Sra. {{ contact.lastname }},
{% else %}
,
{% endif %}
Exemplo de saída
Condição 1 é verdadeira Condição 2 é verdadeira Nenhuma das condições é verdadeira

Olá, Sr. Smith.

Olá, Sra. Jones.

Olá.

Exemplo 2

Sintaxe 
{% if condition1 == "value" %}
Adicione o conteúdo a ser exibido se a condição 1 for verdadeira
{% elif condition2 == "value" %}
Adicione o conteúdo a ser exibido se a condição 2 for verdadeira
{% else %}
Adicione o conteúdo a ser exibido se nenhuma das condições for verdadeira
{% endif %}
Exemplo de entrada 
{% if "express" in params.shipping_method %}
Seu pedido está sendo enviado via Entrega Expressa! Aguarde entrega 
dentro de 1 a 2 dias úteis.
{% elif "standard" in params.shipping_method %}
Seu pedido está a caminho com frete padrão. Deveria chegar 
dentro de 3 a 5 dias úteis.
{% else %}
Seu pedido está sendo processado. Atualizaremos você com detalhes de rastreamento em breve.
{% endif %}
Exemplo de saída
Condição 1 é verdadeira Condição 2 é verdadeira Nenhuma das condições é verdadeira

Seu pedido está sendo enviado via Entrega Expressa! A previsão de entrega é de 1 a 2 dias úteis.

Seu pedido está a caminho com frete padrão. Deve chegar dentro de 3 a 5 dias úteis.

Seu pedido está sendo processado. Atualizaremos você com detalhes de rastreamento em breve.

⏭️ O que vem a seguir?

🤔 Dúvidas?

Em caso de dúvida, sinta-se à vontade para entrar em contato com nossa equipe de suporte, criando um tíquete a partir da sua conta. Caso ainda não tenha uma conta, entre em contato conosco aqui.

Se você está procurando ajuda com um projeto usando o Brevo, podemos encontrar à agência parceira da Brevo certa.

💬 Este artigo foi útil?

12 de 26 acharam isto útil