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:
- Identifica la etiqueta de personalización (p. ej.,
{{ item.price }}). - Agrega un símbolo de barra vertical (|) después del nombre de la variable.
- Agrega un nombre de filtro, como floatformat, para especificar la cantidad de decimales que se mostrarán.
- Si el filtro requiere un argumento (es decir, una entrada adicional) o quieres configurar un argumento opcional, agrega dos puntos seguidos del argumento.
No agregues espacios alrededor de los dos puntos. Se permiten espacios dentro de un argumento de texto entre comillas. 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 un argumento opcional que le indica al filtro que redondee el número a 2 decimales y muestre ambos decimales.
Si el argumento es un fragmento de texto, rodéalo con comillas simples o dobles rectas que coincidan (es decir, ' o ", no ‘ o “). No se necesitan comillas si el argumento es un número. Consulta el glosario de filtros de variables de Klaviyo para ver ejemplos.
Después de agregar filtros, previsualiza el mensaje con un perfil o evento que contenga los datos a los que haces referencia. En el editor de correos electrónicos, haz clic en Vista previa y revisa que el valor y el formato sean correctos.
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 el símbolo de barra vertical ( | ). Los filtros se aplican en orden (de primero a último), y cada filtro utiliza el resultado del anterior. 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 2 decimales.
Recursos adicionales
- Referencia de personalización de fechas en plantillas
Aprende a completar dinámicamente y dar formato a las fechas en tus plantillas de Klaviyo. Puedes introducir fechas de las propiedades del perfil (p. ej., cumpleaños) en cualquier mensaje, o metadatos de eventos (p. ej., fecha de pedido realizado) en mensajes de flujo activados por ese evento.
- Guía de personalización de mensajes
Descubre cómo usar las variables de personalización (o etiquetas) de Klaviyo para ofrecer una experiencia personalizada a tus clientes.