필터

이 참고 문서에서는 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}}} %}

2. 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).

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 값이 포함된 다음 시나리오를 예로 들어 보겠습니다:

• 입력
• 출력

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

1
$145.00

Shopify의 머니 필터에 따르면 $1.45 으로 출력되어야 하지만 Braze에서는 $145.00 으로 출력됩니다. 해결 방법으로 divided_by 필터를 사용하여 숫자를 10진수로 조작한 후 돈 필터를 적용할 수 있습니다:

• 입력
• 출력

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 시간으로 변환하는 기능도 지원합니다. 예를 들어, unix 시간으로 date_attribute를 가져옵니다.

• 입력
• 출력

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

1
1433351621

시간대 필터

Shopify 문서에 나열된 필터 외에도 Braze는 time_zone 필터도 지원합니다.

time_zone 필터는 시간, 표준 시간대 및 날짜 형식을 사용하여 해당 표준 시간대의 시간을 지정된 날짜 형식으로 반환합니다. 예를 들어 {{custom_attribute.$date_attribute}}}의 값이 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

예약 변수 now를 사용하여 현재 날짜와 시간에 액세스하여 조작할 수도 있습니다.

• 입력
• 출력

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

1
2021-08-04 18:13:13