필터

이 참고 문서에서는 Liquid의 필터에 대한 개요와 Braze에서 지원하는 필터에 대해 설명합니다. 이러한 필터를 사용하는 방법에 대한 아이디어를 찾고 계신가요? Liquid 사용 사례 라이브러리를 확인하세요.

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

필터 구문

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

• input
• output

1
{{"Big Sale" | upcase}}

1
BIG SALE

이 예에서 Big Sale 은 문자열이고 upcase 은 적용 중인 필터입니다.

다중 필터 구문

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

• input
• output

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

1
SALE

배열 필터

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

컬러 필터

Color filters are not supported in Braze.

글꼴 필터

Font filters are not supported in Braze.

수학 필터

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

사용자 지정 속성을 사용한 수학 연산

두 사용자 지정 속성 간에 수학 연산을 수행할 수 없다는 점에 유의하세요.

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

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

1. 하나는 변수에 커스텀 속성을 할당하는 것입니다,
2. 하나는 추가를 수행합니다.

Use case: 현재 잔액 계산

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

1. assign 태그를 사용하여 current_rewards_balance의 사용자 정의 속성을 “잔액”이라는 용어로 대체하십시오. 즉, 이제 조작할 수 있는 balance라는 변수가 생겼습니다.

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

2. plus 필터를 사용하여 각 사용자의 기프트 카드 잔액을 {{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!

머니 필터

사용자의 구매, 계정 잔액 또는 돈과 관련된 내용을 업데이트하는 경우에는 머니 필터를 사용해야 합니다. 머니 필터는 소수점이 올바른 위치에 있고 업데이트의 일부가 손실되지 않도록 합니다(예: 마지막에 있는 성가신 0).

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

Shopify 머니 필터와 Braze 머니 필터 비교

사용자 정의 속성(예: account_balance)을 입력하는 경우 항상 money 필터를 사용하여 소수점을 올바른 위치에 배치하고 숫자의 끝에서 0이 떨어지지 않도록 해야 합니다:

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

머니 필터 사용	머니 필터 미사용
여기서 account_balance는 17.8에 입력합니다.	여기서 account_balance는 17.8에 입력합니다.

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

• input
• output

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

1
$145.00

According to Shopify’s money filter, this should have an output of $1.45, however in Braze, this will have an output of $145.00. 해결 방법으로 divided_by 필터를 사용하여 숫자를 10진수로 조작한 후 돈 필터를 적용할 수 있습니다:

• input
• output

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라고 가정해 보겠습니다.

• input
• output

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

1
03 June

strftime 서식 지정 옵션 외에도 Braze는 %s 날짜 필터를 사용하여 타임스탬프를 unix 시간으로 변환하는 기능도 지원합니다. 예를 들어, unix 시간으로 date_attribute를 가져옵니다.

• input
• output

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

1
1433351621