Exemplos práticos de AMPscript: Entendendo as funções ProperCase, Concat, DateAdd e FormatDate

Olá, Trailblazer! Em nosso primeiro artigo sobre AMPscript te demos o caminho para iniciar os estudos na linguagem. Agora, vamos partir para os exemplos práticos!🤓 No post de hoje, irei falar sobre 4 funções de AMPscript, são elas: ProperCase(), Concat(), DateAdd() e FormatDate().

Mas antes de começar, leia nosso artigo: SFMC: Desvendando a linguagem AMPscript para maximizar oportunidades de personalização.

O que são as funções em AMPscript?

As funções em AMPscript são blocos de código que executam tarefas específicas ou manipulam dados na Salesforce Marketing Cloud. As funções em AMPscript permitem que você realize diversas operações, como manipulação de strings, cálculos matemáticos, acesso a informações de dados, formatação de datas e muito mais.

Caracteres importantes para utilizar AMPscript

Alguns caracteres são necessários para linguagem AMPscript. São eles:

Fonte: Introdução ao AMPscript

Para nortear nossos exemplos, vamos considerar a amostra abaixo:

Email​	Primeiro_Nome	Sobrenome	Data_Compra
​maria@email.com	maria	Silva	2023-09-28

• Função ProperCase()

Imagine que temos uma base de clientes que necessita receber um email de boas vindas utilizando o nome do cliente no texto. Todas as linhas do campo "Primeiro_Nome" que contém na base estão com todas as letras minúsculas e, por esse motivo, é necessário fazer com que o nome fique no padrão com a primeira letra maiúscula no email. Para isso, podemos utilizar a função ProperCase() que transforma a primeira letra de cada palavra em letra maiúscula

Solução:

O que o cliente irá visualizar:

Olá, Maria! Boas vindas a nossa loja!

IMPORTANTE SABER: “VAR” é usado como uma abreviação de "variável" em comentários ou em nomes de variáveis para tornar o código mais legível. Já o “SET” é uma palavra-chave usada para atribuir um valor a uma variável. É uma parte fundamental da linguagem que permite que você armazene e manipule dados durante a execução do código AMPscript.

• Função Concat()

Imagine que é necessário enviar um email sobre um atraso de pedido, em que se faz necessário incluir o nome completo do cliente no texto da mensagem. Ao se deparar com a base, o analista percebe que a base não contém um campo de nome completo, apenas "Primeiro_Nome" e "Sobrenome". Para resolver, é possível utilizar a função Concat(), usada para concatenar (unir) duas ou mais palavras localizadas em campos distintos.

Solução:

Observação: Também é possível incluir funções direto no texto, como no exemplo acima com o ProperCase().

O que o cliente irá visualizar:

Olá! O pedido em nome de Maria Silva será entregue em 2 dias.

• Função DateAdd() e FormatDate()

Para exemplificar as funções acima, podemos pensar no seguinte exemplo: Imagine que você precisa enviar um email de lembrete para comunicar o vencimento de uma assinatura. Ao ver a base de envio, nota que só o campo da data de adesão à assinatura está disponível (Data_Compra) e que ele precisa ser formatado. Para isso, vamos precisar utilizar a função DateAdd() para conseguir chegar na data de vencimento da assinatura - aqui podemos pensar em 30 dias a partir da data da compra - e depois vamos formatar o campo com a função FormatDate().

A função DateAdd() é usada para realizar operações de adição ou subtração em datas, permitindo que você manipule datas e horários. Ela é útil para calcular datas futuras ou passadas com base em uma data existente. A sintaxe da função DateAdd() é a seguinte:

Data de referência: Campo ou variável que contém a data;

Valor: Valor numérico para adicionar ou subtrair da data;

Unidade de tempo: Unidade de tempo que você deseja usar para a operação, como "D" para dias, "Y" para anos.

A função FormatDate() é utilizada para formatar datas, ou seja, se você precisar modificar um campo de data pode recorrer a ela. A sintaxe da função FormatDate() é a seguinte:

Data: Campo ou variável que contém a data a ser formatada;

Novo Formato: Formato desejado para a data. Para conhecer todos os formatos de data, acesse aqui.

Solução:

O que o cliente irá visualizar:

Olá! A sua assinatura irá vencer no dia 28/10/23.

Pronto! Agora você conhece mais 4 funções em AMPscript! Ficou com alguma dúvida ou tem alguma sugestão? Comente aqui 👇