Configurar conteúdo dinâmico com estruturas se

As estruturas se são uma forma baseada em texto de adicionar conteúdo dinâmico às mensagens. Permitem mostrar texto, imagens ou ligações diferentes a contactos diferentes no mesmo e-mail, com base nas informações que tem sobre eles nos campos personalizados.

Use estruturas se quando o painel de conteúdo dinâmico ao nível de estrutura não é específico o suficiente — por exemplo, quando quer personalizar uma única frase dentro de um parágrafo ou substituir apenas algumas palavras de uma saudação. As estruturas se funcionam no Construtor de e-mail, no Modelo de Assistente e no editor HTML.

Pré-requisitos

  • Conhece o nome do marcador do campo personalizado que pretende usar. Pode encontrar os nomes dos marcadores em Definições > Gerir campos personalizados.
  • O perfil de teste nas Definições está preenchido com valores representativos, para poder pré-visualizar o resultado.

Atenção As estruturas se apenas funcionam com campos personalizados. Se precisar de mostrar conteúdo com base num segmento, use o painel de conteúdo dinâmico ao nível de estrutura do Construtor de e-mail.

Sintaxe básica

Uma estrutura se é composta por três partes: uma abertura {if ...}, um {else} opcional e um fecho {/if}. Entre eles coloca o conteúdo que pretende mostrar.

Mostrar conteúdo apenas quando a condição é verdadeira:

{if ::firstname::!=""}

Mostrar um conteúdo quando a condição é verdadeira e uma alternativa quando não é:

{if ::firstname::!=""}Olá #firstname#,{else}Olá,{/if}

A parte entre {if e } é a condição — é aqui que descreve o que pretende verificar. Tudo o resto é apenas conteúdo.

Referenciar um campo personalizado

Dentro de uma estrutura se, refere-se a um campo personalizado envolvendo o marcador com dois pontos: ::marcador::. Por exemplo, para verificar o campo de nome próprio, escreve ::firstname::.

Isto é diferente da sintaxe #marcador# usada para personalização regular. Dentro das estruturas se, use sempre a forma ::marcador::.

Funções disponíveis

Verificar o valor de um campo de contacto

O uso mais comum de uma estrutura se é verificar o que está armazenado num campo de contacto e mostrar conteúdo em conformidade.

{if ::language::=="fr"}Bonjour{else}Hello{/if}

Os contactos cuja língua de contacto é francês veem "Bonjour". Todos os outros veem "Hello".

Maiúsculas, minúsculas, primeiraMaiúscula

As verificações de valores são sensíveis a maiúsculas com estruturas se. "Valor" e "valor" não são o mesmo, pelo que alguns contactos podem ficar fora da condição simplesmente porque o campo foi armazenado com capitalização diferente. Envolva o campo em uppercase(...) ou lowercase(...) para comparar com segurança:

{if uppercase(::marcador::)=="VALOR"}...{/if}

{if lowercase(::marcador::)=="valor"}...{/if}

Dica de suporte Use {uppercaseFirst(::marcador::)} no conteúdo quando quiser apresentar um campo com apenas a primeira letra em maiúscula — prático para saudações onde quer "Olá Sara" independentemente de como o nome foi originalmente armazenado.

Substituição

Use {fallback(...)} quando quer mostrar o valor do campo de um contacto, com um valor padrão para contactos onde o campo está vazio. É mais simples do que uma estrutura se/senão completa para este caso comum.

Caro {fallback(::firstname::,"cliente")}

Os contactos com nome próprio veem "Caro Sara". Os contactos sem nome veem "Caro cliente". Note que {fallback(...)} é usado sozinho dentro de chavetas — não precisa de etiquetas {if} circundantes.

Contém

Use contains() quando apenas quer verificar parte de um valor de campo, não uma correspondência exata.

{if contains(::campo::,"Valor")} … {else} … {/if}

Comprimento

Use length(...) quando o número de caracteres num campo deve determinar o conteúdo. Por exemplo, imagine que vende porta-chaves personalizados, mas apenas 7 caracteres cabem no produto:

{if length(::firstname::)<7} Artigo sobre porta-chaves personalizados {else} … {/if}

Onde colocar estruturas se

Pode colocar estruturas se em qualquer lugar onde possa escrever texto: dentro de um elemento de texto no Construtor de e-mail, nas áreas de texto do Modelo de Assistente ou no editor HTML. Funcionam da mesma forma nas três ferramentas.

Aninhamento

Pode colocar estruturas se dentro de outras para combinações mais específicas:

{if ::language::=="NL"} {if ::country::=="BE"}Welkom in België {else}Welkom{/if} {else}Welcome{/if}

Mantenha o aninhamento a um mínimo. Dois níveis de profundidade geralmente são suficientes — mais do que isso torna-se difícil de ler e fácil de quebrar.

Atenção Preencha o perfil de teste nas Definições com valores representativos para pré-visualizar se o resultado parece correto.

Erros comuns a evitar

  • Esquecer de fechar a estrutura se com **{/if}**. Uma estrutura não fechada quebra a mensagem e pode produzir resultados inesperados.
  • Usar **#marcador#** em vez de **::marcador::**. Dentro de uma estrutura se, apenas a forma ::marcador:: funciona.
  • Usar um nome de marcador que não corresponde ao que está nas Definições. Os nomes dos marcadores devem corresponder exatamente. Verifique Definições > Gerir campos personalizados se não tiver a certeza.
  • Comparar valores com capitalização diferente. "FR" e "fr" não são iguais. Envolva o campo em uppercase(...) ou lowercase(...) para tornar a comparação insensível a maiúsculas.
  • Tentar verificar um interesse ou segmento. As estruturas se apenas funcionam com campos personalizados. Para interesses ou segmentos, use o painel de conteúdo dinâmico ao nível de estrutura no Construtor de e-mail.

Próximos passos

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.