Como usar filtros para personalizar variáveis

O que você vai aprender

Saiba como os filtros funcionam e como usá-los para personalizar variáveis. Os filtros permitem que o senhor personalize o formato e o conteúdo das variáveis (ou seja, tags de personalização) nas mensagens que envia. Para obter uma lista de filtros disponíveis para uso no editor de modelos, consulte o glossário de filtros variáveis do Klaviyo. 

Antes de começar

Antes de começar, o senhor deve se familiarizar com o funcionamento da personalização de mensagens na Klaviyo. Para usar filtros, o senhor precisa identificar as variáveis básicas corretas e adicioná-las ao seu modelo. 

Como os filtros funcionam

Os filtros são aplicados às tags de personalização para ajustar a saída que é exibida. Alguns casos de uso possíveis são:

• Aplicar capitalização consistente a um trecho de texto (por exemplo, o senhor pode usar o filtro superior para pegar qualquer variável e torná-la toda em maiúsculas).
• Mostrar o preço de um item após a aplicação de uma promoção usando o filtro de multiplicação. 
• Defina o número de casas decimais a serem exibidas em uma variável numérica usando o filtro floatformat.

Para obter uma lista de filtros compatíveis, consulte nosso glossário de filtros variáveis. 

Aplicar um filtro a uma variável

Para aplicar um filtro a uma variável:

1. Identifique sua tag de personalização (por exemplo, {{ item.price }}).
2. Adicione um símbolo de pipe ( | ) após o nome da variável. 
3. Adicione um nome de filtro, como floatformat, para especificar o número de casas decimais a serem exibidas.
4. Se o filtro receber algum argumento (ou seja, parâmetros ou entradas adicionais), adicione dois pontos, seguidos do(s) argumento(s). 

Não adicione nenhum espaço adicional. Aqui está um exemplo de uma variável com um filtro aplicado:

{{ item.price|floatformat:2 }}

Neste exemplo, item.price é o nome da variável, floatformat é o filtro e 2 é o argumento exigido pelo filtro. 

Se o argumento for um trecho de texto, ele precisará ser cercado por aspas simples e retas (ou seja, ', não '). As aspas não são necessárias se o argumento for um número. Consulte o glossário de filtros variáveis do Klaviyo para obter exemplos. 

Dicas para usar filtros

Se estiver copiando filtros e colando-os em seu modelo, certifique-se de colar como texto simples para evitar colar a formatação junto com o próprio filtro. Use o atalho de teclado colar como texto simples (Ctrl+Shift+V ou Cmd+Shift+V). 

É importante garantir que os dados referenciados em suas variáveis sejam apropriados para o filtro que está sendo usado. Alguns filtros só podem ser aplicados a tipos de dados de texto, enquanto outros só funcionam em listas ou números. Se o filtro não estiver funcionando como esperado, revise os dados do evento ou do perfil que está usando para garantir que sejam do tipo correto. 

Aplicação de vários filtros

Se necessário, o senhor pode aplicar vários filtros a uma única variável. Para isso, conecte cada filtro usando um símbolo de tubo ( | ) e considere que os filtros geralmente serão aplicados em ordem (do primeiro ao último). Aqui estão alguns exemplos de variáveis com vários filtros aplicados: 

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

O primeiro filtro aplica a caixa de título ao primeiro nome do destinatário e o segundo filtro fornece uma palavra padrão a ser usada se nenhum primeiro nome tiver sido fornecido. 

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

O primeiro filtro multiplica o preço do item básico por 0,8 (para mostrar o preço se um cupom de 20% de desconto tiver sido aplicado), e o segundo filtro especifica que duas casas decimais devem aparecer. 

Recursos adicionais

• Glossário de filtros variáveis
• Variáveis de data em modelos de referência
• Referência de personalização de mensagens