템플릿에서 사용자 정의 오브젝트를 사용하는 방법

학습 내용

템플릿에서 사용자 정의 개체를 사용하는 방법을 알아보고, 플로우 및 캠페인 전송에서 개체 데이터를 사용할 수 있도록 설정해 보세요.

템플릿에서 사용자 정의 개체 데이터를 사용하려면 먼저 개체를 만들어야 합니다. 개인화 메뉴, 개체 필터, 수신자 레코드 목록의 경우 프로필 관계가 있는 개체를 사용하세요. 해당 레코드는 메시지에 표시되려면 수신자에 연결되어야 합니다.

개인화 메뉴를 통해 객체 데이터에 액세스하기

사용자 지정 객체의 속성이나 객체의 레코드 수를 사용해 드래그 앤 드롭 템플릿 편집기에서 텍스트 블록을 개인화할 수 있어요.

Klaviyo의 템플릿 편집기 사용 방법을 알아보세요.

HTML 템플릿으로 시작하는 경우, 먼저 드래그 앤 드롭으로 복사본을 만들 수 있어요:

1. 콘텐츠 > 템플릿으로 이동한 다음 이메일: 저장됨을(를) 여세요. HTML 템플릿의 점 3개 메뉴를 열고 드래그 앤 드롭으로 복제를 선택하세요.
2. 변환된 템플릿을 열어 진행 상황을 확인해 보세요. 상태가 사용 준비 완료이면 변환된 템플릿의 이름을 클릭해 열어 보세요.
3. 사용하기 전에 카피의 레이아웃과 개인화된 콘텐츠를 검토해 주세요. 원본 HTML 템플릿은 변경되지 않습니다.

템플릿에 객체 데이터를 추가하려면 다음부터 시작해 보세요:

1. 새 텍스트 블록을 추가하거나 기존 텍스트 블록을 선택하세요.
2. 텍스트 블록을 더블 클릭한 다음, 동적 속성을 삽입할 위치에 커서를 놓아 주세요.
3. 텍스트 도구 모음에서 개인 설정 버튼을 선택해 주세요.

4. 개인화 모달에서 모든 유형 드롭다운에서 Objects 를 선택하세요.

5. Objects에서 계정의 모든 오브젝트를 확인할 수 있으며, 이를 사용해 데이터를 템플릿으로 가져올 수 있어요. 템플릿에서 사용하려는 데이터가 포함된 오브젝트를 선택하세요.
6. 표시할 속성을 선택하거나, 개수를 표시하려면 개체 수를 선택하세요. 다음으로, 개체 필터를 선택하세요. 여기에서 새 개체 필터를 만들 수도 있어요.
7. 기존 필터를 선택한 후 삽입을 클릭해 주세요. 새 필터를 생성하면, 생성이 완료될 때 해당 태그가 삽입돼요.
8. 필요한 텍스트 스타일을 모두 적용해 주세요. 속성 값의 경우, 태그를 편집해 |default:'value'을(를) 포함하면 기본 텍스트를 추가할 수 있어요. 속성이 비어 있을 때 표시할 텍스트로 value을(를) 바꿔 주세요.

오브젝트 데이터의 대문자 사용 규칙을 지정하려면 맞춤 설정 태그에서 규칙을 수동으로 설정해야 해요. 예를 들어, 다음 태그는 날짜 트리거 플로우를 트리거한 오브젝트를 사용해요:

• {{ 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 태그로 참조되는 Pet 라는 객체예요. 
• Name이라는 개체 속성

ID로 개체 검색

이 예시는 다음을 사용해요:

• Pet이라는 객체
• Name이라는 개체 속성
• pet_id라는 객체 속성이 있는 객체로 플로우를 트리거한 이벤트예요. 이 필드는 Pet 객체의 객체 ID와 동일해요.

개체 필터에서 단일 개체 반환

이 예시는 다음을 사용해요:

• oldestDog라는 추가 객체 필터
• Name이라는 개체 속성

개체 필터에서 정수를 반환

이 예시는 다음을 사용해요:

• countOfDogs라는 추가 객체 필터

개체 필터에서 여러 개체 반환

Multiple 로 설정된 dogs 라는 필터의 경우, 일치하는 레코드를 반복 처리해 각 반려동물의 Name 속성을 표시해 주세요:

{% for pet in object_filter.dogs %}
{{ pet.Name }}
{% endfor %}

개체 레코드 검색

customobjects을(를) 사용하면 수신자에 연결된 레코드를 최대 5개까지 가져올 수 있으며, 가장 최근에 추가된 항목부터 가장 오래된 항목 순으로 정렬돼요. 반환된 레코드를 반복 처리하면서 해당 속성을 표시하세요. 이 예시에서는 다음을 사용해요:

• 반려동물 프로필이라는 객체
• name라는 개체 속성

제목의 객체 데이터

메시지 본문에서 사용하는 것과 동일한 사용자 지정 객체 구문을 제목에 사용하세요. 이 예시는 각 데이터 소스에 대한 구문을 보여줘요:

• {{ object_filter.oldestDog.Name }} 단일 개체 필터 oldestDog의 Name 속성을 표시해요.
• {{ object.Name }} 날짜 트리거 플로우를 트리거한 객체에서 Name 속성을 표시해요.
• {% customobject event.pet_id object_type_title="Pet" as pet %}{{ pet.Name }}{% endcustomobject %} ID로 Pet 레코드를 조회해요. pet_id가 포함된 이벤트로 트리거되는 플로우에서 사용해요.

예를 들어, Pet 객체를 기반으로 날짜 트리거 플로우에서 {{ object.Name }}를 사용하면 제목에 고객의 반려동물 이름을 표시할 수 있어요.

초안 보기:

이메일 미리보기:

표시/숨기기 로직의 객체 데이터

또한 객체 데이터를 기반으로 템플릿에서 블록을 표시할지 숨길지도 설정할 수 있어요. 객체 필터의 속성 또는 개수를 사용하거나, 날짜 트리거 플로우를 트리거한 객체를 사용하세요. 단일 표시/숨김 조건에서 객체 데이터를 사용할 수도 있고, 각 표시/숨김 로직 같은 이메일의 다른 버전의 조건에서도 사용할 수 있어요. ID로 가져온 데이터의 경우, 아래에 설명된 고급 조건부 로직을 사용하세요.

예를 들어, Pet 객체를 기반으로 하는 날짜 트리거 플로우에서 object.Breed == 'Labrador'을(를) 사용해 트리거된 반려동물의 Breed가 Labrador일 때만 블록이 표시되도록 설정하세요. 데이터에 있는 정확한 품종 값을 사용하세요.

1. 블록을 선택하고 디스플레이 탭을 여세요. 표시/숨기기 로직에서 특정 대상에게만 표시를 선택하거나, 같은 이메일의 다른 버전 로직을 만들려면 여러 대상에게 개인화를 선택하세요. 그런 다음 코드 사용을 선택해 주세요.
2. object_filter.countOfDogs > 0 같은 조건을 {{ }} 또는 {% %}로 감싸지 않고 입력해 주세요. 객체 필터는 캠페인과 플로우에서 사용할 수 있어요. object은(는) 객체 데이터를 기반으로 하는 날짜 트리거 플로우에서만 사용해 주세요.
3. 조건을 적용하려면 저장을 클릭해 주세요.

사용자 지정 객체 섹션은 하나의 대상 그룹에 대해서만 표시/숨기기 로직을 지원해요. 이들에게는 로직 같은 이메일의 다른 버전을 사용할 수 없어요. 표시/숨기기 로직 같은 이메일의 다른 버전에 대해 자세히 알아보세요.

더 유연하게 설정하려면(예: {% customobject %} 또는 {% customobjects %}에서 반환된 정보를 기준으로 일부 정보를 조건부로 표시) 텍스트 블록에서 {% if ... %} 로직을 직접 사용해 고급 조건부 로직을 사용하는 것을 고려해 보세요.

개체 필터

개체 필터란 무엇인가요?

객체 필터는 설정한 기준을 사용해 각 수신자와 연결된 레코드를 선택해요. 일치하는 레코드 1개에서 속성을 표시하거나, 최대 10개의 일치하는 레코드에서 속성을 표시하거나, 일치하는 레코드 수를 표시할 수 있어요.

새 개체 필터 만들기

오브젝트 필터 생성을 시작하려면:

1. 템플릿에 새 텍스트 블록을 추가하거나 기존 텍스트 블록의 텍스트를 편집하세요.
2. 개인화 버튼을 선택해 주세요.

3. 개인화 모달에서 모든 유형 드롭다운에서 객체 를 선택해 주세요.
4. 필터를 설정할 데이터가 포함된 객체를 선택합니다.
5. 표시할 속성을 선택해 주세요. 대신 개수 필터를 만들려면, 객체 수를 선택해 주세요.
6. 아직 필터가 없다면 만들기를 클릭해 주세요. 필터가 나열되어 있다면 선택하지 않은 상태로 두고 객체 필터 만들기를 클릭해 주세요.

개체 필터 만들기 모달에서 다음 정보를 설정하세요:

• 이름
  oldestDog처럼 문자와 숫자만 포함된 고유한 이름을 입력해 주세요. 공백이나 특수 문자를 사용하지 마세요.
• 필터 조건 설정
  텍스트 블록에 포함되려면 객체가 충족해야 하는 규칙을 정의해 주세요.
• 몇 개의 개체를 표시해야 하나요?
  속성 값의 경우, 레코드가 1개면 단일을, 최대 10개 레코드까지는 복수를 선택해 주세요. 개수 필터에는 이 설정이 표시되지 않아요.
• 속성 선택 및 정렬 순서
  속성-값 필터의 경우, 레코드를 선택하거나 정렬하는 데 사용할 속성을 선택한 다음 정렬 순서를 선택해 주세요. 예를 들어, 생일 속성으로 정렬할 때 가장 오래된 항목을 선택하면 가장 나이가 많은 반려동물이 먼저 선택돼요. 카운트 필터에서는 이러한 필드가 표시되지 않아요.

필터를 저장하고 텍스트 블록에 해당 태그를 삽입하려면 오브젝트 필터 만들기를 클릭해 주세요.

오브젝트 필터가 생성되면, 설정한 기준에 따라 특정 오브젝트 레코드를 표시하도록 표시/숨기기 로직과 맞춤 설정 태그에서 이를 사용할 수 있어요.

추가 자료