Liquid 사용

이 문서에서는 다양한 사용자 속성을 사용하여 메시징에 개인 정보를 동적으로 삽입하는 방법을 보여줍니다.

Liquid는 Shopify에서 개발한 오픈 소스 템플릿 언어이며 Ruby로 작성되었습니다. Braze에서 사용자 프로필 데이터를 메시지에 끌어와서 해당 데이터를 사용자화할 수 있습니다. 예를 들어, Liquid 태그를 사용하여 사용자의 구독 기념일에 따라 다른 제안을 보내는 등의 조건부 메시지를 만들 수 있습니다. 또한, 필터는 데이터를 조작할 수 있으며, 예를 들어 사용자의 등록 날짜를 타임스탬프에서 “2022년 1월 15일”과 같은 더 읽기 쉬운 형식으로 포맷할 수 있습니다. For further details on Liquid syntax and its capabilities, refer to Supported personalization tags.

작동 방식

Liquid 태그는 사용자의 계정에서 동의한 정보를 가져와 개인화 및 관련 메시징 관행을 활성화할 수 있는 메시지 내 입력 안내 역할을 합니다.

다음 블록에서는 사용자의 이름을 부를 때 Liquid 태그를 이중으로 사용하는 것과 사용자가 이름을 등록하지 않은 경우 기본 태그를 사용하는 것을 볼 수 있습니다.

1
Hi {{ ${first_name} | default: 'Valued User' }}, thanks for using the App!

신원 미상이라는 사용자에게는 이 메시지가 다음과 같이 표시됩니다.

1
Hi Janet, thanks for using the App!

또는

1
Hi Valued User, thanks for using the App!

대체할 수 있는 지원 값

사용 가능 여부에 따라 다음 값을 메시지로 대체할 수 있습니다:

• Basic user information (for example, first_name, last_name, email_address)
• Custom attributes
  • Nested custom attributes
• Custom event properties
• Most recently used device information
• Target device information

You can also pull content directly from a web server through Braze Connected Content.

Using Liquid

Using Liquid tags, you can elevate the quality of your messages by enriching them with a personal touch.

액체 구문

Liquid는 동적 개인화를 제작할 때 염두에 두어야 할 특정 구조 또는 구문을 따릅니다. 다음은 명심해야 할 몇 가지 기본 규칙입니다:

1. Braze에서는 따옴표를 사용합니다: 둥근 따옴표(‘‘)와 곧은 따옴표(‘‘)에는 차이가 있습니다. Braze의 Liquid에서는 따옴표(” “)를 사용하세요. 특정 텍스트 편집기에서 복사하여 붙여넣을 때 꼬불꼬불한 따옴표가 표시될 수 있으며, 이는 Liquid에서 문제를 일으킬 수 있습니다. 따옴표를 Braze 대시보드에 직접 입력하는 경우 괜찮을 것입니다!
2. 괄호는 쌍으로 제공됩니다. 모든 대괄호는 { }를 열고 닫아야 합니다. 중괄호를 사용해야 합니다!
3. 문이 쌍으로 구성된 경우: 모든 if에 대해 endif를 추가하여 if 문장이 종료되었음을 표시해야 합니다.
4. 변수 이름은 ASCII 문자를 사용해야 합니다: Liquid 변수 이름(assign 또는 capture으로 생성됨)은 ASCII 문자, 숫자 및 밑줄만 지원합니다. Braze 개인화 속성 이름(custom_attribute.${...} 또는 event_properties.${...} 내)은 비ASCII 문자를 포함할 수 있습니다.

연산자와 필터를 사용할 위치

연산자(==, !=, >, and, or)와 필터(| size, | plus)는 각각 특정 Liquid 컨텍스트에서만 사용할 수 있습니다.

필터를 지원하지 않는 컨텍스트에서 필터링된 값이 필요할 때는 먼저 결과를 변수에 할당하세요.

조건부에서 필터 결과 사용

조건문에서 필터를 직접 사용할 수 없습니다. 이것은 잘못되었습니다:

1
2
3
{% if my_array | size > 3 %}
You have more than 3 items!
{% endif %}

대신 필터 결과를 변수에 할당하십시오:

1
2
3
4
{% assign array_size = my_array | size %}
{% if array_size > 3 %}
You have more than 3 items!
{% endif %}

for 루프에서 필터 결과를 사용하십시오

for 루프에서 반복 가능한 객체에 필터를 적용할 수 없습니다. 이것은 잘못되었습니다:

1
2
3
{% for item in my_array | reverse %}
{{ item }}
{% endfor %}

대신 필터링된 값을 변수에 할당하십시오:

1
2
3
4
{% assign reversed = my_array | reverse %}
{% for item in reversed %}
{{ item }}
{% endfor %}

배열 접근을 위해 필터 결과를 사용하십시오

대괄호 안에 필터를 사용할 수 없습니다. 이것은 잘못되었습니다:

1
{{ my_array[my_var | minus: 1] }}

대신 필터링된 값을 먼저 할당하십시오:

1
2
{% assign adjusted_index = my_var | minus: 1 %}
{{ my_array[adjusted_index] }}

비교 결과를 변수에 저장하십시오

assign 문에서 연산자를 사용할 수 없습니다. 이것은 잘못되었습니다:

1
2
3
4
{% assign is_vip = total_spend > 100 %}
{% if is_vip %}
Welcome to the VIP lounge!
{% endif %}

대신 변수를 설정하기 위해 조건문을 사용하십시오:

1
2
3
4
5
6
7
8
{% assign is_vip = false %}
{% if total_spend > 100 %}
{% assign is_vip = true %}
{% endif %}

{% if is_vip %}
Welcome to the VIP lounge!
{% endif %}

기본 속성과 커스텀 속성

메시지에 다음 텍스트를 포함하는 경우 {{${first_name}}}을 포함하면 메시지가 전송될 때 고객 프로필에서 가져온 사용자의 이름이 대체됩니다. 다른 기본 사용자 속성과 동일한 형식을 사용할 수 있습니다.

커스텀 속성의 값을 사용하려면 변수에 네임스페이스 “custom_attribute”를 추가해야 합니다. 예를 들어 “우편 번호”라는 커스텀 속성을 사용하려면 메시지에 {{custom_attribute.${zip code}}}를 포함하면 됩니다.

태그 삽입하기

모든 메시지에 열린 중괄호 {{ 두 개를 입력하여 태그를 삽입하면 입력하는 동안 계속 업데이트되는 자동 완성 기능이 트리거됩니다. 입력할 때 표시되는 옵션에서 변수를 선택할 수도 있습니다.

사용자 지정 태그를 사용하는 경우 원하는 메시지에 태그를 복사하여 붙여넣을 수 있습니다.

이중 괄호에 대한 예외

{{ 두 개를 입력하여 태그를 삽입하면 입력하는 동안 계속 업데이트되는 자동 완성 기능이 트리거됩니다. 입력할 때 표시되는 옵션에서 변수를 선택할 수도 있습니다.

사용자 지정 태그를 사용하는 경우 원하는 메시지에 태그를 복사하여 붙여넣을 수 있습니다.

이중 괄호에 대한 예외

{% assign %} 또는 {% if %}와 같은 다른 Liquid 태그 내에서 태그를 사용할 경우, 이중 괄호 또는 괄호 없이 사용할 수 있습니다. 태그가 독립적으로 있을 때만 이중 괄호로 묶어야 합니다. 단순함을 위해 항상 이중 괄호를 사용할 수 있습니다.

다음 태그는 모두 올바릅니다:

1
2
3
4
5
{% if custom_attribute.${Number_Game_Attended} == 1 %}
{% if {{custom_attribute.${Number_Game_Attended}}} == 1 %}

{% assign value_one = {{custom_attribute.${one}}} %}
{% assign value_one = custom_attribute.${one} %}

미리 형식이 지정된 변수를 삽입하는 중입니다.

You can insert pre-formatted variables with defaults through the Add Personalization modal located near any templated text field.

The modal will insert Liquid with your specified default value at the point where your cursor was. 삽입 지점은 미리보기 상자에 의해 지정되며, 이 상자는 전후 텍스트를 포함합니다. 텍스트 블록이 강조 표시된 경우 강조 표시된 텍스트가 바뀝니다.

변수 할당

Liquid의 일부 작업에서는 조작하려는 값을 변수로 저장해야 합니다. Liquid 문에 여러 속성, 이벤트 속성정보 또는 필터가 포함된 경우 이러한 경우가 많습니다.

예를 들어 두 개의 사용자 지정 데이터 정수를 함께 추가하고 싶다고 가정해 보겠습니다.

잘못된 Liquid 예시

다음을 사용할 수 없습니다:

1
{{custom_attribute.${one}}} | plus: {{custom_attribute.${two}}}

이 Liquid는 한 줄에서 여러 속성을 참조할 수 없기 때문에 작동하지 않습니다. 수학 함수가 실행되기 전에 이러한 값 중 하나에 변수를 할당해야 합니다. 두 개의 커스텀 속성을 추가하려면 두 줄의 Liquid가 필요합니다. 하나는 변수에 커스텀 속성을 할당하는 데, 다른 하나는 추가를 수행하는 데 사용됩니다.

올바른 Liquid 예시

다음을 사용할 수 있습니다:

1
2
{% assign value_one = {{custom_attribute.${one}}} %}
{% assign result = value_one | plus: {{custom_attribute.${two}}} %}

Tutorial: 변수를 사용하여 잔액 계산하기

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

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

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

다음으로 plus 필터를 사용하여 각 사용자의 기프트 카드 잔액을 {{balance}}로 표시되는 리워드 잔액과 결합합니다.

1
2
{% assign balance = {{custom_attribute.${current_rewards_balance}}} %}
You have ${{custom_attribute.${giftcard_balance} | plus: {{balance}}}} to spend!