Filtros

Este artigo de referência fornece uma visão geral dos filtros em Liquid e aborda quais filtros são suportados pela Braze. Procurando ideias de como usar esses filtros? Confira nossa biblioteca de casos de uso de Liquid.

Filtros são a forma de modificar a saída de números, strings, variáveis e objetos em Liquid. Você pode usar filtros para reformatar texto estático ou dinâmico, como converter uma string de minúsculas para maiúsculas ou realizar operações matemáticas, como adição ou divisão.

Importante

A Braze não suporta todos os filtros Liquid da Shopify. Esta página tenta listar os filtros Liquid que a Braze testou, mas pode não ser uma lista completa. Sempre teste seu Liquid antes de enviar qualquer mensagem.

Se você tiver dúvidas sobre um filtro que não está listado aqui, entre em contato com seu gerente de sucesso do cliente.

Sintaxe de filtro

Os filtros devem ser colocados dentro de uma tag de saída {{ }} e são indicados por um caractere de barra vertical |.

• input
• output

1
{{"Big Sale" | upcase}}

1
BIG SALE

Neste exemplo, Big Sale é uma string e upcase é o filtro sendo aplicado.

Nota

Os filtros podem ser usados em instruções assign e tags de saída ({{ }}), mas não em condicionais (if, elsif, unless), case/when, loops for ou colchetes de acesso a arrays. Para usar um valor filtrado em um desses contextos, atribua o resultado a uma variável primeiro. Para mais detalhes, consulte Onde usar operadores e filtros.

Sintaxe para múltiplos filtros

Você pode usar múltiplos filtros em uma única saída. Eles são aplicados da esquerda para a direita.

• input
• output

1
 {{ "Big Sale" | upcase | remove: "BIG" }}

1
SALE

Filtros de array

Filtros de array são usados para alterar a saída de arrays.

Filtros de cor

Filtros de cor não são suportados na Braze.

Filtros de fonte

Filtros de fonte não são suportados na Braze.

Filtros matemáticos

Filtros matemáticos permitem que você realize operações matemáticas. Se você usar múltiplos filtros em uma única saída, eles serão aplicados da esquerda para a direita.

Dica

Ao dividir inteiros (números inteiros) por inteiros em Liquid, se o resultado for um float (número com decimal), o Liquid arredondará automaticamente para baixo até o inteiro mais próximo. No entanto, dividir inteiros por floats sempre retornará um float. Isso significa que você pode converter seus inteiros em float (1.0, 2.0, 3.0) para retornar um float.

Por exemplo, {{15 | divided_by: 2}} retornará 7, enquanto {{15 | divided_by: 2.0}} retornará 7.5.

Operações matemáticas com atributos personalizados

Tenha em mente que você não pode realizar operações matemáticas entre dois atributos personalizados.

1
{{custom_attribute.${current_rewards_balance} | plus: {{custom_attribute.${giftcard_balance}}}}}

Este exemplo não funcionaria porque você não pode referenciar múltiplos atributos personalizados em uma única linha de Liquid. Em vez disso, você precisaria atribuir uma variável a pelo menos um desses valores antes que as funções matemáticas sejam executadas. Somar dois atributos personalizados requer duas linhas de Liquid:

1. Uma para atribuir o atributo personalizado a uma variável,
2. Uma para realizar a adição.

Caso de uso: calcular o saldo atual

Digamos que queremos calcular o saldo atual de um usuário somando o saldo do cartão-presente e o saldo de recompensas.

1. Use a tag assign para substituir o atributo personalizado de current_rewards_balance pelo termo “balance”. Isso significa que agora você tem uma variável chamada balance, que pode ser manipulada.

1
{% assign balance = {{custom_attribute.${current_rewards_balance}}} %}

2. Use o filtro plus para combinar o saldo do cartão-presente de cada usuário com o saldo de recompensas, representado pelo objeto {{balance}}.

• input
• output

1
2
{% assign balance = {{custom_attribute.${current_rewards_balance}}} %}
You have ${{custom_attribute.${giftcard_balance} | plus: {{balance}}}} to spend!

1
You have $35 to spend!

Filtros de dinheiro

Se você está atualizando um usuário sobre uma compra, um saldo de conta ou qualquer coisa relacionada a dinheiro, você deve usar filtros de dinheiro. Os filtros de dinheiro garantem que os decimais estejam no lugar correto e que nenhuma parte da sua atualização seja perdida (como aquele 0 incômodo no final).

Importante

Para formatar corretamente um número com o filtro money, remova quaisquer vírgulas do número e adicione o filtro plus: 0 antes do filtro money. Por exemplo, veja o seguinte Liquid:

1
2
{% assign my_int = "350000.25" | plus: 0 %}
{{ my_int | money }}

Filtro money da Shopify versus filtro money da Braze

Aviso

O comportamento do filtro money da Shopify difere de como ele é usado na Braze. Consulte os exemplos a seguir para uma representação precisa do comportamento esperado.

Caso você esteja inserindo um atributo personalizado (como account_balance), você deve sempre usar o filtro money para colocar os decimais no lugar correto e evitar que zeros sejam removidos do final de qualquer número:

1
${{custom_attribute.${account_balance} | money}}

COM O FILTRO MONEY	SEM O FILTRO MONEY
Onde account_balance é inserido como 17.8.	Onde account_balance é inserido como 17.8.

O filtro money na Braze difere da Shopify porque não aplica automaticamente casas decimais de acordo com uma configuração predefinida. Por exemplo, considere o seguinte cenário onde rewards_redeemed contém o valor 145:

• input
• output

1
${{event_properties.${rewards_redeemed} | money }}

1
$145.00

De acordo com o filtro money da Shopify, a saída deveria ser $1.45, porém na Braze, a saída será $145.00. Como alternativa, podemos usar o filtro divided_by para transformar o número em um decimal antes de aplicar o filtro money:

• input
• output

1
${{event_properties.${rewards_redeemed} | divided_by: 100.00 | money }}

1
$1.45

Filtros de string

Filtros de string são usados para manipular as saídas e variáveis de strings. Strings são uma combinação de caracteres alfanuméricos e devem ser envolvidas em aspas retas.

Nota

Aspas retas são diferentes de aspas curvas em Liquid. Tenha cuidado ao copiar e colar Liquid de um editor de texto para a Braze, pois aspas curvas causarão erros no seu Liquid. Se você estiver escrevendo seu Liquid diretamente na Braze, aspas retas serão aplicadas automaticamente.

Filtros adicionais

Os filtros gerais a seguir servem para diversos propósitos, incluindo formatação ou conversão de conteúdo.

Você pode encontrar mais filtros suportados, como filtros de codificação e URL, na nossa página de Filtros avançados.

Filtro de data

O filtro date pode ser usado para converter um timestamp em um formato de data diferente. Você pode passar parâmetros para o filtro date para reformatar o timestamp. Para exemplos desses parâmetros, consulte strfti.me.

Por exemplo, digamos que o valor de date_attribute é o timestamp 2021-06-03 17:13:41 UTC.

• input
• output

1
{{custom_attribute.${date_attribute} | date: '%b %d'}}

1
03 June

Além das opções de formatação strftime, a Braze também suporta a conversão de um timestamp para tempo Unix com o filtro de data %s. Por exemplo, para obter o date_attribute em tempo Unix:

• input
• output

1
{{custom_attribute.${date_attribute} | date: '%s' }}

1
1433351621