Skip to content

Liquid 참조

Liquid는 Shopify에서 만든 오픈소스 템플릿 언어로, Braze에서 동적 개인화를 구현하는 데 사용됩니다. 모든 사람에게 동일한 정적 메시지를 보내는 대신, Liquid를 사용하면 각 수신자의 특정 프로필 데이터, 동작 또는 언어에 따라 콘텐츠가 변경되는 템플릿을 만들 수 있습니다.

섹션 문서

    Liquid 소개

    Liquid는 메시지와 사용자 데이터 사이의 다리 역할을 합니다. 메시지를 보낼 때 Braze는 텍스트에서 Liquid 구문을 스캔합니다. Liquid를 발견하면 해당 사용자의 관련 데이터를 가져와 메시지가 발송되기 전에 코드를 실제 값으로 대체합니다.

    예를 들어, 정수 데이터 유형인 고객 프로필에서 커스텀 속성을 가져와 해당 값을 가장 가까운 정수로 반올림할 수 있습니다. Liquid 구문 및 사용법에 대한 자세한 내용은 지원되는 개인화 태그를 참조하세요.

    Liquid 템플릿 언어는 오브젝트, 태그, 필터의 사용을 지원합니다.

    • 오브젝트를 사용하면 메시지에 개인화된 속성을 삽입할 수 있습니다.
    • 태그를 사용하면 메시징에 데이터를 삽입하고 조건 로직을 사용하여 특정 조건이 충족될 때 메시지를 보낼 수 있습니다. 예를 들어, 태그를 사용하여 Campaign에 “if” 문과 같은 지능형 로직을 포함할 수 있습니다.
    • 필터를 사용하면 개인화된 속성과 동적 콘텐츠의 형식을 변경할 수 있습니다. 예를 들어, date 필터를 사용하여 2016-09-07 08:43:50 UTC와 같은 타임스탬프를 September 7, 2016과 같은 날짜로 변환할 수 있습니다.

    Liquid 5 지원

    Braze는 Shopify의 Liquid 5까지 지원합니다. Liquid 구현은 구문 개인화 태그 유형과 공백 제어를 지원합니다. 특정 태그에 대한 자세한 내용은 구문 태그를 참조하세요.

    다음의 새로운 배열 및 수학 필터를 메시징을 구축할 때 Liquid에서 사용할 수 있습니다.

    • at_least
    • at_most
    • compact
    • concat
    • sort_natural
    • where

    정의에 대해서는 필터를 참조하세요.

    알아두어야 할 용어

    이 용어들은 지원 수준에 따라 Shopify 설명서에서 재해석한 것입니다.

    용어 정의 예시
    Liquid Shopify에서 만들고 Ruby로 작성된, 동적 콘텐츠를 로드하고 가져오는 데 사용되는 널리 사용되는 고객 대상 템플릿 언어입니다. {{${first_name}}}은 메시지에 사용자의 이름을 삽입합니다.
    오브젝트 변수와 의도된 변수 이름의 위치를 나타내며, 메시지에서 콘텐츠를 표시할 위치를 Liquid에 알려줍니다. {{${city}}}는 메시지에 사용자의 도시를 삽입합니다.
    조건 로직 태그 로직을 생성하고 메시지 콘텐츠의 흐름을 제어하는 데 사용됩니다. Braze에서 조건 로직 태그는 특정 사전 정의된 기준에 따라 메시지에 예외와 변형을 만드는 데 사용됩니다. {% if ${language} == 'en' %}는 사용자가 “영어”를 언어로 지정한 경우 지정된 방식으로 메시지를 트리거합니다.
    필터 Liquid 오브젝트의 출력을 변경, 축소 또는 재형식화하는 데 사용됩니다. 수학 연산을 만드는 데 자주 사용됩니다. {{"Big Sale" | upcase}}는 “Big Sale”이라는 단어가 메시지에서 “BIG SALE”로 표시되도록 합니다.
    Operator 메시지에서 사용자가 어떤 메시지를 받을지에 영향을 줄 수 있는 종속성이나 기준을 만드는 데 사용됩니다. 사용자가 {% custom_attribute.${Total_Revenue} > 0%}로 태그된 메시지에서 정의된 기준을 충족하면 해당 메시지를 받게 됩니다. 그렇지 않으면 설정에 따라 다른 지정된 메시지를 받거나 받지 않습니다.


    New Stuff!