Utiliza el lenguaje de plantillas de Brevo para personalizar tus mensajes con datos específicos de contactos o eventos, ocultar o mostrar contenido a destinatarios específicos y ajustar cómo se formatean los valores en tus mensajes.

💬 Variables

Las variables, también conocidas como marcadores de posición o etiquetas personalizadas, son etiquetas que puedes insertar en tus mensajes para personalizarlos. Cuando envías un mensaje, cada variable se reemplaza automáticamente con la información del contacto correspondiente.

En el lenguaje de plantillas de Brevo, las variables deben estar entre llaves dobles, como {{ ... }} o {{...}}. Se pueden utilizar para inserciones simples o combinarse con declaraciones condicionales y filtros para una personalización avanzada.

El lenguaje de plantillas de Brevo admite diferentes tipos de variables:

👤 Variables de contacto

Las variables de contacto te permiten mostrar datos de tus atributos de contacto, como el nombre de un contacto, en tus mensajes. Estas variables tienen el formato {{ contact.ATTRIBUTE }}, donde debes reemplazar ATTRIBUTE por el nombre exacto de tu atributo de contacto tal y como aparece en la página Contact attributes (Atributos de contacto) en tu cuenta de Brevo. Puedes utilizar tanto los atributos predeterminados de Brevo como los atributos personalizados.

A continuación se muestran algunos ejemplos de variables de contacto con tres atributos predeterminados de Brevo y un atributo personalizado:

➡️ Para obtener más información sobre los diferentes tipos de atributos de contacto disponibles y cómo crearlos personalizados, consulta nuestros artículos dedicados:

• Información sobre los atributos de contacto
• Crear y gestionar atributos de contacto

🔗 Variables de enlace y vista previa de email

Las variables de enlace y vista previa de email permiten a los destinatarios ver tu email en su navegador, darse de baja de tus comunicaciones y administrar sus preferencias. Estas variables deben colocarse dentro de una etiqueta HTML <a> , envolviendo el texto que se mostrará en el email.

Las siguientes variables de enlace y vista previa de email están disponibles:

➡️ Para obtener más información, consulta nuestros artículos al respecto:

• Insertar un enlace "Ver en el navegador" en las campañas
• Insertar un enlace de cancelación de suscripción en tus campañas
• Actualizar sus datos y preferencias de contactos (formulario de actualización de perfil)
• Crear una plantilla de email personalizada de confirmación doble para un formulario de suscripción creado en Brevo

📅 Variables de fecha

Las variables de fecha te permiten insertar una marca de tiempo de la fecha y hora exactas en que se envió un email. La fecha se basa en la zona horaria de tu cuenta de Brevo. Si no hay una zona horaria configurada en tu cuenta, la variable tendrá como valor predeterminado la marca de tiempo actual en UTC. 

La siguiente variable de fecha está disponible:

➡️ Para obtener más información sobre cómo ajustar el formato de las fechas, consulta nuestro artículo dedicado Modificar el formato de tu marcador de posición con filtros.

⚡ Variables de evento

Las variables de evento te permiten mostrar datos de eventos específicos activados por las acciones de un contacto, como el precio del último artículo comprado o el nombre de la reunión que reservó.

Para identificar las variables de evento para tu mensaje, comprueba tu API de llamada o los logs de eventos en Brevo. A continuación se muestra un ejemplo de una estructura JSON típica, donde:

data es el objeto raíz que contiene las siguientes propiedades: id → El ID del carrito total → El importe total del carrito currency → El tipo de divisa url → Un enlace al carrito items son un conjunto de productos en el carrito, cada uno de los cuales contiene las siguientes propiedades: name → Nombre del producto price → Precio del producto url → URL de la página del producto image → URL de la imagen del producto

A las variables de evento se les aplica formato mediante llaves dobles. Cada dato en la estructura JSON se puede incluir en una variable de evento para personalizar tus mensajes:

{% for item in params.items %}
{{ item.name }}
{% endfor %}

🛢️ Variables de feed de datos

Las variables de feed de datos te permiten personalizar tus comunicaciones de marketing enviadas con Brevo con la información más reciente sobre productos, clientes, eventos o cualquier otro dato relevante de tu fuente de datos externa o API. Úsalas para automatizar y personalizar tus mensajes con datos en tiempo real. 

Para identificar las variables de feed de datos para tu mensaje, haz clic en el menú desplegable Account (Cuenta) y seleccione Settings (Configuración) > Data management (Gestión de datos) > Data feeds (Feeds de datos) para comprobar la estructura de tu archivo de fuente en Brevo:

A las variables de feed de datos se les aplica formato mediante llaves dobles. Según la complejidad de la estructura de tu feed de datos, el formato de las variables de tu feed de datos varía: 

{% for item in feed.yoga_classes.following_classes %}
{{ item.class_name }}
{% endfor %}

🛒 Variables del feed de productos

Las variables de feed de productos te permiten mostrar una lista dinámica de productos de tu tienda online, lo que facilita la creación de recomendaciones personalizadas. Contiene detalles del producto como nombre, descripción, precios, imágenes y disponibilidad. Utilízalos para mostrar artículos populares, personalizar recomendaciones o mantener visualizaciones de productos uniformes en tus campañas de marketing.

A las variables de feed de productos se les aplica formato mediante llaves dobles:

{{ feed.feedalias.products.variable }}

Acto seguido, debes reemplazar:

• feedalias es el nombre exacto de tu feed de productos, y coincide con la ortografía y las mayúsculas y minúsculas tal y como aparece en la página Product feeds (Feeds de productos).
• variable es el nombre del campo en la API que contiene los datos que quieres recuperar.

Entrada	Descripción	Resultado
{{feed.mats_bestseller.products.imageUrl}}	Imagen del producto
{{feed.mats_bestseller.products.name}}	Nombre del producto	Esterilla de yoga antideslizante - 6 mm
{{feed.mats_bestseller.products.url}}	Enlace al producto	https://thegreenyoga.com/non-slip/black-mat.html

Mostrar todos los elementos mediante un bucle for

Utiliza un bucle for para mostrar todos los elementos de una matriz de forma dinámica. En lugar de hacer referencia manualmente a cada índice, el bucle itera a través de la matriz y muestra cada elemento automáticamente. Esto resulta especialmente útil cuando se desconoce el número de elementos de la matriz, como en el caso de una lista de publicaciones semanales en un blog o un recibo de productos comprados.

Por ejemplo, si queremos mostrar el nombre de cada artículo en el feed de productos mats_bestseller, el bucle for correspondiente sería:

{% for item in feed.mats_bestseller.products %}
{{ item.name }}
{% endfor %}

➡️ Para obtener más información sobre los bucles for, consulta nuestro artículo dedicado [Manual] Repetir un bloque de elementos en los emails mediante bucles for.

📢 Declaraciones condicionales

👀 Visualización condicional (declaraciones if)

Utiliza una declaración if para mostrar u ocultar partes de tu email en función de los datos de cada destinatario. Esto te permite enviar un único email que se adapta dinámicamente a diferentes contactos, dependiendo de condiciones específicas.

➡️ Para obtener más información sobre la declaración if, consulta nuestro artículo dedicado [Manual] Mostrar u ocultar contenido en tus emails mediante declaraciones if.

🔁 Secciones repetibles (bucles for)

Utiliza un bucle for para mostrar todos los elementos de una matriz de forma dinámica. En lugar de hacer referencia manualmente a cada índice, el bucle itera a través de la matriz y muestra cada elemento automáticamente. Esto resulta especialmente útil cuando se desconoce el número de elementos de la matriz, como en el caso de una lista de publicaciones semanales en un blog o un recibo de productos comprados.

➡️ Para obtener más información sobre los bucles for, consulta nuestro artículo dedicado [Manual] Repetir un bloque de elementos en los emails mediante bucles for.

🪄 Filtros

Los filtros modifican la salida de una variable transformando su valor. Se colocan dentro de los corchetes dobles de la variable y se separan por una barra vertical |, por ejemplo, {{ contact.FIRSTNAME|upper }}. También puedes encadenar varios filtros y que cada uno aplique su transformación al resultado del anterior.

A continuación se muestran algunos ejemplos de variables utilizadas junto con filtros para modificar su salida:

➡️ Para obtener más información, consulta nuestro artículo dedicado Modificar el formato del marcador de posición con filtros.

🤔 ¿Tiene alguna duda?

Si tiene alguna pregunta, no dude en ponerse en contacto con nuestro equipo de asistencia mediante la creación de un ticket desde su cuenta. Si todavía no tiene una cuenta, puede ponerse en contacto con nosotros aquí.

Si necesitas ayuda con un proyecto usando Brevo, podemos ponerte en contacto con la agencia partner de Brevo adecuada.