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 personalizar o formato e o conteúdo das variáveis (ou seja, tags de personalização) nas suas mensagens. Para conferir uma lista de filtros disponíveis para usar no editor de modelos, consulte o glossário de filtros de variáveis da Klaviyo.

Antes de começar

Antes de começar, conheça como a personalização funciona na Klaviyo. Para usar filtros, você precisará ser capaz de identificar as variáveis de base corretas e adicioná-las ao seu modelo.

Como os filtros funcionam

Os filtros são aplicados às tags de personalização para ajustar o resultado exibido. Alguns casos de uso possíveis são:

• Aplique capitalização consistente a um trecho de texto (por exemplo, você pode usar o filtro upper para pegar qualquer variável e deixá-la toda em MAIÚSCULAS).
• Mostre o preço de um item após a aplicação de uma promoção usando o filtro multiply.
• Defina o número de casas decimais a serem exibidas para uma variável numérica usando o filtro floatformat.

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

Aplique 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 barra vertical (|) após o nome da variável.
3. Adicione um nome de filtro, como floatformat, para especificar o número de casas decimais a exibir.
4. Se o filtro aceitar algum argumento (ou seja, parâmetros adicionais ou entradas), adicione dois-pontos, seguidos do(s) argumento(s).

Não adicione espaços adicionais. Veja 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 precisa estar entre aspas simples 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 de variáveis da Klaviyo para ver exemplos.

Dicas para usar filtros

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

É importante garantir que os dados referenciados nas 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 de evento ou de perfil que você está usando para garantir que sejam do tipo correto.

Aplicar vários filtros

Se necessário, você pode aplicar vários filtros a uma única variável. Para isso, conecte cada filtro usando um símbolo de barra vertical ( | ) 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 capitalização de título ao primeiro nome do destinatário, e o segundo filtro fornece uma palavra padrão para ser usada se nenhum primeiro nome tiver sido fornecido.

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

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

Recursos adicionais