Usar variáveis e funcionalidades de pesquisa

Objetivos de aprendizagem

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

• Explicar variáveis e como elas são usadas no AMPscript.
• Identificar quando usar funções de Lookup() e LookupRows ().

Definindo variáveis

No início deste módulo, descrevemos variáveis no AMPscript como um espaço reservado para dados. Analisaremos esta questão ao observar o modo como os elementos de código funcionam em conjunto para definir e configurar variáveis.

Código	O que faz
VAR @cats	Define os espaços reservados.
SET @cats = catbreed	Define um valor a partir da extensão de dados enviáveis.
SET @cats = "tabby"	Define um valor específico ou literal.
%%=v(@cats)=%%	AMPscript embutido utilizado em seu conteúdo de e-mail para retornar o valor.

Desconstruiremos esses elementos em um e-mail que utiliza o AMPscript.

1. Inicie seu código com %% [ para o bloco AMPscript e adicione comentários opcionais sobre o código utilizando /* e */.

2. Declare as variáveis às quais você fará referência na mensagem utilizando a estrutura de VAR @createdname. É possível utilizar qualquer nome de variável desejado. Algumas pessoas acham útil reduzir o nome de um campo de extensão de dados ou criar um nome descritivo e fácil de reconhecer. Neste exemplo, utilizamos VAR @memid, @fname, @lname e assim por diante. Certifique-se de separar cada variável com uma vírgula.

3. Em seguida, atribua as variáveis de acordo com um valor do campo de extensão de dados enviáveis. Essa operação é feita com o uso de SET @name = ActualFieldName. Ao definir essas variáveis, elas precisam corresponder às variáveis declaradas da segunda etapa. Depois de definir os campos que serão usados, finalize o bloco com ]%%.

A seguir veremos a parte divertida da elaboração de conteúdo! 

4. Esse bloco de código exibe os dados na extensão de dados para preencher essa parte do conteúdo. O código %%= v(@fname) =%% é o AMPscript embutido que puxa FirstName de sua extensão de dados enviáveis, identificada por SET @fname.

Com um pouco de CSS e formatação (e, claro, dados na extensão de dados correspondente), esse email é preenchido desta maneira com o uso de Visualizar e testar. 

Excelente.

Funções de pesquisa

O AMPscript é usado extensivamente para extrair dados de extensões de dados utilizando Lookup () e LookupRows (). Eles são úteis para quando você precisa capturar informações de extensões de dados que não são as utilizadas para envio. Por exemplo, você pode estar enviando uma campanha para uma extensão de dados segmentada de seus principais assinantes, mas precisa fazer referência à extensão de dados de seu produto em seu e-mail para buscar sua compra mais recente. As funções Lookup()and LookupRows() permitem – você adivinhou – buscar dados em extensões de dados especificadas e retornar campos com base nos valores incluídos nas funções. Vamos analisar.

	Lookup()	LookupRows()
Descrição	Retorna critérios correspondentes para um conjunto de dados em uma tabela para um campo de dados.	Retorna critérios correspondentes para um conjunto de dados em uma tabela, mas retorna dados armazenados em várias colunas.
Exemplo de código	%%= Lookup("LoyaltyLevelDE","LoyaltyLevel","MemberID", @memId)=%%	%%= LookupRows("FlightInfoDE","Flight", Flight,"Seat",Seat Number, "Boarding", BoardingGroup) =%%
Caso de uso de exemplo	Corresponder o nível de fidelidade no registro do assinante com a tabela de fidelidade para exibir o nível adequado em um e-mail.	Corresponder o número de referência da reserva na tabela do assinante à tabela de reservas para exibir o número do voo, o tempo de voo, o número do assento e o grupo de embarque.

Imagine que você está assando um bolo para o aniversário de seu amigo. Você não iria diversas vezes ao mercado para adquirir farinha, em seguida açúcar, e depois ovos. Da mesma forma, não faria sentido utilizar Lookup() quando é possível obter todos os ingredientes em uma viagem por meio de LookupRows(). Usar essa função cria eficiência e ajuda no desempenho.

Verificação de conhecimento

Pronto para analisar o que aprendeu? A verificação de conhecimento abaixo não é pontuada – é apenas uma maneira fácil para se questionar. Para usá-la, arraste a função na coluna esquerda para a finalidade correspondente à direita. Ao concluir a correspondência de todos os itens, clique em Enviar para verificar seu trabalho.

Ótimo trabalho! Na próxima unidade, iniciaremos o Trailhead Simulator para praticar o uso do AMPscript no aplicativo. 

Recursos

• Documentação do desenvolvedor: Introdução ao desenvolvimento do AMPscript - Lição 2
• Site externo: Guia de AMPscript: usando variáveis