지원되는 개인화 태그

이 참조 문서에서는 지원되는 Liquid 개인화 태그의 전체 목록을 다룹니다.

지원되는 태그 요약

편의를 위해 지원되는 개인화 태그의 요약을 제공합니다. 각 태그 유형과 모범 사례에 대한 자세한 내용은 계속 읽어주세요.

참고

API 트리거 속성정보는 태그당 두 개의 중괄호를 사용해야 합니다: {{api_trigger_properties.${your_api_trigger_property}}}. 세 개의 중괄호(예: {{{...}}})는 유효한 Braze 개인화 구문이 아닙니다. API 트리거 Liquid가 Braze에서 실패하는 이유는 무엇인가요?를 참조하세요.

지원되는 속성

Campaign, 카드, Canvas 속성은 해당하는 메시징 템플릿에서만 지원됩니다. 예를 들어, dispatch_id는 이메일, 푸시, SMS, WhatsApp과 같은 메시징 채널의 Liquid에서 지원되지만, 인앱 메시지나 배너에서는 지원되지 않습니다.

자세한 내용은 소스별 Campaign 및 Canvas 속성을 참조하세요.

Canvas와 Campaign 태그 차이점

다음 태그의 동작은 Canvas와 Campaign 간에 다릅니다:

• dispatch_id 동작이 다른 이유는 Braze가 Canvas 단계를 트리거된 이벤트로 처리하기 때문입니다. 이는 “예약된” 단계(예약 가능한 진입 단계 제외)에서도 마찬가지입니다. 자세한 내용은 디스패치 ID 동작을 참조하세요.
• Canvas에서 {{campaign.${name}}} 태그를 사용하면 Canvas 구성 요소 이름이 표시됩니다. Campaign에서 이 태그를 사용하면 Campaign 이름이 표시됩니다.

URL 내 Campaign 이름

Campaign 및 메시지 배리언트 이름에는 %, 공백, &와 같이 URL에 안전하지 않은 문자가 포함될 수 있습니다. {{campaign.${name}}} 또는 {{campaign.${message_name}}}를 utm_campaign 매개변수와 같은 링크나 쿼리 문자열에 삽입할 때는 URL이 올바르게 파싱되도록 url_encode 필터를 적용하세요. 예를 들어:

1
https://example.com/?utm_campaign={{ campaign.${name} | url_encode }}

가장 최근에 사용한 기기 정보

모든 플랫폼에서 사용자의 가장 최근 기기에 대해 다음 속성을 템플릿으로 사용할 수 있습니다. 사용자가 애플리케이션을 사용한 적이 없는 경우(예: REST API를 통해 사용자를 가져온 경우), 이 값은 모두 null입니다.

기기 통신사, 모델명, 운영 체제의 범위가 매우 넓기 때문에, 이러한 값에 조건부로 의존하는 Liquid를 철저히 테스트하는 것을 권장합니다. 특정 기기에서 사용할 수 없는 경우 이 값은 null입니다.

타겟팅된 앱 정보

인앱 메시지의 경우, Liquid 내에서 다음 앱 속성을 사용할 수 있습니다. 이 값은 앱이 메시징을 요청할 때 사용하는 SDK API 키를 기반으로 합니다.

예를 들어, 다음 Liquid 코드는 요청하는 앱이 목록에 있는 두 개의 API 키 중 하나가 아닌 경우 메시지를 중단합니다:

1
2
3
4
5
6
{% assign allowed_api_keys = 'sdk_api_key_1,sdk_api_key_2' | split: ',' %}
{% if allowed_api_keys contains {{app.${api_id}}} %}
User is in list of apps
{% else %}
{% abort_message("User not in list of apps") %}
{% endif %}

타겟 기기 정보

푸시 알림, 인앱 메시지, 배너의 경우 메시지를 수신하는 기기에 대해 다음 속성을 템플릿으로 사용할 수 있습니다. 푸시 알림, 인앱 메시지 또는 배너에는 사용자가 메시지를 읽는 기기의 속성이 포함될 수 있습니다. 이러한 속성은 Content Cards나 이메일에서는 작동하지 않습니다. 이메일의 경우 메시지가 발송 전에 렌더링되므로, 사용자가 이메일을 여는 기기를 해당 시점에 알 수 없습니다.

기기 통신사, 모델명, 운영 체제의 범위가 매우 넓기 때문에, 이러한 값에 조건부로 의존하는 로직은 철저히 테스트하는 것이 좋습니다. 특정 기기에서 사용할 수 없는 경우 이러한 값은 null입니다.

또한 푸시 알림의 경우, 푸시 토큰이 API를 통해 가져온 경우 등 특정 상황에서는 Braze가 푸시 알림에 연결된 기기를 식별하지 못할 수 있으며, 이 경우 해당 메시지의 값이 null이 됩니다.

기본값 대신 조건 로직 사용하기

경우에 따라 기본값을 설정하는 대신 조건 로직을 사용할 수 있습니다. 조건 로직을 사용하면 커스텀 속성 값에 따라 다른 메시지를 보낼 수 있습니다. 또한 조건 로직을 사용하여 null이거나 빈 속성 값을 가진 고객에게 메시지를 중단할 수도 있습니다.

사용 사례

예를 들어, 고객에게 리워드 잔액 알림을 보내는 경우를 생각해 보겠습니다. 기본값을 사용하여 잔액이 낮거나 null인 고객을 적절히 처리할 좋은 방법이 없습니다.

이 경우 기본값을 설정하는 것보다 더 나은 두 가지 옵션이 있습니다:

1. 잔액이 낮거나, null이거나, 비어 있는 고객에게는 메시지를 중단합니다.

   1
   2
   3
   4
   5
   {% if {{custom_attribute.${balance}}} > 0 %}
   Your rewards balance is {{custom_attribute.${balance}}}
   {% else %}
   {% abort_message() %}
   {% endif %}
   

2. 이러한 고객에게 완전히 다른 메시지를 보냅니다. 예:

   1
   2
   3
   4
   5
   {% if ${first_name} != blank and ${first_name} != null %}
   Hello {{${first_name} | default: 'there'}}, thanks for downloading!
   {% else %}
   Thanks for downloading!
   {% endif %}
   

이 사용 사례에서 이름이 비어 있거나 null인 사용자는 “Thanks for downloading!” 메시지를 받게 됩니다. 실수가 발생했을 때 고객에게 Liquid가 표시되지 않도록 이름에 기본값을 포함하는 것이 좋습니다.

변수 태그

메시지 작성기에서 assign 태그를 사용하여 변수를 만들 수 있습니다. 변수에는 고유한 이름을 사용하는 것이 좋습니다. 지원되는 개인화 태그(예: language)와 유사한 이름으로 변수를 만들면 메시징 로직에 영향을 줄 수 있습니다.

변수를 만든 후에는 메시징 로직이나 메시지에서 해당 변수를 참조할 수 있습니다. 이 태그는 연결된 콘텐츠 기능에서 반환된 콘텐츠를 다시 포맷하고 싶을 때 유용합니다. Shopify의 변수 태그 설명서에서 자세한 내용을 확인할 수 있습니다.

중요

assign 태그 내에서 작은따옴표로 감싼 문자열은 리터럴 문자열로 처리됩니다. 작은따옴표 안의 Liquid 개인화 태그는 보간되지 않습니다. 예를 들어:

1
2
{% assign name_intro = 'My name is {{${first_name}}}' %}
{{ name_intro }}

이 경우 사용자의 이름 대신 My name is {{${first_name}}}이라는 리터럴 텍스트가 출력됩니다.

개인화를 포함하려면 변수를 사용하거나 append 필터로 문자열을 연결하세요. 개인화를 활용한 URL 템플릿에 대해서는 링크 템플릿을 참조하세요.

팁

매번 메시지마다 같은 변수를 할당하고 계신가요? assign 태그를 반복해서 작성하는 대신, 해당 태그를 콘텐츠 블록으로 저장하고 메시지 상단에 배치할 수 있습니다.

1. 콘텐츠 블록을 만드세요.
2. 콘텐츠 블록에 이름을 지정하세요(공백이나 특수 문자 제외).
3. 페이지 하단에서 편집을 선택하세요.
4. assign 태그를 입력하세요.

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

사용 사례

고객이 리워드 포인트를 100포인트 이상 적립하면 상품으로 교환할 수 있도록 허용한다고 가정해 보겠습니다. 이 경우, 추가 구매를 했을 때 포인트 잔액이 100 이상이 되는 고객에게만 메시지를 보내고 싶을 것입니다:

1
2
3
4
5
6
{% assign new_points_balance = {{custom_attribute.${current_rewards_balance} | plus: 50}} %}
{% if new_points_balance >= 100 %}
Make a purchase to bring your rewards points to {{new_points_balance}} and cash in today!
{% else %}
{% abort_message('not enough points') %}
{% endif %}

반복 태그

반복 태그는 코드 블록을 반복적으로 실행하는 데 사용할 수 있습니다. 아래 사용 사례에서는 for 태그를 다룹니다.

사용 사례

Nike 운동화 세일을 진행 중이며, Nike에 관심을 보인 고객에게 메시지를 보내고 싶다고 가정해 보겠습니다. 각 고객의 프로필에는 조회한 제품 브랜드 배열이 있습니다. 이 배열에는 최대 25개의 제품 브랜드가 포함될 수 있지만, 가장 최근 5개의 제품 조회 중 하나로 Nike 제품을 조회한 고객에게만 메시지를 보내려고 합니다.

1
2
3
4
5
6
7
8
9
10
{% for items in {{custom_attribute.${Brands Viewed}}} limit:5 %}
{% if {{items}} contains 'Converse' %}
{% assign converse_viewer = true %}
{% endif %}
{% endfor %}
{% if converse_viewer == true %}
Sale on Converse!
{% else %}
{% abort_message() %}
{% endif %}

이 사용 사례에서는 조회한 운동화 브랜드 배열의 처음 다섯 개 항목을 확인합니다. 해당 항목 중 하나가 Converse이면 converse_viewer 변수를 생성하고 true로 설정합니다.

그런 다음 converse_viewer가 true일 때 세일 메시지를 보냅니다. 그렇지 않으면 메시지를 중단합니다.

이것은 Braze 메시지 작성기에서 반복 태그를 사용하는 간단한 예시입니다. Shopify의 반복 태그 설명서에서 더 많은 정보를 확인할 수 있습니다.

구문 태그

구문 태그를 사용하여 Liquid가 렌더링되는 방식을 제어할 수 있습니다. echo 태그를 사용하여 표현식을 반환할 수 있습니다. 이는 중괄호를 사용하여 표현식을 감싸는 것과 동일하지만, Liquid 태그 내에서 이 태그를 사용할 수 있다는 차이가 있습니다. 또한 liquid 태그를 사용하면 각 태그에 구분 기호 없이 Liquid 블록을 작성할 수 있습니다. liquid 태그를 사용할 때 각 태그는 별도의 줄에 있어야 합니다. 자세한 정보와 예제는 Shopify의 구문 태그 설명서를 확인하세요.

공백 제어를 사용하면 태그 주변의 공백을 제거하여 Liquid 출력의 모양을 더 세밀하게 제어할 수 있습니다.

HTTP 상태 코드

연결된 콘텐츠 호출의 HTTP 상태를 먼저 로컬 변수로 저장한 다음 __http_status_code__ 키를 사용하여 활용할 수 있습니다. 예를 들어:

1
2
3
4
{% connected_content https://example.com/api/endpoint :save connected %}
{% if connected.__http_status_code__ != 200 %}
{% abort_message('Connected Content returned a non-200 status code') %}
{% endif %}

참고

이 키는 엔드포인트가 JSON 오브젝트를 반환하는 경우에만 연결된 콘텐츠 오브젝트에 자동으로 추가됩니다. 엔드포인트가 배열이나 다른 유형을 반환하는 경우, 해당 키는 응답에 자동으로 설정될 수 없습니다.

언어, 최근 로캘, 시간대에 따라 메시지 보내기

특정 로캘에 맞는 메시지를 보내고 싶은 경우가 있습니다. 예를 들어, 브라질 포르투갈어는 일반적으로 유럽 포르투갈어와 다릅니다.

사용 사례: 최근 로캘을 기반으로 현지화하기

다음은 최근 로캘을 사용하여 국제화된 메시지를 더욱 세밀하게 현지화하는 방법에 대한 사용 사례입니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{% if ${language} == 'en' %}
Message in English
{% elsif  ${language} == 'fr' %}
Message in French
{% elsif  ${language} == 'ja' %}
Message in Japanese
{% elsif  ${language} == 'ko' %}
Message in Korean
{% elsif  ${language} == 'ru' %}
Message in Russian
{% elsif ${most_recent_locale} == 'pt_BR' %}
Message in Brazilian Portuguese
{% elsif ${most_recent_locale} == 'pt_PT' %}
Message in European Portuguese
{% elsif  ${language} == 'pt' %}
Message in default Portuguese
{% else %}
Message in default language
{% endif %}

이 사용 사례에서 최근 로캘이 pt_BR인 고객은 브라질 포르투갈어로 메시지를 받고, 최근 로캘이 pt_PT인 고객은 유럽 포르투갈어로 메시지를 받습니다. 처음 두 조건에 해당하지 않지만 언어가 포르투갈어로 설정된 고객은 기본 포르투갈어 유형으로 지정한 메시지를 받게 됩니다.

사용 사례: 시간대별로 사용자 타겟팅하기

시간대별로 사용자를 타겟팅할 수도 있습니다. 예를 들어, 미국 동부 표준시(EST)에 있는 사용자에게는 하나의 메시지를 보내고, 태평양 표준시(PST)에 있는 사용자에게는 다른 메시지를 보낼 수 있습니다. 이를 위해 현재 시간을 UTC로 저장하고, if/else 문을 사용자의 현재 시간과 비교하여 올바른 시간대에 맞는 메시지를 보냅니다. 사용자의 현지 시간대에 맞춰 Campaign을 전송하도록 설정하여 적절한 시간에 Campaign이 도달하도록 해야 합니다.

다음은 오후 2시에서 3시 사이에 각 시간대별로 특정 메시지를 전달하는 방법에 대한 사용 사례입니다.

1
2
3
4
5
6
7
8
{% assign hour_in_utc = 'now' | date: '%H' | plus:0 %}
{% if hour_in_utc >= 19 && hour_in_utc < 20 %}
It is between 2:00:00 pm and 2:59:59 pm ET!
{% elsif hour_in_utc >= 22 && hour_in_utc < 23 %}
It is between 2:00:00 pm and 2:59:59 pm PT!
{% else %}
{% abort_message %}
{% endif %}

랜덤 숫자로 메시지 보내기

{% random %} 태그는 랜덤 숫자를 반환합니다. A/B 스타일 로직, 샘플링 또는 메시지 콘텐츠 변형에 사용할 수 있습니다.

사용 사례: 사용자에게 랜덤 배리언트 보내기

1
2
3
4
5
6
7
{% capture roll_str %}{% random %}{% endcapture %}
{% assign roll = roll_str | plus: 0 %}
{% if roll < 0.5 %}
Show variant A
{% else %}
Show variant B
{% endif %}

이커머스 장바구니 태그

shopping_cart 태그는 이커머스 유기한 장바구니 및 유기한 결제 이커머스 Canvas 사용 사례에서 사용자의 장바구니 내용에 접근합니다. CART_ID를 실제 장바구니 ID 값(예: {{context.${cart_id}}})으로 교체하세요.

1
{% shopping_cart CART_ID :abort_if_not_abandoned false %}

이 예시의 abort_if_not_abandoned 매개변수는 ecommerce.checkout_started 이벤트와 함께 사용할 때 유기한 결제 사용 사례에만 적용됩니다. 유기한 장바구니 사용 사례에는 적용되지 않습니다. 자세한 내용은 abort_if_not_abandoned를 참조하세요.