Redactar AMPscript

Objetivos de aprendizaje

Después de completar esta unidad, podrá:

• Redactar una declaración de AMPscript sencilla.
• Utilizar AMPscript para casos de uso específicos.

Redactar una frase

Ahora que conoce las partes integrantes del lenguaje de AMPscript, debatamos acerca de cómo redactarlo. Platicamos acerca de clases de matemáticas antes, de modo que ahora piense de nuevo en la clase de lenguaje. ¿Recuerda cuándo sus profesores le dieron tareas de escritura? Quizás le mostraron cómo escribir en diferentes estilos, como poemas, historias y documentos de investigación. Aprendió que cada estilo de escritura es diferente, pero todos ellos son correctos. Del mismo modo, AMPscript se puede redactar en algunas maneras y todas son correctas. Revisemos estos estilos, algunos ejemplos y cuándo podría utilizarlos.  

Tipo de estilo	Código de ejemplo	Cuándo utilizarlo	Dónde utilizarlo
AMPscript en línea	%%=LOWERCASE(FavoriteColor)=%%	Resultado sencillo	Bloques de formato libre Bloques de fragmento de código Bloques de contenido HTML
Bloque de AMPscript	%%[Output(LOWERCASE(FavoriteColor))]%%	Código más complejo con múltiples pasos o lógica condicional	Bloques de fragmento de código Bloques de contenido HTML
Etiqueta AMPscript	<script runat=server language=ampscript>      Output(LOWERCASE(FavoriteColor))</script>	Código más complejo con múltiples pasos o lógica condicional Utilizar si está más familiarizado con sintaxis de secuencia de comandos web (JavaScript)	Bloques de fragmento de código Bloques de contenido HTML

Los ejemplos de código todos realizan lo mismo: El color favorito de un cliente aparece en minúsculas en el email enviado, incluso si los datos están almacenados en mayúsculas por los datos de muestra en este gráfico.

Nombre de campo	Datos
FirstName	Susan
FavoriteColor	ROJO

¿Por qué necesitamos AMPscript para esto, cuando puede simplemente utilizar cadenas de personalización? Revisemos la diferencia a continuación con email #1 utilizando solo cadenas de personalización, e email #2 utilizando tanto una cadena de personalización como AMPscript en línea. 

Email #1	Resultado
Estimado/a %%FirstName%%, Acabamos de recibir un nuevo pedido de chaquetas %%FavoriteColor%% en su talla. Felices compras, Servicio al cliente	Estimada Susan, Acabamos de recibir un nuevo pedido de chaquetas ROJAS en su talla. Felices compras, Servicio al cliente

Email #2	Resultado
Estimado/a %%FirstName%%, Acabamos de recibir un nuevo pedido de chaquetas %%= LOWERCASE(FavoriteColor)=%% en su talla. Felices compras, Servicio al cliente	Estimada Susan, Acabamos de recibir un nuevo pedido de chaquetas rojas en su talla. Felices compras, Servicio al cliente

Ejemplos de código

Ahora llega lo bueno: completar las tareas. Estos son algunos fragmentos de código de AMPscript en línea comunes para comenzar con su nuevo lenguaje.

Agregar fecha

Puede incluir solicitudes sencillas como la fecha y la hora del envío en su mensaje.

Código	Qué hace
Responsa a este email %%=Now()=%%.	Agrega las fecha de envío a un email.

Ejemplo de formato de divisa

Puede especificar el formato de un campo de decimal en una extensión de datos para reflejar la divisa.

Código	Qué hace
Importe adeudado: %%=Format(@price, "C", 'en-US')=%%	Actualiza el precio de un producto para reflejar el formato apropiado para divisa de EE.UU.

Limpieza de datos

También puede manipular texto incluido en una variable para su mensaje.

Código	Qué hace
%%=ProperCase(FullName)=%%	Propercase: Devuelve cadena especificada con la letra inicial de cada palabra en mayúscula.
%%=Lowercase(FavoriteColor)=%%	Minúscula: Devuelve el valor en letras minúsculas.
%%=Uppercase(FirstName)=%%	Mayúscula: Devuelve el valor en letras mayúsculas.
%%=Format(Now(), "YYYY")=%%	Formato: Devuelve el valor de acuerdo con la “cadena” que especifica. Esto se puede utilizar para manipular datos, por ejemplo, un año en un pie de página de copyright.

Actualizaciones de idioma

Puede cambiar un saludo basándose en el lenguaje preferido de un cliente. Esta función utiliza comandos if, elseif, endif. Este es un ejemplo utilizando una etiqueta de AMPscript. 

Código	Qué hace
<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>	Si el idioma de un cliente se identifica como FR (Francés), el saludo se muestra como ¡Bonjour! Si el idioma de un cliente se identifica como SP (Español), el saludo se muestra como ¡Hola! Si el idioma de un cliente se establece como nada más (o no proporcionado)

Aún más ejemplos

Finalmente, estos son algunos comandos adicionales que puede utilizar.

Código	Qué hace
%%=Empty(@variable)=%%	Vacío: Devuelve verdadero si el valor es una cadena vacía o nulo. Puede utilizar esto para un valor que puede ser desconocido o nulo, como si el suscriptor tiene mascotas o no.
%%=Concat(@firstname," ",@lastname)=%%	Concat: Concatena o vincula elementos juntos. Por ejemplo, puede utilizar concat para mostrar un nombre completo, incluso si almacenó Nombre y Apellido por separado en sus datos.
%%=RedirectTo(@samplelink)=%%	RedirectTo:  Esta función redirige un usuario a una URL especificado.
/*Are you still reading this table?*/ (¿Aún está leyendo esta tabla?)	Comentarios: Describa qué está haciendo su código para el beneficio de otros, y para su propia referencia.

Uso de AMPscript en mensajes de email

Ahora seamos prácticos. ¿A dónde van estos prácticos ejemplos de nuevo código? ¿Solo puede pegarlos en cualquier parte en su email? No exactamente. Volvamos a nuestro ejemplo que combina cadenas de personalización y AMPscript en línea para mostrar cómo puede utilizar AMPscript en Content Builder. AMPscript en línea se puede agregar en la mayoría de tipos de bloque en Content Builder. 

 Veamos un repaso rápido acerca de la creación de un bloque de contenido con formato libre. 

1. Navegue a Content Builder.
2. Haga clic en Crear, luego Bloques de contenido y a continuación Formato libre desde el menú desplegable.
3. Ingrese texto, incluyendo AMPscript en línea.

Nota importante: Los bloques o las etiquetas de AMPscript solo se pueden utilizar en Fragmento de código o bloques de contenido HTML. Simplemente ingrese su AMPscript en el bloque de contenido y haga clic en Finalizar modificación.

En la siguiente unidad, llevaremos su aprendizaje un poco más allá, al usar variables y funciones de búsqueda para extraer datos en sus mensajes de email desde varias fuentes de datos. 

Recursos

• Documentación del desarrollador: Primeros pasos con el desarrollo de AMPscript - Lección 1
• Trailhead: Funciones de Content Builder