Cómo usar filtros para personalizar variables

Qué aprenderás

Descubre cómo funcionan los filtros y cómo utilizarlos para personalizar variables. Los filtros te permiten personalizar el formato y el contenido de las variables (es decir, etiquetas de personalización) en tus mensajes. Para ver una lista de filtros disponibles para usar en el editor de plantillas, consulta el glosario de filtros de variables de Klaviyo.

Antes de empezar

Antes de empezar, familiarízate con cómo funciona la personalización en Klaviyo. Para usar filtros, tendrás que poder identificar las variables base correctas y añadirlas a tu plantilla.

Cómo funcionan los filtros

Los filtros se aplican a las etiquetas de personalización para ajustar el resultado que se muestra. Algunos casos de uso posibles son:

• Aplica un uso coherente de mayúsculas a un fragmento de texto (por ejemplo, puedes usar el filtro upper para convertir cualquier variable en todo mayúsculas).
• Muestra el precio de un artículo después de que se haya aplicado una promoción usando el filtro multiply.
• Establece el número de posiciones decimales que se mostrarán para una variable numérica mediante el filtro floatformat.

Para consultar una lista de filtros compatibles, consulta nuestro glosario de filtros de variables.

Aplicar un filtro a una variable

Para aplicar un filtro a una variable:

1. Identifica tu etiqueta de personalización (p. ej., {{ item.price }}).
2. Añade un símbolo de barra vertical ( | ) después del nombre de la variable.
3. Añade un nombre de filtro, como floatformat, para especificar el número de decimales que quieres mostrar.
4. Si el filtro requiere un argumento (es decir, una entrada adicional) o quieres establecer un argumento opcional, añade dos puntos seguidos del argumento.

No añadas espacios alrededor de los dos puntos. Se permiten espacios dentro de un argumento de texto entrecomillado. Aquí tienes un ejemplo de una variable con un filtro aplicado:

{{ item.price|floatformat:2 }}

En este ejemplo, item.price es el nombre de la variable, floatformat es el filtro y 2 es un argumento opcional que indica al filtro que redondee el número a 2 decimales y muestre ambas cifras decimales.

Si el argumento es un fragmento de texto, rodéalo con comillas simples o dobles rectas coincidentes (es decir, ' o ", no ‘ o “). No se necesitan comillas si el argumento es un número. Consulta el glosario de filtros de variables de referencia de Klaviyo para ver ejemplos.

Después de añadir filtros, previsualiza el mensaje con un perfil o evento que contenga los datos a los que haces referencia. En el editor de email, haz clic en Vista previa y comprueba que el valor y el formato sean correctos.

Consejos para usar filtros

Si estás copiando filtros y pegándolos en tu plantilla, asegúrate de pegar como texto sin formato para evitar pegar el formato junto con el propio filtro. Usa el atajo de teclado para pegar como texto sin formato (Ctrl+Shift+V o Cmd+Shift+V).

Es importante asegurarse de que los datos a los que se hace referencia en tus variables sean adecuados para el filtro que se esté utilizando. Algunos filtros solo pueden aplicarse a tipos de datos de texto, mientras que otros solo funcionan con listas o números. Si el filtro no funciona como esperas, revisa los datos del evento o del perfil que estés usando para asegurarte de que sea el tipo correcto.

Aplicar varios filtros

Si es necesario, puedes aplicar varios filtros a una sola variable. Para ello, conecta cada filtro con un símbolo de barra vertical ( | ). Los filtros se aplican en orden (del primero al último) y cada filtro usa el resultado del anterior. Aquí tienes algunos ejemplos de variables con varios filtros aplicados:

{{ first_name|title|default:'there' }}

El primer filtro aplica el formato de mayúsculas y minúsculas del título al nombre del destinatario, y el segundo filtro proporciona una palabra predeterminada para usar si no se ha proporcionado ningún nombre.

{{ item.price|multiply:.8|floatformat:2 }}

El primer filtro multiplica el precio base del artículo por 0,8 (para mostrar el precio si se ha aplicado un cupón del 20 % de descuento), y el segundo filtro especifica que deben aparecer 2 decimales.

Recursos adicionales