메시지 개인화 참고자료

Klaviyo의 개인화 변수 또는 또는 태그를 사용하여 고객 맞춤형 경험을 제공하는 방법을 알아보세요.

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

맞춤 설정 태그 관련 정보

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

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

프로필 맞춤 설정

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

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

사용자 정의 개체 태그

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

태그를 사용하여 개체 ID를 가져오거나 개수를 반환하는 방법에 대한 구체적인 예시는 태그 참조를 검토해 보세요.

조직 태그

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

태그 링크 및 미리보기

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

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

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

구독 취소

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

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

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

기본 설정 관리

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

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

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

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

웹 보기

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

텍스트 미리보기

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

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

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

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

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

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

필터로 태그 맞춤 설정하기

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

default 필터는 메시지 수신자에게 해당 속성이 설정되어 있지 않은 경우 표시할 기본값을 설정합니다. 아래 예시에서는 수신자의 이름이나 좋아하는 음식이 Klaviyo 프로필에 설정되어 있지 않은 경우를 대비해 'friend'와 'tasty treats'가 기본값으로 설정되어 있어요.

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

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

날짜 태그

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

{{ 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 %}
Hey VIP! You’ve always got free shipping & free returns
{% elif person|lookup:'Loyalty Points' > 0 %}
You have {{ person|lookup:'Loyalty Points' }} points, and you just need 150 to become a VIP! 
{% else %}
Have you heard about our VIP program? Join today on our website to start earning rewards.
{% endif %}

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

문구

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

각 For 문구에는 다음이 포함되어야 해요:

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

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

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

텍스트 블록에 특정 조건문을 추가하면 인라인 텍스트 편집기에서 해당 조건문이 사라질 수 있습니다. 코드는 여전히 존재하지만 단지 숨겨져 있을 뿐입니다. 조건문을 보고 편집하려면 Django 태그 빌더를 사용하거나, 코드를 직접 편집할 수 있도록 콘텐츠를 전용 HTML 블록으로 옮겨 주세요.

다음 태그는 인라인 텍스트 편집기에는 표시되지 않지만 텍스트 블록에는 남아 있어요:

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