Referencia lógica condicional para plantillas

Qué aprenderás

Conoce todas las condiciones disponibles que puedes utilizar para mostrar dinámicamente un bloque, sección o contenido personalizado sólo a determinados destinatarios. Para aprender a utilizar estas condiciones en tu plantilla, dirígete a nuestro artículo sobre cómo mostrar u ocultar la plantilla bloque 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

Puedes utilizar condiciones en: 

• Correos electrónicos
  • Crea una lógica de mostrar/ocultar para mostrar dinámicamente bloques o secciones sólo a determinadas personas. 
    • Si prefiere no escribir código, utilice en su lugar el constructor lógico de mostrar/ocultar. 
  • Escribe condicionales if/else para crear sentencias Django personalizadas.
• Centro de Clientes Klaviyo
  • Escribe condicionales if/else para crear sentencias Django personalizadas en el bloque de contenido

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úrate de tener en cuenta a todos los posibles espectadores. Por ejemplo, si muestras un bloque específico sólo a los residentes de un determinado estado, cubre todas las grafías posibles del nombre de ese estado (por ejemplo, Massachusetts, massachusetts, mass, MA). Ten en cuenta también el perfil que puede no tener la propiedad fijada en absoluto.

Una vez que hayas construido el mensaje y aplicado tus condiciones, haz una vista previa utilizando diversos perfiles para confirmar que el mensaje se muestra como pretendías en todos los escenarios. 

Estructuras de condición

Las condiciones deben incluir de 1 a 3 elementos, dependiendo de tu objetivo para el bloque y de los datos que estés 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 el valor de una propiedad que hay que buscar. Además, algunas condiciones empiezan por no, si quieres 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