Búsqueda

[Manual] Mostrar u ocultar contenido en tus emails mediante declaraciones if

Brevo ofrece dos métodos para mostrar u ocultar contenido en tus emails: mediante la funcionalidad Visibilidad del contenido en el editor Drag and Drop de email o escribiendo declaraciones if manualmente.
Este artículo abarca el método manual. Si prefieres la funcionalidad Visibilidad del contenido, consulta nuestro artículo dedicado Mostrar u ocultar contenido en tus emails (Visibilidad del contenido).

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, según condiciones específicas.

Puedes definir condiciones de declaración if según diferentes criterios:

  • Atributos de contacto
    Muestra u oculta secciones de tu email según los valores almacenados en los atributos de contacto. Por ejemplo, puedes mostrar un mensaje solo para VIP a los contactos con el atributo Status (Estado) establecido como "VIP".
  • Datos del evento
    Personaliza el contenido en función de las acciones que tus contactos hayan realizado (o no). Por ejemplo, podrías mostrar un bloque promocional solo a los contactos que nunca hayan realizado un pedido.
  • Feeds de datos
    Personaliza el contenido utilizando datos en tiempo real de los feeds externos. Por ejemplo, puedes mostrar recomendaciones de productos personalizadas, precios en directo o información localizada de la tienda basada en datos externos.
  • Feeds de productos
    Personaliza el contenido utilizando la información del producto de tu sitio web de ecommerce. Por ejemplo, puedes mostrar tus productos más vendidos o recomendaciones de productos personalizadas.

¿Qué es una declaración if?

Una declaración if es una regla condicional que decide si se muestra determinado contenido en función de una condición especificada. En las plantillas de email, las declaraciones if te permiten mostrar u ocultar contenido dinámicamente según los datos del destinatario, haciendo que tus emails sean más específicos y personalizados.

Por ejemplo, los emails siguientes se envían desde la misma plantilla pero muestran contenido diferente según los datos del destinatario:

show_hide_content_example1_en-us.png show_hide_content_example2_en-us.png

Aquí tiene algunos ejemplos:

  • Saludos personalizados
    Muestra "Hola Sr. X" para hombres, "Hola Sra. Y" para mujeres o simplemente "Hola" si falta el nombre o el género.
  • Imágenes o promociones específicas
    Muestra una imagen de una modelo con la talla de ropa preferida del destinatario o un producto de su color favorito.
  • Mensajes promocionales personalizados
    Incluye ofertas especiales en emails transaccionales basados en compras anteriores u otros atributos de contacto.

Estructura y sintaxis de una declaración if

Una declaración if debe seguir reglas específicas de estructura y sintaxis:

  • La declaración comienza con una etiqueta if, seguida de una condición: {% if ... %}. 
  • De forma opcional, puedes incluir:
    • Condiciones alternativas, que se evalúan en secuencia. Estos comienzan con {% elif ... %}. 
    • Una cláusula general justo antes del final de la declaración con {% else %}.
  • Cada declaración if debe terminar con {% endif %}.

Formas habituales de crear una declaración if

💡 Información relevante
Evita utilizar una declaración if en variables que contengan valores flotantes, ya que es posible que no produzcan resultados precisos. No obstante, puedes aplicar una declaración si el valor flotante se pasa como una cadena (entre comillas, por ejemplo, "3.14").

A continuación se muestran algunas formas habituales de crear una declaración if y mostrar u ocultar contenido en sus emails según condiciones específicas:

if

Comprueba si un valor es verdadero o si una matriz contiene elementos (es decir, no está vacía).

Ejemplo 1

Sintaxis 
{% if condition %}
     Añade el contenido para mostrar si el valor es verdadero o una matriz contiene elementos
{% endif %}
Ejemplo de entrada 
{% if contact.active %}
     ¡Enhorabuena! Has logrado tu objetivo este mes.
{% endif %}
Ejemplo de salida
El valor es verdadero o la matriz contiene elementos El valor es falso o la matriz está vacía

¡Enhorabuena! Has logrado tu objetivo este mes.

El contenido está oculto

Ejemplo 2

Sintaxis 
{% if condition %}
{% for loop %}
     Añade el contenido al bucle si el valor es verdadero o una matriz contiene elementos
{% endfor %}
{% endif %}
Ejemplo de entrada 
{% if params.tutors %}
Los siguientes tutores están disponibles para ayudarte:
{% for tutor in params.tutors %}
     {{ tutor.name }}
{% endfor %}
{% endif %}
Ejemplo de salida
El valor es verdadero o la matriz contiene elementos El valor es falso o la matriz está vacía

Los siguientes tutores están disponibles para ayudarte:

Abby Smith

James Doe

Peter Parker

El contenido está oculto

==

Comprueba si una expresión es verdadera.

Ejemplo 1

Sintaxis 
{% if condition == "value" %}
     Añade el contenido para mostrar si la expresión es verdadera
{% endif %}
Ejemplo de entrada 
{% if coupon == "WELCOME" %}
     ¡Te damos la bienvenida a nuestra lista! Aquí tienes tu primer cupón: WELCOME25
{% endif %}
Ejemplo de salida
La expresión es verdadera La expresión es falsa

¡Te damos la bienvenida a nuestra lista! Aquí tienes tu primer cupón: WELCOME25

El contenido está oculto

Ejemplo 2

Sintaxis 
{% if condition == true %}
     Añade el contenido para mostrar si la expresión es verdadera
{% endif %}
Ejemplo de entrada 
{% if contact.donor == true %}
     ¡Gracias por tu apoyo!
{% endif %}
Ejemplo de salida
La expresión es verdadera La expresión es falsa

¡Gracias por tu apoyo!

El contenido está oculto

if, in

Comprueba si un valor (subcadena) está presente dentro de una cadena o si una variable se encuentra dentro de una matriz.

Ejemplo 1

Sintaxis 
{% if "value" in condition %}
     Añade el contenido para mostrar si un valor está presente dentro de una cadena o
     si se encuentra una variable dentro de una matriz
{% endif %}
Ejemplo de entrada 
{% if "recent" in customer.last_purchase_status %}
     ¡Gracias por tu reciente compra! Esperamos que te gusten tus nuevos artículos.
{% endif %}
Ejemplo de salida
El valor está presente dentro de una cadena o la variable se encuentra dentro de una matriz No hay ningún valor presente dentro de una cadena o no se encuentra ninguna variable dentro de una matriz

¡Gracias por tu reciente compra! Esperamos que te gusten tus nuevos artículos.

El contenido está oculto

Ejemplo 2

Sintaxis 
{% if "value" in condition %}
     Añade el contenido para mostrar si un valor está presente dentro de una cadena o
     si se encuentra una variable dentro de una matriz
{% endif %}
Ejemplo de entrada 
{% if "fragile" in params.type %}
     ¡Manipúlelo con cuidado! Hay uno o más artículos frágiles en tu pedido.
{% endif %}
Ejemplo de salida
El valor está presente dentro de una cadena o la variable se encuentra dentro de una matriz No hay ningún valor presente dentro de una cadena o no se encuentra ninguna variable dentro de una matriz

¡Manipúlelo con cuidado! Hay uno o más artículos frágiles en tu pedido.

El contenido está oculto

not

Comprueba si un valor es falso.

Ejemplo 1

Sintaxis 
{% if not condition %}
     Añade el contenido que se mostrará si un valor es falso
{% endif %}
Ejemplo de entrada 
{% if not user.subscribed %}
    No estás suscrito a nuestras alertas de venta secreta. Regístrate aquí.
{% endif %}
Ejemplo de salida
El valor es falso El valor es verdadero

No estás suscrito a nuestras alertas de venta secreta. Regístrate aquí.

El contenido está oculto

and / or

Comprueba múltiples condiciones.

Ejemplo 1

Sintaxis 
{% if condition1 and condition2 %}
     Añade el contenido que se mostrará si todas las condiciones son verdaderas
{% endif %}
Ejemplo de entrada 
{% if temperature > 10 and temperature < 55 %}
     Brr. ¡Hace frío! Aquí tienes un cupón de 20 % de descuento en cualquier bebida caliente, solo por hoy.
{% endif %}
Ejemplo de salida
Todas las condiciones son verdaderas Al menos una de las condiciones no es verdadera

Brr. ¡Hace frío! Aquí tienes un cupón de 20 % de descuento en cualquier bebida caliente, solo por hoy.

El contenido está oculto

Ejemplo 2

Sintaxis 
{% if condition1 == "value" and condition2 == "value" %}
     Añade el contenido que se mostrará si todas las condiciones son verdaderas
{% endif %}
Ejemplo de entrada 
{% if contact.lang == "FR" and contact.country == "Canada" %}
     À l'occasion de la fête du Canada ce 1er juillet 2024, profitez de 10 % 
     de réduction supplémentaires dans nos enseignes canadiennes !
{% endif %}
Ejemplo de salida
Todas las condiciones son verdaderas Al menos una de las condiciones no es verdadera

À l'occasion de la fête du Canada ce 1er juillet 2024, profitez de 10 % de réduction supplémentaires dans nos enseignes canadiennes !

El contenido está oculto

Ejemplo 3

Sintaxis 
{% if condition1 == "value" or condition2 == "value" %}
     Añade el contenido que se mostrará si al menos una de las condiciones es verdadera
{% endif %}
Ejemplo de entrada 
{% if contact.country == "United States" or contact.country == "Canada" %}
     ¡Gracias por comprar con nosotros! ¡Disfruta de envío gratis en pedidos superiores a 50 $
     en Estados Unidos y Canadá.  
{% endif %}
Ejemplo de salida
Al menos una de las condiciones es verdadera Ninguna de las condiciones es verdadera

¡Gracias por comprar con nosotros! Envío gratis en pedidos superiores a 50 $ en Estados Unidos y Canadá.

El contenido está oculto

elif, else

Comprueba varias ramas.

Ejemplo 1

Sintaxis 
{% if condition1 == "value" %}

         Añade el contenido que se mostrará si condition1 es verdadera
            
{% elif condition2 == "value" %}

        Añade el contenido que se mostrará si condition2 es verdadera

          {% else %} 

        Añade el contenido que se mostrará si ninguna de las condiciones es verdadera
          
{% endif %}
Ejemplo de entrada 
Hello 
{% if contact.gender == "Male" %}
Mr. {{ contact.lastname }},
{% elif contact.gender == "Female" %}
Ms. {{ contact.lastname }},
{% else %}
there,
{% endif %}
Ejemplo de salida
Condition1 es verdadera Condition2 es verdadera Ninguna de las condiciones es verdadera

Hola, Sr. Smith:

Hola, Sra. Jones:

Hola, qué tal:

Ejemplo 2

Sintaxis 
{% if condition1 == "value" %}
Añade el contenido que se mostrará si condition1 es verdadera
{% elif condition2 == "value" %}
Añade el contenido que se mostrará si condition2 es verdadera
{% else %}
Añade el contenido que se mostrará si ninguna de las condiciones es verdadera
{% endif %}
Ejemplo de entrada 
{% if "express" in params.shipping_method %}
¡Tu pedido se enviará mediante envío exprés! Espera a que llegue 
en 1-2 días laborables.
{% elif "standard" in params.shipping_method %}
Tu pedido está en camino con envío estándar. Debería llegar 
en 3-5 días laborables.
{% else %}
Tu pedido se está procesando. Pronto te actualizaremos con los detalles de seguimiento.
{% endif %}
Ejemplo de salida
Condition1 es verdadera Condition2 es verdadera Ninguna de las condiciones es verdadera

¡Tu pedido se enviará mediante envío exprés! Espera a que llegue en 1-2 días laborables.

Tu pedido está en camino con envío estándar. Debería llegar en 3-5 días laborables.

Tu pedido se está procesando. Pronto te actualizaremos con los detalles de seguimiento.

⏭️ ¿Qué es lo siguiente?

🤔 ¿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.

💬 ¿Fue útil este artículo?

Usuarios a los que les pareció útil: 12 de 26