Cómo agregar lógica condicional a las plantillas de correo electrónico con el generador de lógica
Objetivos del artículo
Aprende a usar el generador de lógica para agregar lógica condicional dinámica, como instrucciones if/else y bucles for, directamente a los bloques de texto en las plantillas de correo electrónico. Esto te permite mostrar contenido personalizado a diferentes destinatarios según su perfil o propiedades personalizadas, sin escribir código.
Antes de empezar
El generador de lógica está disponible en:
- Editor de correo electrónico de arrastrar y soltar — bloques de texto, bloques de tabla y bloques de división
- Editor de correo electrónico de solo texto — mediante un modal en lugar de un panel lateral
Para seleccionar una propiedad personalizada del menú desplegable, primero agrégala a al menos 1 perfil en la cuenta. Los perfiles y las propiedades personalizadas se pueden agregar mediante formularios de registro, cargas de CSV, integraciones de ecommerce y otras herramientas de crecimiento de listas.
Nota: El menú desplegable de propiedades incluye propiedades de perfil y personalizadas, pero no incluye datos de eventos. Para escribir una condición con datos de eventos, puedes usar Convertir a código y escribir etiquetas de Django directamente. Los bucles for pueden usar una lista de eventos directamente en Variable para iterar. Usa un flujo activado por el evento cuyos datos quieres consultar.
Agrega una declaración if/else
Usa una declaración if/else para mostrar contenido diferente a los destinatarios según un perfil o una propiedad personalizada. Por ejemplo, podrías mostrar un bloque de descuento VIP solo a los clientes con más de 500 puntos de lealtad, y un incentivo de registro a todos los demás.
En el editor de arrastrar y soltar
- Haz doble clic en un bloque de texto, bloque de tabla o bloque de división para entrar en el modo de edición.
- Haz clic en el botón Insertar en la barra de herramientas de formato de texto.
- Selecciona Condición si/si no en el menú desplegable.
- Se abrirá un panel lateral a la izquierda y el lienzo se desplazará hacia la derecha.
- Configura la declaración if:
- Usa el primer menú desplegable para elegir una propiedad de perfil o personalizada que se va a evaluar.
- Usa el segundo menú desplegable para seleccionar un operador (p. ej., es igual a, es mayor que, está establecido).
- Ingresa o selecciona un valor para compararlo, según el operador elegido.
- Opcionalmente, haz clic en Agregar condición para agregar criterios adicionales a la declaración if.
- Usa AND o OR para conectar condiciones. AND está seleccionado de forma predeterminada. Todas las condiciones conectadas por AND deben coincidir; las condiciones conectadas por OR ofrecen alternativas.
- Haz clic en el botón Copiar condición en una condición para duplicarla como una nueva condición Y.
- Para agregar una rama else if, haz clic en Agregar else if y configura las condiciones de la misma manera. Los destinatarios ven el contenido de la primera rama con la que coincidan. Una rama else if se aplica solo cuando la declaración if y todas las ramas else if anteriores no coinciden.
- La casilla de verificación de respaldo está seleccionada de forma predeterminada: Incluir contenido alternativo para todos los perfiles que no coincidan con ninguna condición. Manténla seleccionada para mostrar contenido a los destinatarios que no coincidan con ninguna condición, o desmárcala para eliminar la rama alternativa.
- Edita el contenido en el lienzo para cada condición. Cada condición aparece como un cuadro azul mientras se configura.
- Cuando termines, haz clic en Guardar o en la flecha para volver para cerrar el panel y guardar la lógica.
Tip: Para quitar la lógica seleccionada, haz clic en Quitar lógica en el panel lateral. El contenido permanece en el correo electrónico, así que revísalo después de quitar las condiciones.
Nota: Haz clic en Eliminar condición para quitar una condición. Eliminar la última condición en la instrucción if inicial borra sus valores, pero conserva la instrucción. Eliminar la última condición en una rama else if elimina esa rama. Para eliminar la rama else, desmarca la casilla de verificación de contenido de respaldo.
En el editor solo de texto
En el editor de solo texto, selecciona Insertar > Condición If/else en la barra de herramientas de edición de texto. Configura las condiciones en el cuadro de diálogo con las opciones de arriba y luego haz clic en Guardar. Edita el contenido de cada rama en el correo electrónico después de que se cierre el cuadro de diálogo.
Agrega un bucle for
Usa un bucle for para iterar en una lista de elementos y mostrar contenido repetido para cada uno. Por ejemplo, podrías recorrer los productos que un cliente vio recientemente para mostrar cada uno en el correo electrónico.
En el editor de arrastrar y soltar
- Haz doble clic en un bloque de texto, bloque de tabla o bloque de división.
- Haz clic en el botón Insertar en la barra de herramientas.
- Selecciona Bucle for en el menú desplegable.
- Se abrirá un panel lateral a la izquierda.
- En el campo Variable para iterar, ingresa la lista que quieres recorrer (p. ej., event.items, si esa es la variable de lista en el evento de activación de tu flujo). Usa el nombre exacto de la variable de tus datos.
- En el campo Alias del elemento, ingresa un nombre para hacer referencia a cada elemento individual dentro del bucle (p. ej., item).
- Edita el contenido en el lienzo para definir lo que se mostrará para cada elemento. Usa el alias del elemento en las etiquetas de personalización: para un alias de
item, usa{{ item }}para un valor de lista simple o un campo como{{ item.name }}si cada elemento tiene una propiedad de nombre. - Haz clic en Guardar o en la flecha de regreso para cerrar el panel y guardar la lógica.
Consejo: Para quitar el bucle, haz clic en Quitar lógica en el panel lateral. El contenido permanece, así que elimina o reemplaza cualquier etiqueta que dependa del alias del elemento.
Agrega una etiqueta configurable
Usa una etiqueta configurable para insertar etiquetas de Django que no están incluidas en los generadores de if/else o bucle for, como instrucciones with o etiquetas de catálogo.
- Haz doble clic en un bloque de texto, bloque de tabla o bloque de división.
- Haz clic en el botón Insertar en la barra de herramientas.
- Selecciona Etiqueta configurable en el menú desplegable.
- Se abrirá un panel lateral a la izquierda.
- En el campo Nombre de etiqueta, ingresa la etiqueta que abrirá y cerrará el bloque (por ejemplo, with).
- En Argumentos de etiqueta, ingresa solo los argumentos de la etiqueta. Por ejemplo, para una etiqueta
with, ingresafirst_name as name. No incluyas el nombre de la etiqueta ni los delimitadores de apertura y cierre de la etiqueta. - Edita el contenido en el lienzo que va dentro de la etiqueta. Para el ejemplo de
withanterior, usa{{ name }}donde quieras que aparezca el nombre del destinatario. - Haz clic en Guardar o en la flecha de regreso para cerrar el panel y guardar la lógica.
Trabaja con lógica anidada
Puedes anidar declaraciones lógicas entre sí; por ejemplo, una declaración if/else dentro de un bucle for. Esto te permite crear secuencias de contenido altamente segmentadas.
Cuando la lógica está anidada:
- Los iconos de líneas verticales indican el nivel de anidamiento de cada declaración de lógica.
- Al pasar el cursor sobre una instrucción principal, se resalta todo el bloque anidado.
- Al pasar el cursor sobre una instrucción secundaria, se resalta solo esa instrucción.
- Puedes contraer y expandir las declaraciones secundarias de forma independiente de la declaración principal.
- Si se anidan más de 3 niveles de lógica, aparece un indicador +[number] para mostrar la profundidad de anidación adicional.
Convertir lógica a código
Si necesitas más control sobre una condición o un bucle, puedes convertirlo a código de Django. Por ejemplo, puedes escribir condiciones basadas en eventos o comparaciones de fechas usando código.
Advertencia: Después de guardar una conversión, no puedes cambiar esa condición ni volver al editor visual. Debes seguir editándola como código. Otras condiciones aún pueden usar el editor visual.
Para convertir:
- Haz clic en Editar en la declaración de lógica que quieres actualizar para abrir su panel lateral o, en el editor de solo texto, su cuadro de diálogo.
- En el caso de las instrucciones if/else, cada segmento individual (if, else if) tiene su propio botón Convertir a código. Haz clic en el que corresponda al segmento que quieres convertir.
- Para los bucles for, haz clic en el único botón Convertir en código para todo el bucle.
- En el cuadro de diálogo de advertencia, haz clic en Convertir para continuar.
- Edita la condición convertida o los argumentos del bucle en el editor de código y luego haz clic en Guardar para aplicar los cambios y cerrar el panel lateral o el cuadro de diálogo.
La conversión guardada permanece cuando cierras el panel o el cuadro de diálogo y vuelves a abrir la plantilla.
Diferencias en el editor solo de texto
El generador de lógica en el editor de solo texto funciona igual que en el editor de arrastrar y soltar, con una diferencia clave: la lógica se configura en una modal en lugar de un panel lateral. Están disponibles las mismas opciones para if/else, bucles for, etiquetas configurables, anidación y conversión a código.
Después de configurar la lógica en el editor de solo texto, haz clic en Guardar para cerrar el cuadro de diálogo y, luego, edita el contenido en el correo electrónico. Haz clic en Editar en una instrucción configurada para volver a abrir el cuadro de diálogo. Cuando termines de editar el correo electrónico, usa Guardar en el editor de correo electrónico para guardar la plantilla. Si en su lugar ves Revisar y guardar, revisa el contenido y guárdalo.
Previsualizar tu correo electrónico
Antes de enviar, previsualiza el correo electrónico con perfiles que coincidan con cada rama y un perfil que no coincida con ninguna de las condiciones. Para la lógica basada en eventos, también previsualiza con los datos de evento relevantes. Verifica que aparezca el contenido esperado y que los bucles muestren los elementos correctos.