템플릿에서 사용자 정의 오브젝트를 사용하는 방법
이 기능을 사용하려면 사용자 지정 객체에 대한 액세스 권한이 있어야 해요.
학습 내용
템플릿에서 사용자 정의 개체를 사용하는 방법을 알아보고, 플로우 및 캠페인 전송에서 개체 데이터를 사용할 수 있도록 설정해 보세요.
템플릿에서 사용자 정의 개체 데이터를 사용하려면 먼저 개체를 만들어야 해요.
개인화 메뉴를 통해 객체 데이터에 액세스하기
커스텀 오브젝트의 속성 또는 오브젝트의 레코드 수를 사용하여 템플릿 편집기에서 텍스트 블록을 개인화할 수 있습니다.
Klaviyo의 템플릿 편집기 사용 방법을 알아보세요.
템플릿에 객체 데이터를 추가하려면 다음부터 시작해 보세요:
- 새 텍스트 블록을 추가하거나 기존 텍스트 블록을 선택하세요.
- 텍스트 블록을 더블 클릭한 다음, 동적 속성을 삽입하려는 위치에 커서를 놓아 주세요.
- 오른쪽 상단의 개인화 버튼을 선택해 주세요.
- 개인화 모달에서 모든 유형 드롭다운에서 Objects 를 선택하세요.
- Objects에서 계정의 모든 오브젝트를 확인할 수 있으며, 이를 사용해 데이터를 템플릿으로 가져올 수 있어요. 템플릿에서 사용하려는 데이터가 포함된 오브젝트를 선택하세요.
- 템플릿에 포함할 특정 개체 속성 또는 개체 필터를 선택하세요. 여기에서 새 개체 필터를 만들 수도 있어요.
- 텍스트의 기본값과 텍스트에 대한 모든 스타일을 설정해 주세요.
객체 데이터의 대문자 사용 규칙을 지정하려면 맞춤 설정 태그에서 규칙을 수동으로 설정해야 해요. 예를 들어:
- {{ object.full_name|title|default:'value' }}
John Doe - {{ object.full_name|upper|default:'value' }}
JOHN DOE - {{ object.full_name|lower|default:'value' }}
john doe
Django 필터로 값을 수정하는 방법을 자세히 알아보세요.
맞춤 설정 태그로 객체 데이터에 액세스하기
이메일(이메일 제목 포함), SMS/MMS 메시지, 푸시 알림 및 Klaviyo 고객 허브에서 맞춤 설정 태그를 사용해 객체 데이터를 표시할 수 있어요.
Klaviyo에서 맞춤 설정 태그를 사용하는 방법을 알아보세요.
개체 맞춤 설정 태그 참조
객체와 함께 다음 맞춤 설정 태그를 사용할 수 있어요.
플로우를 트리거한 개체 사용
{{ object }}는 개체가 플로우를 트리거한 경우에만 사용할 수 있어요. {{ object }} 템플릿 태그는 객체를 기반으로 하는 날짜 트리거 플로우에서만 사용할 수 있어요. 이는 이벤트 트리거 플로우의 {{ event }} 템플릿 태그와 비슷해요.
이 예시는 다음을 사용해요:
- 템플릿에서 object 태그로 참조되는 Pet 라는 객체예요.
- Name이라는 개체 속성
구조 | 예시 |
{{ object.object_property }} | {{ object.Name }} |
{{ object | lookup:'object_property' }} | {{ object | lookup:'Name' }} |
ID로 개체 검색
이 예시는 다음을 사용해요:
- Pet이라는 객체
- Name이라는 개체 속성
- pet_id라는 객체 속성이 있는 객체로 플로우를 트리거한 이벤트예요. 이 필드는 Pet 객체의 객체 ID와 동일해요.
구조 | 예시 |
{% customobject event.object_id object_type_title="Title" as alias %} | {% customobject event.pet_id object_type_title="Pet" as pet %} |
{% customobject event.object_id입니다. object_type_title="Title"을 별칭 %}로 설정합니다. | {% customobject event.pet_id object_type_title="반려동물" as pet %} |
개체 필터에서 단일 개체 반환
이 예시는 다음을 사용해요:
- oldest_dog라는 추가 객체 필터
- Name이라는 개체 속성
구조 | 예시 |
{{ object_filter.object_filter_name.object_property}} | {{ object_filter.oldest_dog.Name }} |
{{ object_filter.object_filter_name | lookup: 'object_property' }} | {{ object_filter.oldest_dog | lookup: 'Name' }} |
개체 필터에서 정수를 반환
이 예시는 다음을 사용해요:
- count_of_dogs라는 추가 객체 필터
구조 | 예시 |
{{ object_filter.object_filter_name }} | {{ object_filter.count_of_dogs }} |
개체 레코드 검색
오브젝트의 최신 오브젝트 레코드를 가져오려면 모든 오브젝트 레코드를 반복해야 해요. 이 예시는 다음을 사용해요:
- Pets라는 객체
구조 | 예시 |
{% customobjects object_type_title="Title" as alias %} | {% customobjects object_type_title="Pet 프로필" as pets %} |
제목의 객체 데이터
커스텀 오브젝트 태그를 사용해 제목을 개인화할 수 있어요:
- {% object_filter %}
- {% object %}
- {% customobject %}
예를 들어, 메시지 제목에서 {% object %} 태그를 사용해 고객의 반려동물 이름을 직접 표시할 수 있어요.
초안 보기:
이메일 미리보기:
표시/숨기기 로직의 객체 데이터
또한 객체 데이터를 기반으로 템플릿에서 블록을 표시할지 숨길지 구성할 수 있어요. 객체 데이터를 기반으로 블록을 동적으로 표시하거나 숨기려면 템플릿 빌더와 동일한 태그를 사용해요. ID로 객체를 참조하거나, 객체 필터의 속성 또는 객체 필터의 집계를 참조할 수 있어요.
표시/숨기기 로직에서 참조하기 전에 개체 필터를 만들어야 해요.
예를 들어 Breed 라는 속성이 있는 Pet 객체가 있다면, object.Breed 조건을 사용해 특정 견종의 반려견을 키우는 사람에게만 블록을 표시하도록 선택할 수 있어요.
표시/숨기기 로직을 설정하려면 규칙을 설정할 블록을 클릭한 다음 표시 탭에서 코드 사용 을 선택해 주세요.
코드 편집기에서 조건을 직접 입력해 주세요. 객체 데이터를 기반으로 날짜 트리거 플로우의 메시지를 보내는 경우, 객체 필터와 객체 템플릿 태그를 사용할 수 있어요.
더 유연하게 설정하려면(예: {% customobject %} 또는 {% customobjects %}에서 반환된 정보를 기준으로 일부 정보를 조건부로 표시) 텍스트 블록에서 {% if ... %} 로직을 직접 사용해 고급 조건부 로직을 사용하는 것을 고려해 보세요.
개체 필터
개체 필터란 무엇인가요?
객체 필터를 사용하면 설정한 특정 기준에 따라 반환되는 객체 레코드를 제한하여 특정 유형의 레코드를 표시할 수 있어요.
새 개체 필터 만들기
오브젝트 필터 생성을 시작하려면:
- 템플릿에 새 텍스트 블록을 추가하거나 기존 텍스트 블록의 텍스트를 편집하세요.
- 개인화 버튼을 선택해 주세요.
- 개인화 모델에서 모든 유형 드롭다운에서 Objects 를 선택하세요.
- 필터를 설정할 데이터가 포함된 객체를 선택합니다.
- 필터를 설정할 개체 속성을 선택하세요.
- 새 필터 생성을 선택하세요.
개체 필터 만들기 모달에서 다음 정보를 설정하세요:
- 이름
개체 필터의 이름을 만드세요. - 필터 조건
텍스트 블록에 포함되기 위해 객체가 충족해야 하는 규칙을 정의하세요. - 여러 레코드가 조건을 충족할 때의 동작
여러 레코드가 조건을 충족하는 경우의 동작을 정의하세요.
오브젝트 필터가 생성되면, 설정한 기준에 따라 특정 오브젝트 레코드를 표시하도록 표시/숨기기 로직과 맞춤 설정 태그에서 이를 사용할 수 있어요.