Cómo usar filtros para personalizar variables

Objetivos del artículo

Descubre cómo funcionan los filtros y cómo usarlos para personalizar variables. Los filtros te permiten personalizar el formato y el contenido de las variables (es decir, etiquetas de personalización) en los 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, es necesario identificar las variables base correctas y agregarlas a la 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 el uso consistente de mayúsculas a un fragmento de texto (por ejemplo, puedes usar el filtro upper para tomar cualquier variable y convertirla a mayúsculas).
• Muestra el precio de un artículo después de que se haya aplicado una promoción usando el filtro multiply.
• Configura la cantidad de decimales que se mostrarán para una variable numérica con el filtro floatformat.

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

Aplicar un filtro a una variable

Para aplicar un filtro a una variable:

1. Identifica la etiqueta de personalización (p. ej., {{ item.price }}).
2. Agrega un símbolo de barra vertical (|) después del nombre de la variable.
3. Agrega un nombre de filtro, como floatformat, para especificar la cantidad de decimales que se mostrarán.
4. Si el filtro acepta algún argumento (es decir, parámetros o entradas adicionales), agrega dos puntos, seguidos del argumento o los argumentos.

No agregues espacios adicionales. Este es 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 el argumento requerido por el filtro.

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

Consejos para usar filtros

Si estás copiando filtros y pegándolos en la plantilla, asegúrate de pegar como texto sin formato para evitar pegar el formato junto con el 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 las variables sean adecuados para el filtro que se está usando. Algunos filtros solo se pueden aplicar a tipos de datos de texto, mientras que otros solo funcionan con listas o números. Si el filtro no funciona como se espera, revisa los datos de eventos o de perfil que estás usando para asegurarte de que sean del tipo correcto.

Aplicar varios filtros

Si es necesario, puedes aplicar varios filtros a una sola variable. Para hacerlo, conecta cada filtro con un símbolo de barra vertical ( | ) y ten en cuenta que, por lo general, los filtros se aplicarán en orden (del primero al último). Estos son algunos ejemplos de variables con varios filtros aplicados:

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

El primer filtro aplica mayúsculas y minúsculas de título al nombre del destinatario, y el segundo filtro proporciona una palabra predeterminada que se usará si no se proporcionó un 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 aplicó un cupón de 20 % de descuento), y el segundo filtro especifica que deben mostrarse dos decimales.

Recursos adicionales