Referencia lógica condicional para plantillas

Qué aprenderás

Conozca todas las condiciones disponibles que puede utilizar para mostrar dinámicamente un bloque, una sección o un contenido personalizado en una plantilla de correo electrónico sólo a determinados destinatarios. Para aprender a utilizar estas condiciones en sus plantillas, diríjase a Cómo mostrar u ocultar bloques de plantilla en función de variables dinámicas. 

Aprenda a utilizar la lógica condicional:

• Dónde puede utilizar las condiciones
• Consejos para el éxito
• Estructuras de condición
• Construir condiciones complejas

Dónde puede utilizar las condiciones

Puede utilizar condiciones: 

• En la lógica mostrar/ocultar, para mostrar dinámicamente correo electrónico plantilla bloque o secciones sólo a determinados destinatarios. 
  • Si prefiere no escribir código, utilice en su lugar el constructor lógico de mostrar/ocultar. 
• Dentro de los condicionales if/else para escribir sentencias Django personalizadas.

Consejos para el éxito

Cuando construya las condiciones de mostrar/ocultar, preste atención a los detalles. Las condiciones de mostrar/ocultar distinguen entre mayúsculas y minúsculas, y la ortografía debe coincidir exactamente con los datos de su perfil o evento. 

Además, asegúrese de tener en cuenta a todos los posibles destinatarios de su correo electrónico. Por ejemplo, si muestra un bloque específico sólo a los residentes de un determinado estado, cubra todas las grafías posibles del nombre de ese estado (por ejemplo, Massachusetts, massachusetts, mass, MA). Tenga también en cuenta los perfiles que pueden no tener la propiedad fijada en absoluto.

Una vez que haya construido el mensaje y aplicado sus condiciones, previsualice el correo electrónico utilizando diversos perfiles para confirmar que el mensaje se muestra como usted pretendía en todos los escenarios. 

Estructuras de condición

Las condiciones deben incluir de 1 a 3 elementos, dependiendo de su objetivo para el bloque y de los datos que esté utilizando. La condición debe incluir al menos una variable (por ejemplo, persona|lookup:'Color favorito'). También puede incluir una función de comparación, como = (igual) o > (mayor que) y un valor, que especifica un valor de propiedad concreto que buscar. Además, algunas condiciones empiezan por no, si desea que el bloque sólo aparezca para los perfiles que no cumplan una condición. 

El siguiente cuadro contiene una lista completa de las posibles estructuras que puede seguir una condición de mostrar/ocultar. 

Condiciones para booleanos

Si está haciendo referencia a datos almacenados como un booleano, tendrá que utilizar 1 y 0 en lugar de "verdadero" y "falso" en la definición de su condición de mostrar/ocultar. No encierre el 1 o el 0 entre comillas. Utilice las condiciones de muestra que figuran a continuación como plantilla.

Condiciones para booleanos almacenados como texto

Si sus datos verdadero/falso se almacenan como texto, no como booleano, utilice las condiciones de ejemplo para propiedades de texto anteriores. Si no está seguro, o si hace referencia a una propiedad que contiene tanto booleanos como texto, puede utilizar estas estructuras para cubrir todos los escenarios. Incluya todas las grafías y mayúsculas presentes en sus datos. 

Construir condiciones complejas

Si desea que su bloque se muestre a personas que cumplan varios criterios, o si tiene un caso de uso complejo, puede utilizar varias condiciones de mostrar/ocultar para un bloque. Para ello, conecte una serie de condiciones con AND u OR. Por ejemplo, si desea mostrar un bloque a cualquier persona que se encuentre en Massachusetts, pero Massachusetts se escribe de forma diferente en algunos perfiles, puede utilizar una condición como ésta: 

person.location.region == 'Massachusetts' or person.location.region == 'massachusetts' or person.location.region == 'mass' or person.location.region == 'MA'

Si sólo quiere mostrar un bloque a las personas cuyo color favorito sea el verde y que además sean VIP, puede utilizar una condición como ésta: 

persona|lookup:'Color Favorito' == 'verde' y persona|lookup:'VIP'== 1

Sentencias condicionales y el editor de texto en línea

Cuando añada determinadas sentencias condicionales a un bloque de texto, es posible que desaparezcan del editor de texto en línea. El código sigue presente; sólo está oculto. Para ver y editar las sentencias condicionales, abra el campo Código fuente del bloque de texto. 

Las siguientes etiquetas sólo son visibles en el campo Código fuente de un bloque de texto: 

• {% for ... %}
• {% endfor %}
• {% if ... %}
• {% elif ... %}
• {% else %}
• {% endif %}
• {% with ... %}
• {% endwith %}

Recursos adicionales

• Cómo mostrar u ocultar bloques de plantilla en función de variables dinámicas
• Referencia de personalización del mensaje 
• Guía de perfiles en Klaviyo 
• Glosario de filtros variables