Cómo utilizar filtros para personalizar variables

Objetivos de aprendizaje

Aprende 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 (por ejemplo, la etiqueta de plantilla) en tus mensajes. Para obtener una lista de los filtros que puedes utilizar en el editor de plantilla, consulta el Klaviyo glosario de filtros variables de. 

Antes de empezar

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

Cómo funcionan los filtros

Se aplican filtros a la etiqueta de plantilla para ajustar la salida que se muestra. Algunos posibles casos de uso son:

• Aplica mayúsculas coherentes a un texto (por ejemplo, puedes utilizar el filtro mayúsculas para tomar cualquier variable y ponerla toda en mayúsculas).
• Muestra el precio de un artículo después de aplicar una promoción utilizando el filtro multiplicar. 
• Establece el número de decimales que se mostrarán para una variable numérica utilizando el filtro floatformat.

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

Aplicar un filtro a una variable

Para aplicar un filtro a una variable:

1. Identifica tu etiqueta de plantilla (por ejemplo, {{ item.price }}).
2. Añade un símbolo de tubo ( | ) después del nombre de la variable. 
3. Añade un nombre de filtro, como floatformat, para especificar el número de decimales a mostrar.
4. Si el filtro toma algún argumento (es decir, parámetros o entradas adicionales), añade dos puntos, seguidos del argumento o argumentos. 

No añadas espacios adicionales. Aquí tienes un ejemplo de una variable con un filtro aplicado:

{{ item.price|floatformat:2 }}

En este ejemplo, artículo.precio es el nombre de la variable, floatformat es el filtro y 2 es el argumento requerido por el filtro. 

Si el argumento es un fragmento de texto, debe ir entre comillas simples rectas (es decir, ', no '). Las comillas no son necesarias si el argumento es un número. Consulta el glosario de filtros variables de Klaviyo para ver ejemplos. 

Consejos para utilizar los filtros

Si copias filtros y los pegas en tu plantilla, asegúrate de pegarlos como texto sin formato para evitar pegar el formato junto con el propio filtro. Utiliza el atajo de teclado pegar como texto plano (Ctrl+Mayús+V o Cmd+Mayús+V). 

Es importante que te asegures de que los datos referenciados en tus variables son adecuados para el filtro utilizado. Algunos filtros sólo pueden aplicarse a tipos de datos de texto, mientras que otros sólo funcionan con listas o números. Si el filtro no funciona como esperabas, revisa el evento o los datos del perfil que estás utilizando para asegurarte de que son del tipo correcto. 

Aplicar varios filtros

Si es necesario, puedes aplicar varios filtros a una sola variable. Para ello, conecta cada filtro mediante el símbolo de una tubería ( | ), y ten en cuenta que los filtros se aplicarán generalmente en orden (del primero al último). Aquí tienes algunos ejemplos de variables con varios filtros aplicados: 

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

El primer filtro aplica el tipo de título al nombre de pila del destinatario, y el segundo filtro proporciona una palabra por defecto que se utilizará si no se ha facilitado el nombre de pila. 

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

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

Recursos adicionales

• Glosario de filtros variables
• Variables de fecha en referencia a la plantilla
• Referencia de personalización de mensajes