Filtros

Este artigo de referência fornece uma visão geral dos filtros no Liquid e aborda quais filtros são compatíveis com o Braze. Está procurando ideias de como usar esses filtros? Confira nossa biblioteca de casos de uso do Liquid.

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

Sintaxe do filtro

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

• input
• output

1
{{"Big Sale" | upcase}}

1
BIG SALE

Neste exemplo, Big Sale é uma cadeia de caracteres e upcase é o filtro que está sendo aplicado.

Sintaxe para vários filtros

Você pode usar vários filtros em uma saída. Eles são aplicados da esquerda para a direita.

• input
• output

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

1
SALE

Filtros de matriz

Os filtros de matriz são usados para alterar a saída das matrizes.

Filtros coloridos

Os filtros de cores não são compatíveis com o Braze.

Filtros de fonte

Os filtros de fonte não são compatíveis com o Braze.

Filtros matemáticos

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

Operações matemáticas com atributos personalizados

Lembre-se de que não é possível realizar operações matemáticas entre dois atributos personalizados.

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

Esse exemplo não funcionaria porque não é possível fazer referência a vários atributos personalizados em uma linha do Liquid. Em vez disso, você precisaria atribuir uma variável a pelo menos um desses valores antes de executar as funções matemáticas. Adicionar dois atributos personalizados juntos exigiria duas linhas de Liquid:

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

Caso de uso: Calcular o saldo atual

Digamos que queremos calcular o saldo atual de um usuário adicionando 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 seu 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 estiver 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 as casas decimais estejam no lugar correto e que nenhuma parte da sua atualização seja perdida (como aquele incômodo 0 no final).

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

Filtro de dinheiro do Shopify versus filtro de dinheiro do Braze

Caso esteja inserindo um atributo personalizado (como account_balance), você deve sempre usar o filtro money para colocar as casas decimais no lugar correto e evitar que os zeros caiam no final dos números:

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

O filtro money no Braze é diferente do Shopify porque não aplica automaticamente os pontos decimais de acordo com uma configuração predefinida. Por exemplo, considere o seguinte cenário em que rewards_redeemed contém um valor de 145:

• input
• output

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

1
$145.00

De acordo com o filtro de dinheiro da Shopify, isso deveria ter uma saída de $1.45, no entanto, no Braze, isso terá uma saída de $145.00. Como solução alternativa, podemos usar o filtro divided_by para manipular o número em um decimal, antes de aplicar o filtro de dinheiro:

• input
• output

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

1
$1.45

Filtros de cadeia de caracteres

Os filtros de cadeia de caracteres são usados para manipular as saídas e as variáveis das cadeias de caracteres. As cadeias de caracteres são uma combinação de caracteres alfanuméricos e devem ser colocadas entre aspas retas.

Filtros adicionais

Os filtros gerais a seguir servem para muitas finalidades, incluindo a formatação ou a conversão de conteúdo.

Você pode encontrar mais filtros compatíveis, como filtros de codificação e de URL, em nossa página Advanced Filters (Filtros avançados ).

Filtro de data

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

Por exemplo, digamos que o valor de date_attribute seja o registro de data e hora 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 do site strftime, o Braze também suporta a conversão de um carimbo de data/hora para a hora 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