Skip to content

Filtros

Este artigo de referência fornece uma visão geral dos filtros no Liquid e aborda quais filtros são suportados pela 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, strings, variáveis e objetos no Liquid. Você pode usar filtros para reformatar textos estáticos ou dinâmicos, como alterar uma string de minúscula para maiúscula, ou para 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 |.

1

{{"Big Sale" | upcase}}

1

BIG SALE

Neste exemplo, Big Sale é uma string 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.

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 suportados no Braze.

Filtros de fonte

Os filtros de fonte não são suportados no 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. A adição de 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}}.

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 de sua atualização seja perdida (como aquele incômodo 0 de ponta a ponta).

Filtro de dinheiro da Shopify versus filtro de dinheiro da Braze

Caso esteja inserindo um atributo personalizado (como account_balance), sempre use o filtro money para colocar as casas decimais no lugar correto e evitar que os zeros caiam de ponta a ponta em qualquer número:

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:

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, na 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:

1

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

1

$1.45

Filtros de string

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

Filtros adicionais

Os filtros gerais a seguir têm muitas finalidades, inclusive 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.

1

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

1

03 June

Além das opções de formatação do site strftime, a Braze também oferece suporte à conversão de um registro de data e hora para a hora Unix com o filtro de data %s. Por exemplo, para obter o date_attribute em tempo Unix:

1

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

1

1433351621

Filtro de fuso horário

Além dos filtros que você encontrará listados na documentação da Shopify, o Braze também oferece suporte ao filtro time_zone.

O filtro time_zone usa uma hora, um fuso horário e um formato de data e retorna a hora nesse fuso horário no formato de data especificado. Por exemplo, digamos que o valor de {{custom_attribute.$date_attribute}}} seja 2021-08-04 9:00:00 UTC:

1

{{custom_attribute.${date_attribute} | time_zone: 'America/Los_Angeles' | date: '%a %b %e %T' }}

1

Wed August 4 2:00:00

Também é possível usar a variável reservada now para acessar a data e a hora atuais para manipulação.

1

{{ 'now' | date: '%Y-%m-%d %H:%M:%S' }}

1

2021-08-04 18:13:13
Github   Editar esta página no GitHub
QUÃO ÚTIL FOI ESTA PÁGINA?
New Stuff!