콘텐츠 반복 기능 사용 방법
학습 내용
Klaviyo 이메일 템플릿에서 섹션 또는 블록에 블록 반복 기능을 사용하는 방법을 알아보세요. 이 기능을 사용하면 수신자의 이벤트 또는 프로필 데이터, 또는 데이터 피드의 데이터 배열(즉, 목록)에 있는 각 항목에 대해 블록 또는 섹션의 콘텐츠를 반복할 수 있어요.
시작하기 전에 알아야 할 것
이메일에서 이벤트, 프로필 또는 카탈로그 데이터를 사용하는 방법이 익숙하지 않다면, 첫 단계로 메시지 개인화 참고 자료를 확인해 보세요.
또한 Klaviyo의 데이터 유형, 특히 목록(즉, 배열)을 이해하는 데도 도움이 돼요. 배열은 동일한 방식으로 구조화된 여러 데이터를 저장해요. 예를 들어 고객이 구매한 항목은 주문 완료(Placed Order) 이벤트 내 배열로 저장돼요. items 배열에는 주문한 각 항목당 1개의 항목이 포함되며, 각 항목에는 1개 항목에 대한 세부 정보(예: 항목 이름, 이미지 URL, 수량, 사이즈, 색상 등)가 들어 있어요.
콘텐츠 반복 기능 사용 사례
콘텐츠 반복 기능을 사용하려면 데이터 배열 또는 목록이 필요해요. 아래 표에는 Klaviyo 계정에 존재할 수 있는 데이터 배열의 몇 가지 예와 함께, 샘플 사용 사례가 나와 있어요.
데이터 출처 | 샘플 사용 사례 |
Placed Order 이벤트에서 순서대로 정렬된 항목 배열 | 고객의 주문 확인 이메일에 구매한 항목(제품 이미지, 가격, 제목 및 같은 이메일의 다른 버전 정보 포함)을 표시하세요. |
정기 주문을 구독하는 사람의 기존 구독 목록 | 캠페인에서 고객에게 활성 구독 목록을 표시하세요. |
맞춤 웹 피드의 최근 블로그 게시물 목록 | 환영 이메일 플로우에서 최근 블로그 게시물의 최신 목록을 제공해 주세요. 블로그 게시물 링크와 콘텐츠 미리보기도 포함해 주세요. |
콘텐츠 반복 기능은 구독자 프로필이나 이벤트 데이터에 저장된 배열이든, 웹 피드 중 하나에 있는 배열이든 어떤 배열과도 함께 사용할 수 있어요. 위 예시는 이 기능을 사용할 수 있는 방법의 아주 일부에 불과해요.
콘텐츠 반복 기능 사용 방법
콘텐츠 반복 기능을 사용하려면 반복하려는 섹션이나 블록으로 이동한 다음 표시 옵션을 클릭하세요. 콘텐츠 반복 섹션에서 콘텐츠 반복 만들기를 클릭하세요.
두 개의 필드가 표시돼요: Repeat for 및 Item alias. 이 필드를 채우고 반복 콘텐츠를 설정하려면 아래 단계를 따르세요:
“반복 대상”을 식별하세요.
반복 대상 필드에 반복하려는 배열의 이름을 추가하세요.
배열의 이름을 찾으려면 데이터 소스(예: 프로필 데이터, 이벤트 데이터 또는 데이터 피드)의 데이터를 확인하세요. 이 예시에서는 이벤트 데이터에서 배열을 찾는 과정을 살펴볼게요:
- 이메일 템플릿에서 미리보기 및 테스트를 클릭하세요.
- 이벤트를 클릭하세요.
- 이 플로우 이메일을 트리거할 이벤트를 선택하세요(예: Started Checkout).
- 필요한 정보가 포함된 배열을 찾을 때까지 이벤트의 미리 보기 데이터를 스크롤해 보세요. 데이터 왼쪽의 화살표 아이콘을 사용하면 필요하지 않은 섹션을 접어 더 쉽게 탐색할 수 있어요.
- 이 예시에서는 항목 정보를 저장하는 배열이 2개 있어요:
- 이 경우 반복 블록에 표시하는 데 필요한 상세 정보가 포함되어 있으므로 더 자세한 배열인 line_items를 사용하는 것이 좋아요. Repeat for 필드에 설정할 적절한 변수를 찾으려면 배열의 첫 번째 섹션 내에서 변수 2개를 찾아 복사하세요. 이 예시에서는 variant_price 및 title의 변수를 복사할게요. 복사한 두 태그는 다음과 같아요:
{{ event.extra.line_items.0.variant_price }}{{ event.extra.line_items.0.title }}
- 항목
최상위 배열이며 각 항목 이름의 간단한 목록을 포함하지만, 다른 정보는 포함하지 않습니다. - Line_items
extra 배열 내에 중첩되어 있으며, 각 항목의 제목, 가격, SKU, 이미지 URL 등 더 많은 세부 정보를 포함합니다.
- 중괄호는 무시하고 그 안의 변수를 확인하세요. 두 변수의 시작 부분이 동일하다는 점에 유의하세요:
event.extra.line_items.0. - 이 변수의 이 부분 끝에 있는 점과 숫자를 제외하고, 그 앞까지를 반복 대상으로 사용해 주세요. 이 예시에서 반복 대상 필드의 적절한 설정은
event.extra.line_items입니다.
항목 별칭을 선택하세요.
항목 별칭은 원하는 어떤 텍스트든 사용할 수 있어요(특수 문자나 공백은 제외). 이 별칭을 반복 블록 내에서 사용하여, 위에서 선택한 배열에서 가져와야 하는 변수를 식별해요. 기억하기 쉽도록 간단하면서도 설명적인 별칭을 선택하세요.
예를 들어, 장바구니 이탈에서 항목 목록을 기준으로 블록이 반복되는 경우 item이 사용하기 좋은 별칭이에요. 블록이 블로그 게시물 목록을 기준으로 반복되는 경우에는 별칭으로 post를 사용할 수 있어요.
원하는 별칭을 어떤 것이든 사용할 수 있지만, 배열의 변수에서 해당 별칭을 일관되게 사용해야 해요(다음 단계에 설명된 대로).
Repeat for 및 Item alias 필드를 모두 입력한 후 변경 사항 저장을 클릭하고 콘텐츠 빌드를 시작하세요.
반복 블록/섹션을 구축하세요.
Repeat for 및 Item alias 설정을 완료한 후, 반복할 콘텐츠 블록에 맞춤 설정 태그를 추가하세요. 프로필 및 이벤트 데이터를 포함해 어떤 유형의 변수든 이 블록에 추가할 수 있지만, 배열에서 가져오는 모든 태그(예: 누군가 주문한 항목 목록)는 약간 조정해야 해요.
위 예시에서 사용된 전체 제목과 같은 이메일의 다른 버전 가격 변수는 다음과 같아요:
{{ event.extra.line_items.0.variant_price }}
{{ event.extra.line_items.0.title }}
위 변수를 블록에 추가하면 배열의 각 항목마다 블록이 한 번씩 반복되지만, 반복될 때마다 배열의 첫 번째 항목의 제목과 가격이 표시돼요.
각 항목의 제목과 가격을 표시하려면 Repeat for 설정(event.extra.line_items)의 텍스트와 그 뒤의 점 및 숫자(.0)를 Item alias (item)로 바꾸세요. 이 예시에서 생성되는 변수는 다음과 같습니다:
{{ item.variant_price }}
{{ item.title }}
배열에서 포함하려는 다른 변수도 같은 방식으로 반복하세요.
블록 반복 기능이 활성화된 블록 또는 섹션의 모든 항목은 배열의 각 항목당 1회씩 반복돼요. 한 번만 표시되길 원하는 콘텐츠가 있다면, 다른 블록 또는 섹션에 추가하세요.
또한, 이 과정을 통해 생성된 사용자 지정 변수(예: {{ item.title }})는 블록 반복 섹션이 활성화된 블록 또는 섹션 내에서만 작동해요. 이 사용자 지정 변수를 다른 위치에 추가하면 렌더링되지 않아요.
이메일을 미리 보고 문제를 해결하세요.
반복 블록을 만든 후 이메일을 미리 보세요. 이메일에서 이벤트 데이터를 참조하는 경우, 블록을 만드는 데 사용한 것과 동일한 이벤트(즉, 이 플로우를 트리거할 이벤트)를 선택하세요. 블록에서 프로필 데이터를 참조하는 경우, 올바른 변수가 있는 프로필을 선택하세요.
미리보기 이메일에서 반복 블록이 비어 있거나 예상한 모든 콘텐츠가 포함되어 있지 않다면, 위 단계로 돌아가세요. 위 단계에 따라 Repeat for, Item alias 및 모든 사용자 지정 변수가 올바르게 구성되어 있는지 확인해 주세요. 그런 다음 사용 중인 미리보기 데이터를 검토하세요. 올바른 이벤트를 선택했는지, 선택한 샘플 이벤트에 필요한 데이터가 포함되어 있는지 확인하세요.