Cómo añadir lógica condicional a plantillas de email con el generador de lógica

Qué aprenderás

Aprende a usar el generador de lógica para añadir lógica condicional dinámica (como las declaraciones if/else y los bucles for) directamente a los bloques de texto de las plantillas de email. Esto permite mostrar contenido personalizado a distintos destinatarios en función de su perfil o propiedades personalizadas, sin escribir código.

Antes de empezar

El generador de lógica está disponible en:

• Editor de email de arrastrar y soltar — bloques de texto, bloques de tablas y bloques de división
• Editor de emails de solo texto (a través de un modal en lugar de un panel lateral)

Para usar el generador de lógica, necesitarás al menos un perfil en la cuenta que tenga la propiedad que quieres evaluar. Los perfiles y las propiedades personalizadas se pueden añadir mediante formularios de registro, cargas de CSV, integraciones de comercio electrónico y otras herramientas de crecimiento de listas.

Nota: el generador de lógica admite propiedades de perfil y propiedades personalizadas. No admite datos de eventos. Para usar datos de eventos en la lógica, usa la opción Convertir a código y escribe directamente etiquetas de Django.

Añadir una instrucción «if/else»

Usa una instrucción «if/else» para mostrar contenido diferente a los destinatarios en función de un perfil o una propiedad personalizada. Por ejemplo, puedes mostrar un bloque de descuento VIP solo a los clientes con más de 500 puntos de fidelización, y un incentivo de registro a todo el mundo.

En el editor de arrastrar y soltar

1. Haz doble clic en un bloque de texto, un bloque de tabla o un bloque de división para entrar en el modo de edición.
2. Haz clic en el botón Insertar en la barra de herramientas en la parte superior de la página.
3. Selecciona Si/si no en el menú desplegable.
   • Se abrirá un panel lateral a la izquierda y el lienzo se desplazará hacia la derecha.
4. Configura la instrucción if:
   • Usa el primer menú desplegable para elegir una propiedad de perfil o personalizada que evaluar.
   • Usa el segundo menú desplegable para seleccionar un operador (p. ej., es igual a, es mayor que, está establecido).
   • Introduce o selecciona un valor con el que comparar, en función del operador elegido.
5. Si quieres, haz clic en Añadir condición para añadir criterios adicionales a la instrucción if.
   • Usa AND u OR para conectar condiciones. OR está seleccionado de forma predeterminada.
   • Haz clic en el botón clonar en una condición para duplicarla como una nueva condición OR.
6. Para añadir una rama si no, si, haz clic en Añadir si no, si y configura las condiciones de la misma manera. Los destinatarios que cumplan estas condiciones (pero no la instrucción if) verán este contenido.
7. Para añadir una rama else, marca la casilla Else (marcada de forma predeterminada). Edita el contenido en el lienzo para definir lo que verán los destinatarios que no cumplan ninguna condición. Desmarca la casilla para eliminar por completo la rama else.
8. Edita el contenido en el lienzo para cada condición. Cada condición aparece como un cuadro azul mientras se configura.
9. Cuando hayas terminado, haz clic en la flecha hacia atrás para cerrar el panel y guardar la lógica.

Consejo: Para eliminar toda la lógica configurada de un bloque, haz clic en Eliminar lógica en el panel lateral.

Nota: al hacer clic en Eliminar en la instrucción if inicial, se restablecerán sus valores en lugar de eliminar la instrucción por completo. Al hacer clic en Eliminar en una rama else if o else, se eliminará esa rama.

En el editor de solo texto

Sigue los mismos pasos anteriores, pero selecciona Insertar en la barra de herramientas de edición de texto. El generador de lógica se abrirá en un modal en lugar de un panel lateral. Están disponibles las mismas opciones de configuración.

Añadir un bucle «for»

Usa un bucle for para iterar por una lista de elementos y mostrar contenido repetido para cada uno. Por ejemplo, puedes recorrer en bucle los productos vistos recientemente por un cliente para mostrar cada uno en el email.

En el editor de arrastrar y soltar

1. Haz doble clic en un bloque de texto, bloque de tabla o bloque de división.
2. Haz clic en el botón Insert en la barra de herramientas.
3. Selecciona bucle for en el menú desplegable.
   • Se abrirá un panel lateral a la izquierda.
4. En el campo Variable, introduce la lista por la que quieres iterar (por ejemplo, event.items).
5. En el campo alias del elemento, introduce un nombre para hacer referencia a cada elemento individual dentro del bucle (p. ej., item).
6. Edita el contenido en el lienzo para definir qué se mostrará para cada elemento.
7. Haz clic en la flecha hacia atrás para cerrar el panel y guardar la lógica.

Consejo: para eliminar el bucle por completo, haz clic en Remove logic en el panel lateral.

Añadir una etiqueta configurable

Usa una etiqueta configurable para insertar etiquetas de Django que no estén cubiertas por los generadores de if/else o bucle for (como las declaraciones with o las etiquetas de catálogo).

1. Haz doble clic en un bloque de texto, bloque de tabla o bloque de división.
2. Haz clic en el botón Insert en la barra de herramientas.
3. Selecciona Etiqueta configurable en el menú desplegable.
   • Se abrirá un panel lateral a la izquierda.
4. En el campo Nombre de la etiqueta, introduce la etiqueta que abrirá y cerrará el bloque (por ejemplo, with).
5. En el área de texto Código, añade tu código de etiqueta de Django personalizada.
6. Para añadir una rama, haz clic en Add branch. Esto crea una sección adicional en la que puedes configurar otro nombre de etiqueta y bloque de código.
7. Haz clic en la flecha hacia atrás para cerrar el panel y guardar la lógica.

Trabajar con lógica anidada

Puedes anidar instrucciones lógicas dentro de otras (por ejemplo, una instrucción if/else dentro de un bucle for). Esto te permite crear secuencias de contenido muy segmentadas.

Cuando la lógica está anidada:

• Los iconos de línea vertical indican el nivel de anidación de cada instrucción lógica.
• Al pasar el cursor por encima de una instrucción principal, se resalta todo el bloque anidado.
• Al pasar el cursor por encima de una instrucción secundaria, se resalta solo esa instrucción.
• Puedes contraer y expandir las declaraciones secundarias de forma independiente de la principal.
• Si se anidan más de tres niveles de lógica, aparece un indicador +[number] para mostrar la profundidad de anidación adicional.

Convertir lógica en código

Si necesitas más control sobre la lógica o quieres usar funciones no compatibles, como datos de eventos o comparaciones de fechas, puedes convertir la configuración del generador de lógica en código Django sin procesar.

Advertencia: Convertir la lógica en código es una acción unidireccional y no se puede deshacer. No podrás volver a cambiar al generador de lógica después de convertirla.

Para convertir:

1. Abre el panel lateral del creador de lógica del bloque que quieras actualizar.
2. En el caso de las declaraciones if/else, cada segmento individual (if, else if) tiene su propio botón Convert to code. Haz clic en el del segmento que quieras convertir.
3. Para los bucles for, haz clic en el único botón Convertir a código para todo el bucle.
4. Aparecerá un modal de advertencia. Confirma que quieres continuar.
5. Después de la conversión, el código convertido aparecerá en un editor de código en el panel lateral. Puedes editarlo directamente desde allí.

Este estado convertido es permanente (persistirá incluso después de cerrar el panel o salir de la plantilla).

Diferencias en el editor de solo texto

El creador de lógica del editor de solo texto funciona igual que en el editor de arrastrar y soltar, con una diferencia clave: la lógica se configura en un modal en lugar de en un panel lateral. Están disponibles las mismas opciones de if/else, bucles «for», etiquetas configurables, anidación y conversión a código.

Una vez configurada la lógica, aparece en el lienzo de la misma manera que en el editor de arrastrar y soltar. Al hacer clic en Editar en una condición configurada, se abre el modal para permitir más ediciones.

Recursos adicionales

• Referencia de lógica condicional
• Cómo mostrar u ocultar bloques y secciones de la plantilla en función de variables dinámicas
• Referencia de personalización de mensajes
• Acerca de las propiedades personalizadas
• curso: Aplicar conceptos de lógica de programación para crear mensajes más personalizados