Skip to content

필터

이 참조 문서에서는 Liquid의 필터에 대한 개요를 제공하며, Braze에서 지원하는 필터를 다룹니다. 이러한 필터를 어떻게 사용할 수 있는지 아이디어를 찾고 계신가요? Liquid 사용 사례 라이브러리를 확인해 보세요.

필터는 Liquid에서 숫자, 문자열, 변수 및 오브젝트의 출력을 수정하는 방법입니다. 필터를 사용하여 문자열을 소문자에서 대문자로 변경하거나 덧셈이나 나눗셈과 같은 수학 연산을 수행하는 등 정적 또는 동적 텍스트를 다시 포맷할 수 있습니다.

필터 구문

필터는 출력 태그 {{ }} 안에 배치해야 하며, 파이프 문자 |로 표시됩니다.

1

{{"Big Sale" | upcase}}

1

BIG SALE

이 예시에서 Big Sale은 문자열이고, upcase는 적용되는 필터입니다.

다중 필터 구문

하나의 출력에 여러 필터를 사용할 수 있습니다. 필터는 왼쪽에서 오른쪽으로 적용됩니다.

1

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

1

SALE

배열 필터

배열 필터는 배열의 출력을 변경하는 데 사용됩니다.

색상 필터

색상 필터는 Braze에서 지원되지 않습니다.

글꼴 필터

글꼴 필터는 Braze에서 지원되지 않습니다.

수학 필터

수학 필터를 사용하면 수학 연산을 수행할 수 있습니다. 하나의 출력에 여러 필터를 사용하면 왼쪽에서 오른쪽으로 적용됩니다.

커스텀 속성을 사용한 수학 연산

두 개의 커스텀 속성 간에 수학 연산을 수행할 수 없다는 점을 유의하세요.

1

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

이 예시는 한 줄의 Liquid에서 여러 커스텀 속성을 참조할 수 없기 때문에 작동하지 않습니다. 대신 수학 함수가 실행되기 전에 이러한 값 중 하나 이상을 변수에 할당해야 합니다. 두 개의 커스텀 속성을 더하려면 두 줄의 Liquid가 필요합니다:

  1. 커스텀 속성을 변수에 할당하는 줄,
  2. 덧셈을 수행하는 줄.

사용 사례: 현재 잔액 계산

사용자의 기프트 카드 잔액과 리워드 잔액을 더하여 현재 잔액을 계산한다고 가정해 보겠습니다.

  1. assign 태그를 사용하여 current_rewards_balance의 커스텀 속성을 “balance”라는 용어로 대체합니다. 이렇게 하면 조작할 수 있는 balance라는 변수가 생깁니다.
1

{% assign balance = {{custom_attribute.${current_rewards_balance}}} %}
  1. plus 필터를 사용하여 각 사용자의 기프트 카드 잔액과 {{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!

금액 필터

사용자에게 구매, 계정 잔액 또는 금액과 관련된 내용을 업데이트하는 경우 금액 필터를 사용해야 합니다. 금액 필터는 소수점이 올바른 위치에 있고 업데이트의 어떤 부분도 손실되지 않도록(끝에 있는 성가신 0처럼) 보장합니다.

Shopify 금액 필터 vs Braze 금액 필터

커스텀 속성(예: account_balance)을 입력하는 경우, 항상 money 필터를 사용하여 소수점을 올바른 위치에 놓고 숫자 끝에서 0이 제거되는 것을 방지해야 합니다:

1

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

Braze의 money 필터는 사전 설정에 따라 자동으로 소수점을 적용하지 않기 때문에 Shopify와 다릅니다. 예를 들어, rewards_redeemed에 145 값이 포함된 다음 시나리오를 살펴보겠습니다:

1

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

1

$145.00

Shopify의 money 필터에 따르면 출력이 $1.45여야 하지만, Braze에서는 $145.00으로 출력됩니다. 해결 방법으로, divided_by 필터를 사용하여 금액 필터를 적용하기 전에 숫자를 소수로 변환할 수 있습니다:

1

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

1

$1.45

문자열 필터

문자열 필터는 문자열의 출력과 변수를 조작하는 데 사용됩니다. 문자열은 영숫자 문자의 조합이며 직선 따옴표로 감싸야 합니다.

추가 필터

다음 일반 필터는 콘텐츠 포맷 또는 변환을 포함한 다양한 용도로 사용됩니다.

인코딩 및 URL 필터와 같은 더 많은 지원 필터는 고급 필터 페이지에서 확인할 수 있습니다.

날짜 필터

date 필터는 타임스탬프를 다른 날짜 형식으로 변환하는 데 사용할 수 있습니다. date 필터에 매개변수를 전달하여 타임스탬프를 다시 포맷할 수 있습니다. 이러한 매개변수의 예시는 strfti.me를 참조하세요.

예를 들어, date_attribute의 값이 타임스탬프 2021-06-03 17:13:41 UTC라고 가정해 보겠습니다.

1

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

1

03 June

strftime 포맷 옵션 외에도, Braze는 %s 날짜 필터를 사용하여 타임스탬프를 Unix 시간으로 변환하는 것도 지원합니다. 예를 들어, date_attribute를 Unix 시간으로 가져오려면:

1

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

1

1433351621
New Stuff!