메시지 맞춤 설정 참조

예상 14분 읽기

업데이트 2025년 8월 8일 오전 9:38 EST

마케팅 메시지와 고객 허브에서 Klaviyo의 맞춤 설정 변수 또는 태그를 사용하여 구독자에게 맞춤 경험을 제공하는 방법을 알아보세요.

개인화 태그는 이메일(이메일 제목 포함), SMS/MMS 메시지, 푸시 알림 및 고객 허브에서 사용할 수 있습니다. 이 문서에서는 사용 가능한 특정 태그, 그 구조 및 양식, 사용자 지정하는 방법에 대해 간략하게 설명합니다. 개인 맞춤 설정을 추가하는 방법을 알아보려면 메시지에 개인 맞춤 설정 추가하기 도움말 문서를 참조하세요.

맞춤 설정 태그는 이전에 템플릿 태그 및 변수 구문이라고 불렀습니다.

맞춤 설정 태그 관련 정보

텍스트 필드에 태그를 입력하면 아래 표의 왼쪽에 있는 문장과 같이 표시됩니다. 메시지가 표시되면 태그는 수신자의 프로필 또는 이벤트 세부 정보의 정보로 대체되며 오른쪽에 있는 문장과 같이 표시됩니다.

안녕하세요 {{ first_name }} {{ last_name }} 님, 사용자님이 가장 좋아하는 색은 {{ person|lookup:'Favorite Color' }}입니다.

안녕하세요 조지 워싱턴 님, 사용자님이 가장 좋아하는 색은 녹색입니다.

프로필 맞춤 설정은 일반적으로 first_name 및 last_name 같은 몇 가지 특수 태그를 제외하고는 일반적으로 person으로 시작합니다. 지표 트리거 플로우에서 사용할 수 있는 이벤트 변수는 event로 시작합니다. 조직 태그(회사 이름 및 주소 등)는 organization으로 시작합니다.

모든 맞춤 설정 태그는 대소문자를 구분하며 참조하는 속성 이름과 정확히 일치해야 합니다. 태그의 철자가 올바른지 확인하고 프로필에 표시되는 것과 동일한 대소문자를 사용하세요.

프로필 맞춤 설정

프로필 맞춤 설정을 통해 메시지에서 특별한 Klaviyo 속성을 표시할 수 있습니다. 아래 목록은 모든 프로필 맞춤 설정(즉, 기본 Klaviyo 속성)을 다룹니다. 이메일 편집기의 맞춤 설정 메뉴 또는 SMS 및 푸시 메시지의 미리보기 모달에서 프로필 맞춤 설정 태그를 선택할 수 있습니다.

메시지에 사용자 지정 속성을 추가하려면 사용자 지정 맞춤 설정 섹션으로 이동하세요.

태그	프로필 속성
`{{ email }}`	이메일
`{{ first_name }}`	이름
`{{ last_name }}`	성
`{{ person.organization }}`	수신자 조직
`{{ person\|lookup:"$address1" }}`	주소 1
`{{ person.id }}`	고유 ID($id/외부 ID)
`{{ person\|lookup:"$latitude" }}`	위도
`{{ person\|lookup:"$longitude" }}`	경도
`{{ person.KlaviyoID }}`	Klaviyo ID
`{{ person.full_name }}`	전체 이름
`{{ person.title }}`	직위
`{{ person.phone_number }}`	전화번호
`{{ person\|lookup:'$address2' }}`	주소 2
`{{ person.City }}`	도시
`{{ person.Region }}`	주/도
`{{ person.Country }}`	국가
`{{ person.Zipcode }}`	우편번호
`{{ person\|lookup:"$source" }}`	출처
`{{ person\|lookup:"$consent" }}`	동의
`{{ person\|lookup:'$consent_form_id' }}`	$consent_form_id
`{{ person\|lookup:'$consent_form_version' }}`	$consent_form_version
`{{ person\|lookup:'$consent_method' }}`	$consent_method
`{{ person\|lookup:"$timezone" }}`	수신자 시간대
`{{ person\|lookup:'$consent_timestamp' }}`	$consent_timestamp
`{{ person\|lookup:'$phone_number_region' }}`	$phone_number_region
`{{ person.ViewedItems }}`	최근 조회한 품목
`{{ person\|lookup:"Expected Date Of Next Order" }}`	다음 주문 예상 날짜

사용자 정의 개체 태그

사용자 정의 개체 태그를 활성화하면 플로우 및 캠페인 전송에서 개체 데이터를 사용할 수 있습니다.

태그를 사용하여 개체 ID를 가져오거나 개수를 반환하는 방법과 관련하여 구체적인 예시를 보려면 태그 참조를 검토하세요.

템플릿에서 사용자 정의 개체 데이터를 사용하려면 먼저 개체를 만들어야 합니다. {{ object }} 태그는 개체가 플로우를 트리거한 경우에만 사용할 수 있습니다.

태그	결과
`{{ object.object_property }}`	플로우를 트리거한 개체를 반환합니다.
`{{ object \| lookup:'object_property' }}`	플로우를 트리거한 개체를 반환합니다.
`{{ object_filter.object_filter_name.object_property}}`	개체 필터에서 단일 개체 반환
`{{ object_filter.object_filter_name \| lookup: 'object_property' }}`	개체 필터에서 단일 개체 반환
`{{ object_filter.object_filter_name }}`	개체 필터에서 개수 반환
`{% customobject id={{ event.object_id }} as alias %}`	ID로 개체 검색
`{% customobjects object_type_title=“Title” as alias %} {% for object_instance in alias %} {{ object_instance.record }} {% endfor %} {% endcustomobjects %}`	하나의 프로필에서 개체에 대한 모든 레코드 가져오기

조직 태그

조직 태그를 사용하면 회사 또는 조직에 대한 정보를 메시지에 포함할 수 있습니다. 이 정보를 관리하려면 화면 하단 좌측에 있는 조직 이름을 클릭한 후 설정 > 조직 > 연락처 정보를 선택하세요. 모든 조직 태그는 organization으로 시작합니다. 조직 태그 목록은 아래 표를 참조하세요.

조직 태그	설명
`{{ organization.name }}`	조직 이름
`{{ organization.url }}`	조직의 웹사이트
`{{ organization.full_address }}`	도시, 주/도 및 우편번호를 포함한 조직의 전체 주소
`{{ organization.street_address }}`	조직의 도로명 주소
`{{ organization.street_address2 }}`	조직 주소의 두 번째 부분(예: 아파트 또는 동 호수)
`{{ organization.city }}`	조직의 도시
`{{ organization.region }}`	조직의 주, 도 또는 지역
`{{ organization.zip_code }}`	조직의 우편번호

태그 링크 및 미리보기

링크 및 미리보기 태그를 사용하면 수신자가 구독 기본 설정을 관리하고 브라우저에서 메시지를 볼 수 있습니다. 이는 다음을 포함합니다.

구독 취소
기본 설정 관리
웹 보기
텍스트 미리보기

이러한 태그는 이메일 템플릿에만 지원됩니다. 미리보기 이메일에서 이러한 링크 중 하나를 클릭하면, 실시간 동의 페이지나 미리보기가 아닌 자리 표시자 페이지로 이동하게 됩니다.

구독 취소

Klaviyo는 모든 이메일에 구독 취소 링크를 요구합니다. 링크에 '구독 취소'라는 간단한 구독 취소 태그를 사용하거나 따옴표 안에 직접 텍스트를 추가하세요.

태그	산출 값
`{% unsubscribe %}`	구독 취소
더 이상 이메일을 수신하지 않으려면 `{% unsubscribe 'click here' %}`.	더 이상 이메일을 수신하지 않으려면 여기를 클릭하세요.

또는 {% unsubscribe_link %} 태그를 사용하여 구독 취소 URL을 생성할 수 있습니다. 이 태그는 전체 링크된 단어나 구문을 생성하는 대신 구독 취소 URL만 생성합니다. 템플릿의 스타일에 설정된 링크 색상과 다른 색상을 구독 취소 링크에 사용하거나 텍스트 링크 대신 링크 버튼이나 이미지를 사용하려면 이 태그를 사용하세요.

태그	산출 값
`깔끔한 <a href="{% unsubscribe_link %}" >unsubscribe</a> 링크입니다.`	깔끔한 구독 취소 링크입니다.

수신자가 구독 취소 링크를 클릭하면 맞춤 구성할 수 있는 확인 페이지로 이동합니다.

기본 설정 관리

기본 설정 페이지를 통해 수신자가 자신의 기본 설정을 업데이트할 수 있으므로 더욱 효과적으로 메시지를 세분화하고 타겟팅할 수 있습니다. 수신자별로 이 페이지로 연결되는 링크를 포함하려면 기본 설정 관리 태그를 사용하세요.

목록별 및 일반 관리 기본 설정 페이지를 만들 수 있습니다. 하나의 목록에만 메시지를 보내면 목록 전용 페이지가 전송됩니다. 일반 기본 설정 관리 페이지는 세그먼트, 목록의 조합 및 목록 트리거가 아닌 플로우로 보낼 때 사용됩니다. 기본 설정 페이지 관리에 대해 자세히 알아보세요.

'기본 설정 관리'라고 표시된 링크에 간단한 기본 설정 관리 태그를 사용하거나 따옴표 안에 직접 텍스트를 추가하세요.

태그	산출 값
`{% manage_preferences %}`	기본 설정 관리
기본 설정을 업데이트하고 싶으신가요? `{% manage_preferences 'Click here' %}`.	기본 설정을 업데이트하고 싶으신가요? 여기를 클릭하세요.

또는 {% manage_preferences_link %} 태그를 사용하여 기본 설정 관리 URL을 생성할 수 있습니다. 이 태그는 전체 링크된 단어나 구문을 생성하는 대신, 수신자의 기본 설정 페이지에 대한 URL만 생성합니다. 템플릿 스타일에 설정된 링크 색상과 다른 색상을 링크에 사용하거나 텍스트 링크 대신 링크 버튼이나 이미지를 사용하려는 경우 이 태그를 사용합니다.

태그	산출 값
`깔끔한 <a href="{% manage_preferences_link %}" >기본 설정 관리</a> 링크입니다.`	깔끔한 기본 설정 관리 링크입니다.

웹 보기

수신자에게 웹 브라우저에서 이메일을 확인할 수 있는 옵션을 제공하려면 웹 보기 태그를 사용하면 됩니다.

태그	산출 값
`{% web_view %}`	브라우저에서 보기
이 이메일이 보이지 않나요? `{% web_view 'Open in your browser' %}`.	이 이메일이 보이지 않나요? 브라우저에서 엽니다.
`깔끔한 <a href="{% web_view_link %}">웹 보기</a> 링크입니다.`	깔끔한 웹 보기 링크입니다.

텍스트 미리보기

템플릿 본문 안에 미리보기 텍스트를 표시하고 싶은 경우도 있습니다. {% render_variable preview_text %} 태그를 사용하여 이메일 미리보기/설정 화면에서 설정한 모든 미리 보기 텍스트를 참조할 수 있습니다.

이메일 미리보기 화면에서 미리보기 텍스트를 업데이트하면 이 태그에 업데이트된 미리보기 텍스트가 표시됩니다.

사용자 지정 맞춤 설정 및 이벤트 태그

사용자 지정 태그는 누군가의 생일이나 연락처 기본 설정과 같은 사용자 지정 프로필 속성(즉, 특정 Klaviyo 속성 및 이벤트 이외의 연락처에 대해 수집한 모든 데이터)을 참조합니다. 이벤트 태그는 특정 이벤트의 데이터(예: 주문 접수 이벤트)를 참조하며 해당 이벤트가 트리거하는 플로우에서만 사용할 수 있습니다.

사용자 지정 태그를 추가하려면 이메일 텍스트 필드에서 맞춤 설정을 클릭하고 태그를 찾습니다. 이벤트 태그를 추가하려면 메시지를 미리 보고 미리보기 데이터에서 이벤트 변수 태그를 복사합니다. 또는 아래에 설명된 형식을 사용하여 템플릿에 사용자 지정 태그를 수동으로 추가할 수 있습니다.

태그 형식	설명	예시
`{{ person.property_name }}`	간단한 프로필 맞춤 설정 태그	`{{ person.Birthday }}`
`{{ person\|lookup:'property name' }}`	프로필 맞춤 설정 태그(속성 이름에 공백이나 특수 문자가 포함된 경우)	`{{ person\|lookup:'Favorite Color' }}`
`{{ event.property_name }}`	간단한 이벤트 변수 태그	`{{ event.URL }}`
`{{ event\|lookup:'property name' }}`	이벤트 변수 태그(변수 이름에 공백이나 특수 문자가 포함된 경우)	`{{ event\|lookup:'$value' }}`
`{{ event.property.nested_variable }}`	이벤트 변수 태그(이벤트 변수가 이벤트 데이터에 중첩된 경우)	`{{ event.extra.checkout_url }}`
`{{ event\|lookup:'property name'\|lookup:'nested variable name' }}`	이벤트 변수 태그(이벤트 변수가 공백이나 특수 문자가 포함된 이름을 가진 다른 변수 안에 중첩된 경우)	`{{ event\|lookup:'Coupon Codes'\|lookup:'0' }}`

공백이나 특수 문자가 없는 태그에는 점(.) 표기를 사용합니다. 속성 이름에 공백이나 특수 문자(예: $)가 포함된 경우 Lookup 표기를 사용합니다.

중첩된 속성의 경우 하나의 속성 이름이 Lookup 표기를 사용하는 경우, 이후의 모든 속성도 Lookup 표기를 사용해야 한다는 점에 유의하세요. 즉, event|lookup:'Collection Names'|lookup:'0'은 올바르지만 event|lookup:'Collection Names'.0은 올바르지 않습니다.

필터로 태그 맞춤 설정하기

태그가 표시되는 방식을 맞춤 설정하려면 템플릿 필터를 적용하세요. 필터를 사용하여 제목 대소문자를 적용하고 숫자의 소수점 이하 자릿수를 설정하는 등의 작업을 할 수 있습니다. 가장 일반적인 두 가지 필터는 기본값과 제목입니다.

기본값 필터는 메시지 수신자에게 해당 속성이 설정되어 있지 않은 경우 기본값이 표시되도록 설정합니다. 아래 예시에서는 수신자의 이름이나 좋아하는 음식이 Klaviyo 프로필에 설정되어 있지 않은 경우 '고객(또는 friend)'과 '맛있는 간식'이 기본값으로 설정되어 있습니다.

맞춤 설정 태그가 있는 텍스트	산출 값
안녕하세요 `{{ first_name\|default:'friend' }}`님, `{{ person\|lookup:'Favorite Food'\|default:'tasty treats' }}`을 원하시나요?	고객님, 맛있는 간식을 원하시나요?

title 필터를 사용하면 텍스트 태그에 제목 대/소문자를 적용하여 메시지가 전송된 후 일관되게 표시되도록 할 수 있습니다. 예를 들어 일부 구독자는 가입 양식을 작성할 때 대문자 또는 소문자를 모두 사용할 수 있습니다. 필터를 사용하지 않으면 양식을 작성할 때 처음에 사용한 대/소문자를 그대로 사용할 수 있습니다. 그러나 제목 필터는 대소문자를 수정하여 이름이 올바르게 표시되게 합니다.

맞춤 설정 태그가 있는 텍스트	산출 값
안녕하세요 `{{ first_name\|title }}` 님, 최근 출시된 제품 보셨나요?	안녕하세요 Elise 님, 최근 출시된 제품 보셨나요?

메시지에는 수십 가지 다양한 필터를 사용할 수 있습니다. 필터를 사용하여 태그를 맞춤 설정하는 방법에 대해 자세히 알아보세요.

날짜 태그

날짜 태그를 사용하면 이메일에 날짜 정보를 빠르게 삽입할 수 있습니다. 날짜는 계정의 표준 시간대이며 메시지를 보낸 날짜와 시간을 반영합니다.

{{ today }} 태그는 가장 일반적인 날짜 태그 중 하나로, 메시지가 전송될 때 타임스탬프를 자동으로 채웁니다. 오늘(today) 태그를 사용하려면 다음 코드 구문을 템플릿에 붙여넣습니다.

{% today "%Y-%m-%d" as today %} {{ today }}

단, 앞의 코드 없이 {{ today }} 태그를 사용하면 아무 것도 렌더링되지 않으므로 전체 코드 구문이 필요합니다.

날짜 태그를 사용하거나 맞춤 설정하는 방법을 알아보려면 템플릿의 날짜 태그에 관한 문서를 참조하세요.

통화 태그

완료된 주문, 장바구니에 추가됨 같은 이벤트 데이터에는 종종 금전적 가치(예: 제품 가격 또는 고객 장바구니 가치)가 관련되어 있습니다. 해당 값에 해당 국가의 통화 서식을 적용하려면 {% currency_format … %} 태그를 사용하세요.

예를 들어 아래 시작된 결제 지표의 $value 필드를 살펴보겠습니다.

변수 {{ event|lookup:"$value" }}만 사용하면 이 속성은 다음과 같이 이메일에 통화 기호 없이 소수점 이하 한 자리만 렌더링됩니다.

그러나 통화 형식 태그 {% currency_format event|lookup:"$value" %}을(를) 사용하면 다음과 같이 통화 기호와 정확한 소수점 이하 자릿수를 사용하여 숫자가 렌더링됩니다.

통화 형식 태그를 사용하려면 {% currency_format PLACEHOLDER %}의 자리 표시자 텍스트를 변수로 바꿉니다.

예를 들어 변수가 {{ event.item.price }}인 경우 전체 통화 형식 태그는 {% currency_format event.item.price %}이(가) 됩니다. 태그에 필터(예: 속성이 비어 있는 경우 기본값)가 포함되어 있는 경우 {% currency_format event.item.price|default:”0” %} 태그에도 필터를 포함하세요.

국가 선택 방법

메시지의 통화 형식을 설정할 수 있는 곳은 다음 두 곳입니다.

전체 계정의 경우
설정 > 조직 > 조직 언어 및 지역 형식으로 이동하여 조직 언어를 선택하세요.
특정 메시지의 경우
해당 템플릿의 스타일 탭의 통화 섹션에서 단일 메시지에 대해 다른 통화 형식을 선택하세요.

currency_format 태그 문제 해결하기

이 태그는 숫자(예: 10, 24.56)인 변수에만 지원됩니다. 통화 기호가 포함된 속성(예: $40, $76.30)은 문자열이며 currency_format 태그는 이를 변경할 수 없습니다.

조건문

조건부 태그를 사용하면 특정 기준을 충족하는 수신자에게는 메시지에 콘텐츠를 포함시키고 그렇지 않은 수신자에게는 포함하지 않을 수 있습니다. 수신자별로 메시지를 맞춤 설정할 수 있는 강력한 제어 기능을 제공합니다.

If 문구

If 문구를 사용하면 프로필 또는 이벤트 데이터를 기반으로 수신자가 받게되는 콘텐츠를 제어할 수 있습니다.

아래 예시에서는 로열티 포인트가 150점 이상인 수신자에게 첫 번째 줄의 텍스트가 표시됩니다. 150점보다 작지만 0점보다 크면 두 번째 줄이 표시됩니다. 로열티 포인트가 없는 수신자에게는 세 번째 메시지가 표시됩니다.

{% if person|lookup:'Loyalty Points' > 150 %}
안녕하세요 VIP님! 항상 무료 배송 & 무료 반품 혜택을 드립니다.
{% elif person|lookup:'Loyalty Points' > 0 %}
현재 포인트는 {{ person|lookup:'Loyalty Points' }}점이며, 150점만 있으면 VIP가 될 수 있습니다. 
{% else %}
VIP 프로그램에 대해 들어보셨나요? 지금 웹사이트에서 가입하고 리워드를 적립하세요.
{% endif %}

if 문구 내에는 시작 {% if … %} 조건과 마침 {% endif %} 태그가 필요합니다. 다른 모든 요소(예: {% elif %} 및 {% else %} 태그)는 선택 사항입니다. {% elif %} 태그를 무제한으로 사용할 수 있으며, 그 뒤로는 {% else %} 태그를 최대 하나만 사용할 수 있습니다. 각 이메일 수신자는 자신이 받기에 적합한 첫 번째 메시지만 볼 수 있습니다.

문구

'For' 블록의 경우 목록을 저장하는 변수에 있는 각 항목을 반복하여 개별적으로 렌더링할 수 있습니다. 아래는 예시 문구입니다.

{% for item in event.shopping_cart_items %}{{ item.name }} × {{ item.quantity }} {% endfor %}

오버사이즈 비치 담요 × 1

비치 체어 × 4

SPF 자외선 차단제 × 2

플라스틱 쿨러 × 1

각 For 문구에는 다음이 포함되어야 합니다.

행의 별칭(위의 예시에서는item) 및 행 집합(위의 예시에서는 event.shopping_cart_items)을 포함하는 시작 태그 {% for … %}
마침 태그 {% endfor %}

두 개의 필수 태그 사이에 원하는 텍스트를 포함할 수 있습니다. 행 집합 내에 중첩된 변수를 포함하려면 변수 이름의 시작 부분(행 집합과 행 집합 뒤의 숫자)을 행 별칭으로 바꾸면 됩니다. 예를 들어 {{ event.shopping_cart_items.0.name }} 변수는 {{ item.name }}이 됩니다.

조건문 및 인라인 텍스트 편집기

텍스트 블록에 특정 조건문을 추가하면 인라인 텍스트 편집기에서 해당 조건문이 사라질 수 있습니다. 코드는 여전히 존재하지만 단지 숨겨져 있을 뿐입니다. 조건문을 보고 편집하려면 텍스트 블록의 소스 코드 필드를 엽니다.

다음 태그는 텍스트 블록의 소스 코드 필드에서만 볼 수 있습니다.

{% for ... %}
{% endfor %}
{% if ... %}
{% elif ... %}
{% else %}
{% endif %}
{% with ... %}
{% endwith %}

추가 자료

이 도움말 문서가 유용했나요?

이 형식은 도움말 문서 피드백 용도로만 사용하세요. 지원 팀에 문의하는 방법.

Klaviyo에서 자세히 살펴보기

커뮤니티

동료, 파트너, Klaviyo 전문가와 연결되어 영감을 받고 인사이트를 공유하며, 모든 궁금한 사항에 대해 답을 얻으세요.

커뮤니티 방문

라이브 교육

Klaviyo 전문가와 함께하는 라이브 세션에 참여하여 모범 사례, 주요 기능 설정 방법 등에 대해 알아보세요.

지금 등록하기

지원

계정을 통해 지원에 액세스하세요.

이메일 지원 (무료 체험 및 유료 계정) 연중무휴 24시간 사용 가능

채팅/가상 비서
사용 가능 여부는 위치 및 요금제 유형에 따라 다름

로그인