Personalize seu e-mail com as condições "IF"

Neste artigo, vamos explicar como personalizar seus e-mails com as condições if

O que são condições if?

A lógica poderosa oferecida pelas condições if permite que você adicione ou remova blocos inteiros de design dentro de uma campanha ou modelo de e-mail ou altere um conteúdo específico dentro de um bloco, dependendo das condições definidas por você. Você pode usar as condições if de duas maneiras diferentes:

  • Condições if simples podem ser aplicadas de modo rápido e fácil a blocos de design individuais no Editor arrastar e soltar (Clássico) usando o recurso de construção Exibição condicional.
    if_conditions_editor_EN.png
  • Declarações if personalizadas podem ser construídas e colocadas diretamente dentro do conteúdo de sua campanha ou modelo de e-mail.
    mceclip1.png

O uso de condições if efetivamente estende a utilidade de um único e-mail para múltiplos cenários, exibindo diferentes conjuntos de conteúdo ou texto com base:

  • nos atributos de contato definidos em sua lista de contatos
  • nos parâmetros transmitidos em seu API call

Usos comuns para as condições if 

Existem inúmeras maneiras de usar as condições if para personalizar o conteúdo de um e-mail, mas as mais comuns são

  1. um e-mail de saudação, como Olá, Sr. Silva, Olá, Sra. Barros ou simplesmente Olá para contatos sem gênero ou nome nos arquivos.
  2. um produto ou imagem promocional, como para promover a imagem de uma modelo vestindo a mesma roupa ou tamanho que seu destinatário ou exibindo o item em destaque na cor favorita dele.
    If_conditions_email-2_EN.png  If_conditions_email-1.png
  3. uma mensagem promocional, como para incluir uma oferta extra de marketing em seus e-mails transacionais, com base nas compras ou nos atributos deles.
    If_conditions_email-3_EN.png  Email_3.png

Estrutura de uma declaração if

Aqui estão algumas regras que você deve seguir ao construir suas próprias declarações if:

  • Uma declaração if sempre sempre começa com uma tag if contendo uma condição: {% if ... %}
  • Opcionalmente, a declaração if pode conter condições alternativas, as quais serão avaliadas em sequência. Estas condições alternativas começam com: {% elif ... %}
  • Também em uma base opcional, uma cláusula catch-all pode ser adicionada logo antes do fim da declaração if, dessa forma: {% else %}
  • Uma declaração if sempre termina com: {% endif %}

Entendendo como declarações if são processadas

💡 Dica
Se você achar esta seção muito técnica, recomendamos que pule direto para a seção Exemplos práticos deste artigo.

A condição if é o que vai dentro das tags {% if ... %} e {% elif ... %}. Ao processar sua declaração if, o sistema vai avaliar a condição e:

  • se a condição for atendida, a linha seguinte será exibida, assumindo que seja uma linha de texto (também pode ser uma linha de código, uma vez que você pode usar nossa linguagem de modelo para realizar uma operação de dentro da declaração if, em cujo caso a linha de código será executada).
  • se a condição não for atendida, a linha seguinte será ignorada e o sistema moverá para avaliar a próxima condição {% elif ... %} (se houver uma), ou processar a cláusula catch-all {% else %} (novamente se houver uma). De outro modo, alcançará a tag {% endif %} e nada mais acontecerá como parte da declaração if.

Assim que uma condição tiver sido atendida, o sistema pulará quaisquer condições {% elif ... %} ou cláusulas catch-all {% else %} restantes. Isso significa que algumas vezes, você precisa pensar sobre a melhor posição para arrumar as condições dentro da declaração if (outras vezes, a ordem não importará).

Construindo suas próprias condições if

Para corresponder a um pedaço de texto (também conhecido como “string”) no caso de um atributo de  “Texto”, você pode usar: {% if contact.GENDER == "Male" %}. Esta condição poderá fazer com que a linha a seguinte na declaração seja processada apenas se o atributo contact.GENDER for igual a “Masculino”.

Se quiser avaliar se um atributo contém um valor, apenas o nome do atributo precisa ser colocado na condição, sem lógica adicional. Por exemplo, para {% if contact.FIRSTNAME %}, se houver dado armazenado em contact.FIRSTNAME, a linha seguinte na declaração será processada; se contact.FIRSTNAME estiver vazio, a linha seguinte será pulada.

Isso também pode ser usado no caso de atributos “Booleanos”. A condição {% if contact.IS_REGISTERED %} seria preenchida se contact.IS_REGISTERED for um atributo "Booleano" definido como “verdadeiro”; se definido como “falso” ou sem valor, a condição não seria atendida.

Exemplos práticos

Aqui estão alguns exemplos práticos com base nas declarações if mais comumente usadas.

Use uma declaração if para exibir texto suplementar apenas para alguns contatos

Vamos dizer, por exemplo, se sua lista de contatos inclua um atributo “Booleano” chamado "MEMBER", o qual está definido como "verdadeiro" se o contato tiver comprado uma assinatura. Você pode querer adicionar uma mensagem suplementar para estes contatos. Você pode fazer isso com a seguinte declaração if:  

{% if contact.MEMBER %}
Obrigado por renovar sua assinatura!
{% endif %}

Exiba uma saudação personalizada quando souber o nome do contato e, caso contrário, uma saudação genérica

Isso é útil se você quiser incluir uma saudação como "Prezado, {{ contact.FIRSTNAME }}" em seu e-mail, mas nem todos os seus contatos têm dados para o atributo FIRSTNAME.

{% if contact.FIRSTNAME %}
Prezado(a) {{ contact.FIRSTNAME }},
{% else %}
Prezado cliente,
{% endif %}

Exiba um pronome de tratamento de acordo com o gênero do seu contato e, caso contrário, uma saudação genérica

Além de usar condições if para verificar por valores verdadeiros ou valores que simplesmente existam, você também pode verificar por valores falsos ou avaliar diversas condições ou ramos.

Seguindo o exemplo comum de personalização de saudação de um e-mail, você pode querer exibir uma de três saudações possíveis, dependendo se o atributo de contato para GENDER é Masculino, Feminino, ou vazio. Neste caso, você pode usar as tags {% elif %} para adicionar conteúdo alternativo quando o valor para GENDER for Feminino, e {% else %} para adicionar um back-up para qualquer outro caso:

Olá, {% if contact.GENDER == "Male" %} Sr. {{ contact.LASTNAME }}, 
{% elif contact.GENDER == "Female" %} Sra. {{ contact.LASTNAME }},
{% else %} there, {% endif %}

⏩ O que vem a seguir?

Enquanto estes exemplos focam na estrutura das condições if com atributos de contato, você também pode aplicar estas condições a parâmetros transacionais dentro do Editor arraste e solte (Clássico) ou manualmente construindo-os em seu e-mail:

🤔 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.