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> |
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> |
|
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.
¿Necesita un repaso en Content Builder? Revise el módulo de Trailhead, Funciones de Content Builder.
Veamos un repaso rápido acerca de la creación de un bloque de contenido con formato libre.
- Navegue a Content Builder.
- Haga clic en Crear, luego Bloques de contenido y a continuación Formato libre desde el menú desplegable.
- 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.
