Cómo Usar Expresiones Matemáticas en las plantillas de Email Usando VTL
DANAconnect permite a los usuarios crear emails dinámicos con lógica avanzada utilizando Velocity Template Language (VTL). Una de las funcionalidades más útiles es la capacidad de realizar expresiones matemáticas dentro de tus plantillas de email. Esto te permite personalizar aún más tus mensajes, calculando totales, aplicando descuentos o realizando otras operaciones numéricas directamente en el contenido del correo electrónico.
Las expresiones matemáticas te permiten realizar cálculos directamente dentro del contenido de tu email. Por ejemplo, puedes sumar, restar, multiplicar o dividir variables para mostrar resultados personalizados, como el total de una compra o la aplicación de un descuento.
- Personalización avanzada: Puedes adaptar el contenido del email según los cálculos personalizados de cada destinatario, como mostrar el total de una compra o aplicar descuentos específicos.
- Automatización: Las expresiones matemáticas te permiten automatizar cálculos sin tener que hacer ajustes en la información de cada contacto, ahorrando tiempo y esfuerzo.
- Flexibilidad: Con VTL, puedes hacer operaciones simples o más complejas, dependiendo de tus necesidades.
Puedes usar expresiones matemáticas en emails cuando necesitas:
- Calcular el total de una lista de montos.
- Aplicar descuentos personalizados.
- Mostrar una cantidad basada en la combinación de varios valores.
- Realizar conversiones de moneda o unidades.
Para insertar y usar expresiones matemáticas en tus plantillas de email en DANAconnect, sigue estos pasos:
Accede al Conversation Manager y selecciona el nodo de email donde desees incluir las expresiones matemáticas.
Haz clic en el botón de bloques (Blocks) para abrir el "Block Properties". Esto te permitirá insertar el código VTL necesario para realizar las operaciones matemáticas en tu plantilla de email.
Una vez dentro del bloque, puedes escribir la operación matemática que desees realizar. Aquí te mostramos un ejemplo de cómo hacerlo correctamente. Las variables que se llenan con datos de la lista de contactos deben seguir el formato $s{variable}, mientras que las variables que contienen los resultados de los cálculos deben usar el formato $variable, ya que no provienen de la lista de contactos sino que se calculan en tiempo real.
Si tienes variables como el precio y la cantidad, puedes calcular el total de la siguiente manera:
Si deseas aplicar un descuento del 10% a un precio original, puedes hacerlo de la siguiente manera:
Si necesitas sumar varias cantidades, puedes hacer algo como esto:
Las variables que utilizas en estas operaciones matemáticas, como $s{precio} y $s{cantidad}, están vinculadas a los campos numéricos en la lista de contactos. Cada destinatario del email recibirá valores específicos basados en los datos que estén asociados con esos campos en la base de contactos de DANAconnect.
Por ejemplo:
- $s{precio} puede estar vinculado a un campo en la lista de contactos que almacena el precio de un producto para cada cliente.
- $s{cantidad} puede estar vinculado a la cantidad de productos que ese cliente ha comprado.
Esto te permite realizar cálculos personalizados de manera automática para cada destinatario del email.
Los resultados de las operaciones, como $precio_total o $total, son variables calculadas y no provienen directamente de la lista de contactos, por lo que deben utilizar el formato $variable.
Una vez que hayas insertado el código y realizado las operaciones matemáticas necesarias, guarda la plantilla de email y realiza una prueba para asegurarte de que los cálculos se realicen correctamente y que los resultados se muestren tal como esperas.
¿Qué son las Expresiones Matemáticas en VTL?
Las expresiones matemáticas te permiten realizar cálculos directamente dentro del contenido de tu email. Por ejemplo, puedes sumar, restar, multiplicar o dividir variables para mostrar resultados personalizados, como el total de una compra o la aplicación de un descuento.
Beneficios de Usar Expresiones Matemáticas en Emails
- Personalización avanzada: Puedes adaptar el contenido del email según los cálculos personalizados de cada destinatario, como mostrar el total de una compra o aplicar descuentos específicos.
- Automatización: Las expresiones matemáticas te permiten automatizar cálculos sin tener que hacer ajustes en la información de cada contacto, ahorrando tiempo y esfuerzo.
- Flexibilidad: Con VTL, puedes hacer operaciones simples o más complejas, dependiendo de tus necesidades.
¿Cuándo Usar Expresiones Matemáticas en Emails?
Puedes usar expresiones matemáticas en emails cuando necesitas:
- Calcular el total de una lista de montos.
- Aplicar descuentos personalizados.
- Mostrar una cantidad basada en la combinación de varios valores.
- Realizar conversiones de moneda o unidades.
Cómo Implementar Expresiones Matemáticas en un Email Usando el Botón de Bloques
Para insertar y usar expresiones matemáticas en tus plantillas de email en DANAconnect, sigue estos pasos:
Paso 1: Acceder al Editor de Email
Accede al Conversation Manager y selecciona el nodo de email donde desees incluir las expresiones matemáticas.
Haz clic en el botón de bloques (Blocks) para abrir el "Block Properties". Esto te permitirá insertar el código VTL necesario para realizar las operaciones matemáticas en tu plantilla de email.
Paso 2: Insertar el Código de Expresión Matemática
Una vez dentro del bloque, puedes escribir la operación matemática que desees realizar. Aquí te mostramos un ejemplo de cómo hacerlo correctamente. Las variables que se llenan con datos de la lista de contactos deben seguir el formato $s{variable}, mientras que las variables que contienen los resultados de los cálculos deben usar el formato $variable, ya que no provienen de la lista de contactos sino que se calculan en tiempo real.
Ejemplo 1: Calcular el Total de una Compra
Si tienes variables como el precio y la cantidad, puedes calcular el total de la siguiente manera:
<block name="mathBlock">#set($precio_total = $s{precio} * $s{cantidad})</block>
El total de su compra es: <block name="precioTotal">$precio_total</block>Ejemplo 2: Aplicar un Descuento
Si deseas aplicar un descuento del 10% a un precio original, puedes hacerlo de la siguiente manera:
<block name="mathBlock">#set($precio_con_descuento = $s{precio_original} * 0.9)</block>
El precio con descuento es: <block name="precioDescuento">$precio_con_descuento</block>Ejemplo 3: Sumar Diferentes Cantidades
Si necesitas sumar varias cantidades, puedes hacer algo como esto:
<block name="mathBlock">#set($total = $s{cantidad1} + $s{cantidad2} + $s{cantidad3})</block>
El total de las cantidades es: <block name="total">$total</block>Datos en la Lista de Contactos
Las variables que utilizas en estas operaciones matemáticas, como $s{precio} y $s{cantidad}, están vinculadas a los campos numéricos en la lista de contactos. Cada destinatario del email recibirá valores específicos basados en los datos que estén asociados con esos campos en la base de contactos de DANAconnect.
Por ejemplo:
- $s{precio} puede estar vinculado a un campo en la lista de contactos que almacena el precio de un producto para cada cliente.
- $s{cantidad} puede estar vinculado a la cantidad de productos que ese cliente ha comprado.
Esto te permite realizar cálculos personalizados de manera automática para cada destinatario del email.
Los resultados de las operaciones, como $precio_total o $total, son variables calculadas y no provienen directamente de la lista de contactos, por lo que deben utilizar el formato $variable.
Paso 3: Guardar y Probar
Una vez que hayas insertado el código y realizado las operaciones matemáticas necesarias, guarda la plantilla de email y realiza una prueba para asegurarte de que los cálculos se realicen correctamente y que los resultados se muestren tal como esperas.
Actualizado el: 09/10/2024
¡Gracias!