이 페이지는 AI로 자동 번역되었으며 부정확한 내용이 포함될 수 있습니다. 번역 오류를 신고하려면 페이지 오른쪽 목차 아래에 있는 피드백 기능을 사용하세요.

자주 묻는 질문

이 페이지에서는 Liquid에 대해 자주 묻는 질문에 대한 답변을 확인할 수 있습니다.

참고

Braze는 현재 Shopify의 Liquid를 100% 지원하지 않으며, 설명서에서 설명하려고 시도한 특정 부분만 지원합니다. 오류 발생 위험이나 지원되지 않는 Liquid 사용을 줄이기 위해 Liquid를 사용하는 모든 메시지를 발송 전에 테스트하세요.

Braze에서의 Liquid

Braze에서 Liquid 스니펫을 어떻게 사용하나요?

대부분의 경우 Campaign이나 Canvases로 이동한 후, 이메일 메시지 본문이나 Segments 등의 영역에서 개인화 모달을 통해 Liquid를 삽입하여 Liquid 스니펫을 활용할 수 있습니다.

더 자세히 알아보려면 어디를 참고하면 되나요?

Liquid에 대해 더 알아보려면 Braze Learning의 가이드 학습 경로 Liquid를 활용한 동적 개인화를 확인하세요. 또한 Liquid 사용 사례 라이브러리에서 영감을 얻고 Liquid를 사용한 다양한 개인화 예시를 참고할 수 있습니다.

개인화에 Liquid와 연결된 콘텐츠를 사용하는 것의 차이점은 무엇인가요?

Braze 연결된 콘텐츠는 Liquid 태그의 한 예입니다. 마찬가지로 개인화에 사용되지만, 이 데이터는 Braze 내에 저장된 데이터가 아닌 외부 엔드포인트에서 가져옵니다. 메시지 개인화를 확장하는 방법에 대해 자세히 알아보려면 전용 연결된 콘텐츠 섹션을 확인하세요.

Liquid 템플릿이란 무엇인가요?

Braze에서 Liquid를 사용하는 가장 일반적인 방법입니다. Liquid 템플릿은 고객 프로필의 데이터를 메시지에 가져오는 것을 의미합니다. 이 데이터는 사용자의 이름부터 이벤트 트리거된 메시지의 커스텀 이벤트까지 다양할 수 있습니다.

지원되는 Liquid 태그의 전체 목록은 지원되는 개인화 태그를 참조하세요.

Liquid를 사용하면 데이터 포인트가 기록되나요?

아니요.

개인화 태그와 데이터 소스

Liquid를 사용하여 개인화된 인사말을 보내려면 어떻게 하나요?

사용자의 이름을 사용한 개인화된 인사말의 경우, {{${first_name}}}, {{${last_name}}} 같은 표준 고객 프로필 속성을 가져올 수 있습니다.

또한 Liquid {% if X %}문을 사용하여 요일이나 커스텀 속성 등 다양한 조건에 따라 조건부 렌더링을 수행할 수 있습니다. 조건문에서 사용할 수 있는 지원되는 Liquid 연산자에 대한 자세한 내용은 연산자를 확인하세요.

사용자의 위치를 기반으로 메시지를 개인화하려면 어떻게 하나요?

사용자의 위치에 대한 기본 속성이 있습니다: {{${most_recent_location}}}.

{{campaign.${name}}}과 {{campaign.${message_name}}}의 차이점은 무엇인가요?

{{campaign.${name}}}과 {{campaign.${message_name}}}은 모두 지원되는 Liquid 개인화 태그입니다. 두 태그 모두 Campaign 속성을 참조합니다. {{campaign.${name}}}은 Campaign의 이름을 나타내고, {{campaign.${message_name}}}은 메시지 배리언트의 이름입니다.

URL 및 쿼리 문자열 사용(예: 이름에 % 또는 공백이 포함된 경우)에 대해서는 URL에서의 Campaign 이름을 참조하세요.

중첩된 오브젝트에서 Liquid를 어떻게 사용하나요?

Braze에는 메시지에서 사용할 수 있는 Segments용 Liquid 코드를 생성하는 내장 기능이 있습니다. 구체적으로, 오브젝트 내에서 여러 기준과 일치하는 Segment를 생성할 수 있습니다.

자세한 내용은 다중 기준 세분화를 확인하세요.

이벤트가 트리거하는 메시지를 개인화하기 위해 이벤트 속성을 어떻게 사용하나요?

api_triggered_property 태그를 사용하여 API 트리거 이벤트의 등록정보에 접근할 수 있습니다: {{api_trigger_properties.${attribute_key}}}.

Braze는 Liquid에서 배열의 배열을 지원하나요?

Liquid는 기본적으로 배열의 배열을 지원하지 않습니다. 값을 쉼표로 구분된 문자열의 배열로 저장하고 필요할 때 split 필터를 사용하여 구문 분석하세요.

변수와 구문

Liquid로 변수를 어떻게 할당하나요?

assign 태그를 사용하여 변수를 생성하고 할당할 수 있습니다. 이렇게 하면 메시지 작성기에서 변수가 생성되며, 메시지 전체에서 참조할 수도 있습니다.

`assign`과 `capture`는 언제 사용해야 하나요?

assign과 capture는 모두 Liquid 변수를 생성하지만, 서로 다른 용도로 사용됩니다:

assign은 부울, 숫자 또는 간단한 문자열과 같은 단일 값을 저장하는 간단한 변수에 사용합니다. 같은 줄에서 단일 필터를 적용할 수도 있습니다.
capture는 여러 변수, 문자열 또는 복잡한 표현식을 포함할 수 있는 텍스트 블록을 저장하는 데 사용합니다.

다른 Liquid 변수나 커스텀 속성을 매개변수로 활용하는 URL과 같이 단일 assign 문으로는 너무 복잡한 값에 capture를 사용하세요. 또한 연결된 콘텐츠 호출의 본문에서 Liquid 변수를 구현할 때도 capture가 선호됩니다.

예시

{% comment %}Use assign for custom attributes{% endcomment %}
{% assign name = {{custom_attribute.${first_name}}} %}
{% assign price = {{custom_attribute.${price}}} | plus: 0 %}

{% comment %}Use assign for a simple variable{% endcomment %}
{% assign discount_label = "20% off" %}
Hello {{ customer.first_name | default: "there" }}, enjoy {{ discount_label }} on your next order!

{% comment %}Use capture for complex strings{% endcomment %}
{% capture greeting %}Hello, {{custom_attribute.${first_name}}}! Your order #{{custom_attribute.${order_id}}} is ready.{% endcapture %}
{{ greeting }}

{% comment %}Use capture to create conditional content{% endcomment %}
{% capture promo_block %}
{% if customer.vip == true %}
As a VIP member, you get free shipping.
{% else %}
Join our VIP program to unlock free shipping.
{% endif %}
{% endcapture %}

Liquid 변수는 제목란과 본문 사이에서 유지되나요?

아니요. Braze는 각 메시지 구성요소(제목란, HTML 본문, 프리헤더, 푸시 제목 등)를 별도로 렌더링합니다. 한 필드에서 수행한 할당이나 캡처는 다른 필드에서 사용할 수 없습니다. 값이 필요한 각 필드에서 Liquid 또는 연결된 콘텐츠 호출을 반복하세요.

for 루프 로직이란 무엇이며, 어떻게 사용하나요?

for 루프는 반복 태그라고도 합니다. Liquid 스니펫에서 for 루프 로직을 사용하면 조건이 충족될 때까지 Liquid 블록을 순환할 수 있습니다.

Braze에서는 배열 커스텀 속성의 항목을 확인하거나, 카탈로그, 선택, 또는 연결된 콘텐츠 호출 응답에서 반환된 값 및 오브젝트 목록을 확인하는 데 사용할 수 있습니다. 구체적으로, for 루프 로직을 메시징의 일부로 사용하여 제품의 재고 여부나 제품의 최소 평점 충족 여부를 확인할 수 있습니다.

예를 들어, “Games”라는 카탈로그에 “cheap_games”라는 선택이 있다고 가정해 보겠습니다. “cheap_games”에 있는 게임의 제목을 가져오려면 다음 Liquid 스니펫을 사용할 수 있습니다:

{% catalog_selection_items Games cheap_games %}
{% for item in items %}
 Get this game: {{ item.title }}
{% endfor %}

설정된 조건이 충족되면 메시지가 진행될 수 있습니다. 이 로직을 사용하면 다양한 조건에 대해 Liquid 블록을 반복하는 대신 시간을 절약할 수 있는 유용한 방법입니다.

중단 로직이란 무엇이며, 어떻게 사용하나요?

중단 로직을 사용하면 조건이 충족될 때 메시지 발송을 중지할 수 있습니다. 이는 불완전한 메시지가 사용자에게 발송되는 것을 방지하는 데 특히 유용합니다. 마케팅 Campaign에서의 중단 로직 예시에 대해 자세히 알아보려면 메시지 중단을 참조하세요.

`abort_message` 태그 안에서 Liquid를 사용할 수 있나요?

아니요. {% abort_message %} 태그는 따옴표로 묶인 정적 문자열만 허용하며, Liquid 개인화는 지원하지 않습니다. 조건부 중단 동작이 필요한 경우 태그 앞에서 다른 Liquid 로직을 사용하세요.

Canvas, 카탈로그 및 트리거 등록정보

Braze에서 API 트리거 Liquid가 실패하는 이유는 무엇인가요?

일반적인 원인은 중괄호가 한 쌍 더 추가된 경우입니다. 예를 들어, {{{api_trigger_properties.${attribute_key}}}}는 유효한 Braze 개인화 구문이 아닙니다. 정확히 두 개의 여는 중괄호와 두 개의 닫는 중괄호를 사용하세요: {{api_trigger_properties.${attribute_key}}}.

Canvas 컨텍스트 등록정보에 크기 제한이 있나요?

Braze는 Canvas 컨텍스트 등록정보에 대해 엄격한 제한을 적용하지 않지만, 페이로드를 약 1KB(~1,000자) 이하로 유지하세요. 더 큰 오브젝트는 메모리 사용량을 증가시키고 대량 발송 시 메시지 렌더링을 지연시킬 수 있습니다.

대시보드에서 특정 데이터 유형을 미리볼 때 Liquid 오류가 발생하는 이유는 무엇인가요?

일부 Canvas 컨텍스트 등록정보 유형은 비교나 수학 연산에 사용하기 전에 Liquid에서 형변환이 필요합니다. 예를 들어, 숫자 동작이 필요한 경우:

{{context.${property_name} | plus: 0}}

카탈로그 Liquid 스니펫이 중단 메시지를 반환하는 이유는 무엇인가요?

카탈로그 Liquid 스니펫이 발송 중 중단되는 경우, 대량 또는 완전 동적 선택을 사용하는 대신 개인화 메뉴에서 개별 카탈로그 항목을 선택하여 스니펫을 다시 생성하세요. 카탈로그 및 선택을 참조하세요.

Content Blocks와 메시지 작성기

Content Blocks를 사용하는 메시지에 여분의 공백이 생기는 이유는 무엇인가요?

Liquid가 포함된 Content Blocks를 사용하는 발송된 메시지에서 여분의 공백이 발견되면, 조건문 내에 불필요한 단락이나 줄 바꿈이 있을 수 있습니다. 조건문을 여러 줄에 걸쳐 작성하지 말고 한 줄에 작성하세요.

예시

{% if {{custom_attribute.${has_discount}}} == true %}Discounted Item{% elsif {{custom_attribute.${is_new_arrival}}} == true %}New Arrival{% else %}Regular Item{% endif %}

드래그 앤 드롭 검색 도구의 Row에서 Content Block이 표시되지 않는 이유는 무엇인가요?

일부 Content Blocks는 드래그 앤 드롭 편집기 검색의 Row 아래에 표시되지 않습니다. 콘텐츠 탭(고급)에서 HTML 블록을 추가한 다음, 해당 HTML 블록에 Content Block Liquid 태그를 삽입하여 블록 콘텐츠를 렌더링하세요.

드래그 앤 드롭 Content Block 미리보기가 작성 보기와 다른 이유는 무엇인가요?

Liquid로 Content Block을 템플릿화하면, 블록의 모바일 미디어 쿼리가 블록을 메시지에 직접 드래그할 때와 동일한 방식으로 미리보기에 적용되지 않을 수 있습니다. 블록을 드래그하면 레이아웃은 유지되지만 소스 블록과 분리되므로, 이후 블록 편집 사항이 메시지에 자동으로 업데이트되지 않습니다.

메시지 작성기에서 이벤트 등록정보 값을 미리보려면 어떻게 하나요?

커스텀 사용자로 미리보기를 사용하고 미리보기할 사용자에 대한 샘플 커스텀 이벤트 등록정보 값을 입력하세요. 이는 중단을 트리거하지 않는 미리보기 값이 필요한 중단 로직이 포함된 메시지에도 유용합니다.

이메일 메시지에서의 Liquid

메시지가 “Invalid from email address for recipient:”로 중단되는 이유는 무엇인가요?

이 중단은 보낸 사람 주소의 Liquid가 누락된 변수, 추가 공백 또는 허용되지 않는 문자 등 잘못된 구문을 생성할 때 발생합니다. 테스트 사용자로 미리보기하고 렌더링된 보낸 사람 주소가 구성된 발송 도메인과 일치하는지 확인하세요.

동적 회신 주소를 어떻게 만드나요?

워크스페이스에서 동적 회신 주소 구성을 지원하는 경우 회신 주소 필드에서 Liquid를 사용하세요. 필요에 따라 보낸 사람 표시 이름 설정과 함께 사용하세요. 워크스페이스별 옵션에 대해서는 이메일 설정을 참조하세요.

Liquid 오류 문제 해결

“Unexpected end token” Liquid 오류가 표시되는 이유는 무엇인가요?

이 오류는 일반적으로 중괄호가 추가되거나 누락되었음을 나타냅니다. {{ }}를 다른 Liquid 태그 표현식 안에 중첩하지 마세요. 예를 들어, 속성 참조를 추가 중괄호 쌍으로 감싸는 대신 {{custom_attribute.${date_of_birth} | date: '%s'}}를 사용하세요.

인앱 메시지에서 연결된 콘텐츠 재시도를 사용할 수 없는 이유는 무엇인가요?

재시도가 포함된 {% connected_content %} 태그는 일부 인앱 메시지 형식을 포함한 모든 메시지 유형에서 지원되지 않습니다. 재시도 매개변수를 제거하거나 재시도 연결된 콘텐츠 호출에 지원되는 채널을 사용하세요.

New Stuff!