Escrever AMPscript

Objetivos de aprendizagem

Após concluir esta unidade, você estará apto a:

• Escrever uma instrução AMPscript simples.
• Utilizar o AMPscript para casos de uso específicos.

Escrever uma frase

Agora que você já conhece os blocos de construção da linguagem do AMPscript, discutiremos como redigi-lo. Falamos sobre a aula de matemática primeiro, agora focamos na aula de idiomas. Lembra-se de quando seus professores preparavam trabalhos de escrita? Talvez eles tenham mostrado a você como escrever em estilos diferentes, como poemas, histórias e artigos científicos. Você aprendeu que cada estilo de escrita é diferente, mas todos eles estão corretos. Da mesma forma, o AMPscript pode ser escrito de várias maneiras, e todas estão corretas. Vamos analisar esses estilos, alguns exemplos e quando utilizá-los.  

Tipo de estilo	Código de exemplo	Quando utilizar	Onde utilizar
AMPscript embutido	%%=LOWERCASE(FavoriteColor)=%%	Saída simples	Blocos de forma livre Blocos de trechos de código Blocos de conteúdo HTML
Bloco de AMPscript	%%[Output(LOWERCASE(FavoriteColor))]%%	Código mais complexo com várias etapas ou lógica condicional	Blocos de trechos de código Blocos de conteúdo HTML
Marca do AMPscript	<script runat=server language=ampscript>      Output(LOWERCASE(FavoriteColor))</script>	Código mais complexo com várias etapas ou lógica condicional Utilize se você estiver mais familiarizado com a sintaxe de script da web (JavaScript)	Blocos de trechos de código Blocos de conteúdo HTML

Os exemplos de código realizam a mesma coisa: a cor favorita de um cliente é exibida em letras minúsculas no e-mail enviado, mesmo que os dados sejam armazenados em maiúsculas, como nos dados de exemplo neste gráfico.

Nome do campo	Dados
FirstName	Susan
FavoriteColor	VERMELHO

Por que você precisa do AMPscript para isso, quando pode usar apenas sequências de caracteres de personalização? Analisaremos a diferença abaixo com o e-mail n.º 1 utilizando apenas sequências de caracteres de personalização e o e-mail n.º 2 utilizando um caractere de personalização e AMPscript embutido. 

E-mail n.º 1	Saída
Prezado(a) %%FirstName%%, Acabamos de receber um novo pedido de jaquetas %%FavoriteColor%% em seu tamanho. Boas compras! Atendimento ao cliente	Prezada Susan, Acabamos de receber um novo pedido de jaquetas VERMELHAS em seu tamanho. Boas compras! Atendimento ao cliente

E-mail n.º 2	Saída
Prezado(a) %%FirstName%%, Acabamos de receber um novo pedido de jaquetas %%=LOWERCASE(FavoriteColor)=%% em seu tamanho. Boas compras! Atendimento ao cliente	Prezada Susan, Acabamos de receber um novo pedido de jaquetas vermelhas em seu tamanho. Boas compras! Atendimento ao cliente

Exemplos de código

Agora vamos ao que há de bom: concluir as tarefas. Aqui estão alguns trechos comuns de código AMPscript embutido para você começar a utilizar sua nova linguagem.

Adicionar data

Você pode incluir solicitações simples, como a data e a hora do envio em sua mensagem.

Código	O que faz
Responda a este e-mail %%=Now()=%%.	Adiciona a data de envio a um e-mail.

Exemplo de formatação de moeda

É possível especificar o formato de um campo decimal em uma extensão de dados para refletir a moeda.

Código	O que faz
Valor devido: %%=Format(@price, "C", 'en-US')=%%	Atualiza o preço de um produto a fim de refletir a formatação adequada para a moeda dos EUA.

Limpeza de dados

Você também pode manipular o texto contido em uma variável para sua mensagem.

Código	O que faz
%%=ProperCase(FullName)=%%	Propercase: Retorna a sequência de caracteres especificada com a letra inicial de cada palavra em maiúscula.
%%=Lowercase(FavoriteColor)=%%	Letras minúsculas: Retorna o valor em letras minúsculas.
%%=Uppercase(FirstName)=%%	Letras maiúsculas: Retorna o valor em letras maiúsculas.
%%=Format(Now(), "YYYY")=%%	Formato: Retorna o valor de acordo com a sequência de caracteres que você especificar. A função pode ser usada para ajudar a manipular dados, como um ano inserido em um rodapé de direitos autorais.

Atualizações de idioma

Você pode alterar uma saudação com base no idioma preferido de um cliente. Essa função usa comandos if, elseif, endif. Veja um exemplo utilizando uma marca do AMPscript. 

Código	O que faz
<script runat=server language=ampscript> IF @language == 'FR' THEN     SET @greeting = 'Bonjour!' ELSEIF @language == 'SP' THEN SET @greeting = '¡Hola!' ELSE     SET @greeting = 'Hi!' ENDIF </script>	Se o idioma de um cliente for identificado como FR (francês), a saudação é exibida como Bonjour! Se o idioma de um cliente for identificado como SP (espanhol), a saudação é exibida como ¡Hola! Se o idioma de um cliente estiver definido como outro (ou caso não seja fornecido), a saudação será exibida como Hi!

Ainda mais exemplos

Por fim, aqui estão alguns comandos adicionais que você pode usar.

Código	O que faz
%%=Empty(@variable)=%%	Vazio: Retorna true quando o valor é uma sequência vazia ou nula. Você pode usá-lo para um valor que pode ser desconhecido ou nulo, como por exemplo, se o assinante possui animais de estimação.
%%=Concat(@firstname," ",@lastname)=%%	Concatenação: Concatena ou vincula elementos juntos. Por exemplo, você pode usar a função para exibir um nome completo, mesmo que tenha armazenado Nome e Sobrenome separadamente em seus dados.
%%=RedirectTo(@samplelink)=%%	RedirectTo:  Essa função redireciona um usuário para um URL especificado.
/*Are you still reading this table?*/ (/*Você ainda está lendo esta tabela?*/)	Comentários: Descreve o que seu código está fazendo para o benefício dos outros e para sua própria referência.

Como usar o AMPscript em e-mails

Agora, vamos ser práticos. Quando esses novos exemplos de código são úteis? Você pode colá-los em qualquer lugar do e-mail? Não exatamente. Vamos retornar ao exemplo que combina sequências de caracteres de personalização e AMPscript embutido para mostrar como é possível utilizar o AMPscript no Content Builder. O AMPscript embutido pode ser adicionado à maioria dos tipos de bloco no Content Builder. 

 Vamos percorrer um modo rápido de criar um bloco de conteúdo de forma livre. 

1. Navegar até o Content Builder.
2. Clique em Criar, em Blocos de conteúdo e em Forma livre na lista suspensa.
3. Insira o texto, incluindo qualquer AMPscript embutido.

Observação importante: Blocos ou marcas do AMPscript podem ser usados apenas em blocos de trechos de código ou blocos de conteúdo HTML. Basta inserir seu AMPscript no bloco de conteúdo e clicar em Edição concluída.

Na próxima unidade, avançaremos com seu aprendizado, usando as variáveis e a funcionalidade de pesquisa para extrair dados em seus e-mails de várias fontes de dados. 

Recursos

• Documentação do desenvolvedor: Introdução ao desenvolvimento do AMPscript - Lição 1
• Trailhead: Recursos do Content Builder