Liquid 사용하기

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

Liquid는 Shopify에서 개발한 오픈 소스 템플릿 언어이며 Ruby로 작성되었습니다. Braze에서 이를 사용하여 고객 프로필 데이터를 메시지로 가져오고 해당 데이터를 커스텀할 수 있습니다. 예를 들어, Liquid 태그를 사용하여 사용자의 가입 기념일에 따라 다른 오퍼를 보내는 등의 조건부 메시지를 만들 수 있습니다. 또한 필터는 타임스탬프에서 사용자 등록 날짜를 “2022년 1월 15일”과 같이 더 읽기 쉬운 형식으로 포맷하는 등 데이터를 조작할 수 있습니다. Liquid 구문과 그 기능에 대한 자세한 내용은 지원되는 개인화 태그를 참조하세요.

작동 방식

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

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

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

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

Hi Janet, thanks for using the App!

아니면…

Hi Valued User, thanks for using the App!

대체할 수 있는 지원되는 값

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

기본 사용자 정보 (예: first_name, last_name, email_address)
커스텀 속성
- 중첩 고객 속성
커스텀 이벤트 속성정보
가장 최근에 사용한 기기 정보
타겟팅 기기 정보

Braze 커넥티드 콘텐츠를 통해 웹 서버에서 직접 콘텐츠를 가져올 수도 있습니다.

important:

Braze는 현재 Shopify에서 Liquid 5까지 지원합니다.

Liquid 사용

Liquid 태그를 사용하면 메시징에 개인화된 감성을 더해 메시징의 품질을 높일 수 있습니다.

Liquid 구문

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

Braze에서는 큰따옴표를 사용합니다: 둥근 따옴표(‘‘)와 곧은 따옴표(‘‘)에는 차이가 있습니다. Liquid in Braze에서는 따옴표(‘‘)로 묶어 입력하세요. 특정 텍스트 편집기에서 복사하여 붙여넣을 때 꼬불꼬불한 따옴표가 표시될 수 있으며, 이는 Liquid에서 문제를 일으킬 수 있습니다. 따옴표를 Braze 대시보드에 직접 입력하는 경우 괜찮을 것입니다!
브래킷은 쌍으로 제공됩니다: 모든 대괄호는 { }를 열고 닫아야 합니다. 반드시 중괄호를 사용하세요!
문이 쌍으로 구성된 경우: 모든 if 에 대해 endif 을 추가하여 if 문장이 종료되었음을 표시해야 합니다.

기본 속성 및 커스텀 속성

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

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

태그 삽입하기

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

커스텀 태그를 사용하는 경우 원하는 메시징에 태그를 복사하여 붙여넣을 수 있습니다.

이중 대괄호 예외

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

커스텀 태그를 사용하는 경우 원하는 메시징에 태그를 복사하여 붙여넣을 수 있습니다.

이중 대괄호 예외

{% assign %} 또는 {% if %} 과 같이 다른 Liquid 태그 안에 태그를 사용하는 경우 대괄호를 사용하거나 대괄호를 사용하지 않을 수 있습니다. 태그가 단독으로 서 있을 때만 이중 괄호로 묶어야 합니다. 간단하게 하려면 항상 이중 대괄호를 사용할 수 있습니다.

다음 태그가 모두 맞습니다:

{% 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} %}

note:

이메일 메시징에 Liquid를 사용하는 경우 반드시 사용해야 합니다:

기존 편집기가 아닌 HTML 편집기를 사용하여 삽입합니다. 클래식 편집기는 Liquid를 일반 텍스트로 구문 분석할 수 있습니다. 예를 들어 Liquid는 사용자의 이름 대신 Hi {{ ${first_name} }}, thanks for using our service! 로 구문 분석합니다.
Liquid 코드는 <body> 태그 안에만 배치하세요. 이 태그 외부에 배치하면 전달 시 일관성 없는 렌더링이 발생할 수 있습니다.

미리 포맷된 변수 삽입하기

템플릿 텍스트 필드 근처에 있는 개인화 추가 모달을 통해 기본값이 있는 미리 서식이 지정된 변수를 삽입할 수 있습니다.

개인화 삽입을 선택한 후 표시되는 개인화 추가 모달입니다. 모달에는 개인화 유형, 속성, 선택적 기본값에 대한 필드가 있으며 Liquid 구문의 미리 보기를 표시합니다.](/docs/ko/assets/img_archive/insert_liquid_var_arrow.png?b9fe52fd1f178d3fe9c1a3bca45eec73){: style=”max-width:90%;”}

모달은 커서가 있던 지점에 지정한 기본값으로 Liquid를 삽입합니다. 삽입 지점은 앞뒤 텍스트가 있는 미리보기 상자로도 지정할 수 있습니다. 텍스트 블록이 강조 표시된 경우 강조 표시된 텍스트가 바뀝니다.

사용자가 “동료 여행자”를 기본값으로 입력하는 모습과 작성기에서 강조 표시된 텍스트 “이름”을 Liquid 스니펫으로 대체하는 모달을 보여주는 개인화 추가 모달의 GIF입니다.](/docs/ko/assets/img_archive/insert_var_shot.gif?498223ac1dd3a3dab9e1da5eccdf9626)

변수 할당

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

예를 들어 두 개의 커스텀 데이터 정수를 함께 추가하고 싶다고 가정해 보겠습니다.

잘못된 Liquid 예제

사용할 수 없습니다:

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

이 Liquid는 한 줄에 여러 속성을 참조할 수 없기 때문에 작동하지 않으며, 연산 함수가 수행되기 전에 이러한 값 중 하나 이상에 변수를 할당해야 합니다. 커스텀 속성을 두 개 추가하려면 커스텀 속성을 변수에 할당하는 데 한 줄, 추가를 수행하는 데 한 줄, 총 두 줄의 Liquid가 필요합니다.

올바른 Liquid 예제

사용할 수 있습니다:

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

튜토리얼: 변수를 사용하여 잔액 계산하기

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

먼저 assign 태그를 사용하여 current_rewards_balance 의 커스텀 속성을 ‘잔액’이라는 용어로 대체합니다. 즉, 이제 조작할 수 있는 balance 이라는 변수가 생겼습니다.

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

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

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

tip:

모든 메시징에 동일한 변수를 할당하고 계신가요? assign 태그를 반복해서 작성하는 대신 해당 태그를 콘텐츠 블록으로 저장하여 메시지 상단에 넣을 수 있습니다.

콘텐츠 블록을 만듭니다.
콘텐츠 블록에 이름을 지정합니다(공백이나 특수 문자 제외).
페이지 하단에서 편집을 선택합니다.
assign 태그를 입력합니다.

콘텐츠 블록이 메시지 상단에 있는 한, 변수가 메시징에 오브젝트로 삽입될 때마다 선택한 커스텀 속성을 참조합니다!

GitHub 에서 이 페이지를 편집합니다.

New Stuff!